Integrations/REST API
REST API

One API. Six platforms. Any language.

The Aidelly REST API gives your AI agents, scripts, and backends full control over social media. Post, schedule, manage your inbox, and pull analytics all via standard HTTP.

Generate API keyInteractive API docs
Bearer token authJSON request/responsePer-platform resultsWebhooks coming soon

Quick start

Get a post live in under a minute.

1

Get your API key

Settings → API Keys in your Aidelly dashboard. API access requires an active paid plan see plans.

2

Make your first API call

Create a post with a single curl command:

curl -X POST https://api.aidelly.ai/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Just shipped something new!",
  "platforms": ["instagram", "linkedin", "x"],
  "schedule_at": "2026-04-01T09:00:00Z"
  }'

✓ 201 Created

{ "id": "post_x7k2", "status": "scheduled" }

API endpoints

Base URL: https://api.aidelly.ai

POST/v1/postsCreate or schedule a post to one or more platforms
GET/v1/postsList scheduled, published, and draft posts
GET/v1/posts/:idGet a single post with per-platform status
DELETE/v1/posts/:idCancel a scheduled post before it publishes
GET/v1/analyticsFetch views, likes, comments, and shares per platform
POST/v1/mediaUpload images or videos for use in posts
GET/v1/inboxRead comments and DMs from your unified inbox
POST/v1/inbox/:id/replyReply to a comment or DM programmatically
Full interactive API reference

Rate limits by plan

All limits are per API key, per minute.

PlanRead (GET)Write (POST/DELETE)
Launch60 req/min20 req/min
Growth120 req/min40 req/min
Scale240 req/min90 req/min

Need higher limits? Contact us for enterprise rates.

Authentication

All API requests require a Bearer token. Pass your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Keep your API key secret. Rotate it anytime from Settings → API Keys.

Common questions

What authentication does the API use?

Bearer token authentication. Generate an API key from your Aidelly dashboard under Settings → API Keys, then pass it as Authorization: Bearer YOUR_API_KEY in every request header.

Which platforms can I post to?

Instagram, TikTok, YouTube, X (Twitter), LinkedIn, and Facebook. Pass them as strings in the `platforms` array: ["instagram", "tiktok", "youtube", "x", "linkedin", "facebook"].

How do I schedule a post for a future time?

Include a `schedule_at` field in your request body with an ISO 8601 UTC timestamp, e.g. "2026-04-01T09:00:00Z". Aidelly holds the post and publishes it at that time.

What plan do I need for API access?

API keys are available on all paid plans (Launch, Growth, Scale). Rate limits vary by plan see the table on this page.

Integration guides

Claude (MCP) →Make →Zapier →n8n →