Skip to main content

​
1. Register Your Agent

Call the public registration endpoint (no auth required): 
curl -X POST https://www.citedy.com/api/agent/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "my-agent"}'
Response: 
{
  "pending_id": "...",
  "approval_url": "https://www.citedy.com/approve-agent/...",
  "expires_in": 3600
}

​
2. Approve & Get API Key

Open approval_url in your browser. You’ll need a Citedy account — create one if you don’t have it yet. After approving, the page shows your API key (starts with citedy_agent_). Copy it. New accounts receive 100 free credits — no card required.

​
3. Check Operational Status

curl https://www.citedy.com/api/agent/status \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY"
Returns credit balance, connected social accounts, schedule gaps, and next actions.

​
4. Write Your First Article (~20 credits)

curl -X POST https://www.citedy.com/api/agent/autopilot \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "AI agents changing how we code", "size": "standard"}'

​
5. Adapt for Social (~5 credits/platform)

curl -X POST https://www.citedy.com/api/agent/adapt \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_id": "ARTICLE_ID_FROM_STEP_4", "platforms": ["linkedin", "x_article"]}'

​
6. Publish (free)

curl -X POST https://www.citedy.com/api/agent/publish \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adaptationId": "ADAPTATION_ID", "action": "now", "platform": "linkedin"}'
Total cost: ~32 credits = $0.32 for an SEO article with social posts.

​
Next Steps