Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt

Use this file to discover all available pages before exploring further.

Available Managed connector - SocialAPI handles the Meta Threads App and platform app review for you. No customer-side Meta for Developers registration required. See Platform credentials. Threads is fully supported for posts, comments, moderation, and publishing.

​
At a glance

FieldValue
Platform slugthreads
Auth typeOAuth 2.0 (Meta)
APIThreads Graph API
Best forText-first posting and replying on Threads.

​
Capabilities

FeatureSupportedNotes
List postsYesText posts, images, videos, carousels
CommentsYesReplies to a specific post
Reply to commentYes
Comment replies (thread)Coming soonNot yet implemented
Moderate comment (hide/unhide/delete)YesHide, unhide, and delete supported. Unknown actions return 501.
Toggle post commentsNoNot supported by Threads API
DMsNoNot supported by platform
ReviewsNoNot applicable
MentionsNoNot supported via Threads API
Create postYesText, images, videos, carousels
Delete postYes
Update postNoNot supported by Threads API

​
Connecting

curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "threads",
    "metadata": {
      "redirect_uri": "https://app.example.com/oauth/callback"
    }
  }'
Response: 
{
  "auth_url": "https://threads.net/oauth/authorize?client_id=...&state=...",
  "state": "4a8f2c1e9b3d7f06a5c2e8b4d1f3a7e2"
}
Redirect your user to auth_url. After they authorize, Threads redirects to your redirect_uri with ?code=...&state=.... Then call: 
curl -X POST https://api.social-api.ai/v1/oauth/exchange \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "threads",
    "code": "AQDtbPB9X...",
    "metadata": {
      "state": "4a8f2c1e9b3d7f06a5c2e8b4d1f3a7e2",
      "redirect_uri": "https://app.example.com/oauth/callback"
    }
  }'

​
Reading samples

​
List posts

curl "https://api.social-api.ai/v1/accounts/{id}/posts?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"
Sample response: 
{
  "data": [
    {
      "id": "17895695668004550",
      "platform": "threads",
      "caption": "Hello from Threads!",
      "media_type": "TEXT_POST",
      "permalink": "https://www.threads.net/@acmecorp/post/ABC123",
      "timestamp": "2026-03-01T12:00:00Z",
      "like_count": 18,
      "comments_count": 3,
      "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J"
    }
  ],
  "count": 1
}

​
List comments on a post

curl "https://api.social-api.ai/v1/accounts/{id}/posts/17895695668004550/comments?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

​
Publishing

Create a Threads post with optional platform-specific fields: 
curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_ids": ["acc_01HZ9X3Q4R5M6N7P8V2K0W1J"],
    "text": "Hello from Threads!",
    "platform_data": {
      "threads": {
        "reply_control": "accounts_you_follow"
      }
    }
  }'
For the full field reference, media constraints, and error recovery, see Threads posts.

​
Limitations and gotchas

  • Moderation. Hide, unhide, and delete are supported. Unsupported moderation actions return 501.
  • No post updates. Threads does not support editing published posts. Use delete and re-create if needed.
  • Publishing. Supports text posts, single images, single videos, and carousel posts.
  • Token refresh. Threads tokens can expire. SocialAPI handles refresh automatically. If you receive 401 with code: "invalid_token", reconnect the account.

​
Permissions

SocialAPI’s managed Meta Threads App already requests these scopes on your behalf: threads_basic, threads_content_publish, threads_read_replies, threads_manage_replies, threads_delete. You don’t need to apply for any platform app review. See Platform credentials.