API Reference

Overview

The SocialPulses API provides programmatic access to manage your social media accounts, schedule posts, retrieve analytics, and configure webhooks. The API is RESTful, uses JSON for request and response bodies, and authenticates via Bearer tokens.

Base URL: https://api.socialpulses.io/v1

All requests must be made over HTTPS. HTTP requests to non-TLS endpoints will be rejected.

Authentication

Authenticate by including a Bearer token in the Authorization header. Generate tokens from the Settings → API Keys page in the app.

# Replace YOUR_API_KEY with your actual token
curl https://api.socialpulses.io/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

// Using fetch
const response = await fetch("https://api.socialpulses.io/v1/me", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

# Using requests
import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get("https://api.socialpulses.io/v1/me", headers=headers)
data = response.json()

Endpoints

GET /v1/me Get authenticated user profile

GET /v1/accounts List connected social accounts

POST /v1/posts Create and schedule a new post

GET /v1/posts/{id} Get post details and status

PUT /v1/posts/{id} Update a scheduled post

DELETE /v1/posts/{id} Cancel a scheduled post

GET /v1/analytics Get engagement and performance metrics

POST /v1/ai/generate Generate content with AI

GET /v1/webhooks List configured webhooks

POST /v1/webhooks Create a new webhook endpoint

Code Examples

Schedule a Post

curl -X POST https://api.socialpulses.io/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "account_id": "acc_abc123",
  "content": "Check out our latest blog post!",
  "media_urls": ["https://example.com/image.png"],
  "scheduled_at": "2026-06-01T09:00:00Z",
  "platforms": ["twitter", "linkedin"]
}'

const response = await fetch("https://api.socialpulses.io/v1/posts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    account_id: "acc_abc123",
    content: "Check out our latest blog post!",
    media_urls: ["https://example.com/image.png"],
    scheduled_at: "2026-06-01T09:00:00Z",
    platforms: ["twitter", "linkedin"]
  })
});
const post = await response.json();

import requests
import json

url = "https://api.socialpulses.io/v1/posts"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "account_id": "acc_abc123",
    "content": "Check out our latest blog post!",
    "media_urls": ["https://example.com/image.png"],
    "scheduled_at": "2026-06-01T09:00:00Z",
    "platforms": ["twitter", "linkedin"]
}
response = requests.post(url, headers=headers, json=payload)
post = response.json()

Rate Limits

Rate limits are applied per API key. Exceeding the limit returns a 429 Too Many Requests response with a Retry-After header.

100

Requests per minute

5,000

Requests per hour

50,000

Requests per day

Business plan customers get 2x rate limits. Contact sales for custom rate limits on Enterprise plans.

Overview

Authentication

Endpoints

Code Examples

Schedule a Post

Rate Limits

SDKs & Libraries

Node.js / TypeScript

Python

Go

Ruby

Get API Access