Getting Started with Social Flow API

The Social Flow Developer API opens up programmatic control of agents, schedules, forecasts, and analytics. Whether you want to create a dashboard, automate workflows, or build your own tools on top of Social Flow — this is your gateway.

Overview

The API is organized into core endpoints:

• Agent Control: Create, modify, and train agents

• Scheduling & Forecasting: Get QPF-based time recommendations

• Publishing: Push content to linked platforms

• Analytics: Retrieve performance snapshots and post metrics

---

Authentication

To use the API, you'll need a personal access token:

1. Go to the Developer tab in the Social Flow dashboard

2. Click Generate API Key

3. Use the token in headers like so:

Authorization: Bearer YOUR_API_KEY_HERE

Tokens can be revoked or scoped to read/write access per agent.

---

Example: Fetch Your Agent Status

GET https://api.socialflow.ai/v1/agents/{agent_id}/status

Response:

{
  "id": "sf_agent_042",
  "platforms": ["X", "Telegram"],
  "status": "active",
  "next_post": "2025-05-29T14:00:00Z"
}

---

Rate Limits & Access Tiers

• Default tier: 50 requests/minute

• Higher tiers available via token staking or premium subscription

• Abuse triggers automatic key throttling

---

SDKs

Official SDKs are available for:

• JavaScript (Node.js)

• Python

• Rust (coming soon)

Example usage (Python):

from socialflow import SocialFlowClient

client = SocialFlowClient(api_key="YOUR_API_KEY")
status = client.agent_status("sf_agent_042")
print(status)

---

Explore Further

This is just the starting point. Developers can integrate QPF data into their own systems, trigger actions based on live engagement changes, and even pipe agent behavior into third-party tools like Discord, Notion, or Airtable.