# SocialAPI.AI

## Docs

- [Connect a social account](https://docs.social-api.ai/api-reference/accounts/connect-a-social-account.md): Initiates account connection. For OAuth2 platforms returns an auth_url to redirect the user to. For apikey/credentials platforms stores the credentials immediately and returns account_id.
- [Disconnect a social account](https://docs.social-api.ai/api-reference/accounts/disconnect-a-social-account.md): Soft-deletes a connected account. It will no longer appear in the accounts list and all API calls using this account will return 404.
- [Exchange OAuth code](https://docs.social-api.ai/api-reference/accounts/exchange-oauth-code.md): Exchanges an OAuth authorization code for a connected social account. Use this when you handle the OAuth callback on your own server (proxy flow). For a single account the response is a flat ConnectAccountResponse (HTTP 201). When a single OAuth flow connects multiple accounts (e.g. Facebook Pages)…
- [Get a pending Google Profile selection](https://docs.social-api.ai/api-reference/accounts/get-a-pending-google-profile-selection.md): Returns the candidate Google Business Profiles for a pending connection created when a Google login manages more than one Profile. Choose one with the select endpoint.
- [Get creator info for publishing](https://docs.social-api.ai/api-reference/accounts/get-creator-info-for-publishing.md): Returns platform-specific creator settings needed before publishing (privacy levels, interaction toggles, posting availability). Currently supported for TikTok only; other platforms return 501.
- [List account pages](https://docs.social-api.ai/api-reference/accounts/list-account-pages.md): Returns pages (e.g. Facebook Pages) associated with a connected account.
- [List connected accounts](https://docs.social-api.ai/api-reference/accounts/list-connected-accounts.md): Returns all active social media accounts connected to the authenticated API key's workspace.
- [List Pinterest boards](https://docs.social-api.ai/api-reference/accounts/list-pinterest-boards.md): Returns the boards for a connected Pinterest account, for choosing a publish destination.
- [Select a Google Business Profile to connect](https://docs.social-api.ai/api-reference/accounts/select-a-google-business-profile-to-connect.md): Promotes exactly one candidate Profile from a pending connection into a connected account. First selection wins; the pending connection is then consumed.
- [Update account page](https://docs.social-api.ai/api-reference/accounts/update-account-page.md): Update a page's is_default or is_active status.
- [Create API key](https://docs.social-api.ai/api-reference/api-keys/create-api-key.md): Generates a new API key for the authenticated user.
- [List API keys](https://docs.social-api.ai/api-reference/api-keys/list-api-keys.md): Returns all API keys for the authenticated user.
- [Revoke API key](https://docs.social-api.ai/api-reference/api-keys/revoke-api-key.md): Deactivates an API key. This is irreversible.
- [Create a brand](https://docs.social-api.ai/api-reference/brands/create-a-brand.md): Creates a new brand for grouping connected social accounts. Each brand can have one account per platform.
- [Delete a brand](https://docs.social-api.ai/api-reference/brands/delete-a-brand.md): Deletes a brand and deactivates all its connected accounts (sets is_active=false).
- [List brands](https://docs.social-api.ai/api-reference/brands/list-brands.md): Returns all brands for the authenticated user with their connected account counts.
- [Update a brand](https://docs.social-api.ai/api-reference/brands/update-a-brand.md): Renames a brand.
- [Event summary counts](https://docs.social-api.ai/api-reference/events/event-summary-counts.md): Returns aggregated event counts for the requested window: totals, failure counts, breakdowns by category and error category, plus inbox-specific breakdown. Useful for dashboard summary cards.
- [List developer events](https://docs.social-api.ai/api-reference/events/list-developer-events.md): Returns a paginated, filtered slice of the unified event log. Events cover post lifecycle, inbox activity, account changes, and webhook deliveries. Retention varies by plan tier; the response includes the user's current retention window.
- [Create analytics export](https://docs.social-api.ai/api-reference/exports/create-analytics-export.md): Enqueue an async analytics export job for a connected account. Subject to plan limits (exports per month, cooldown hours, concurrent export cap).
- [Get export status and result](https://docs.social-api.ai/api-reference/exports/get-export-status-and-result.md): Returns the current status, progress, result download URL (presigned Excel), and report URL for an export job.
- [Get export videos](https://docs.social-api.ai/api-reference/exports/get-export-videos.md): Returns the cached video data for a completed export, including metrics and optional AI-enriched fields (transcript, vision summary).
- [List analytics exports](https://docs.social-api.ai/api-reference/exports/list-analytics-exports.md): Returns the 50 most recent export jobs for the authenticated user. Optionally filter by status.
- [Send feedback](https://docs.social-api.ai/api-reference/feedback/send-feedback.md): Submit feedback (bug report, feature request, or general comment). Stored for the team and forwarded to their notification channel.
- [Delete a comment](https://docs.social-api.ai/api-reference/inbox-comments/delete-a-comment.md): Deletes a comment on the platform and removes it from the inbox. Not all platforms support comment deletion - check the can_delete capability flag.
- [Hide a comment](https://docs.social-api.ai/api-reference/inbox-comments/hide-a-comment.md): Hides a comment on the platform so it is not visible to the public, and marks it hidden in the inbox. Supported on Instagram, Facebook, Threads, and YouTube. Check the can_hide capability flag.
- [Like a comment](https://docs.social-api.ai/api-reference/inbox-comments/like-a-comment.md): Likes a comment on the platform as the connected account. Supported on Instagram, Facebook, Twitter/X, and Reddit. Check the can_like capability flag.
- [List commented posts](https://docs.social-api.ai/api-reference/inbox-comments/list-commented-posts.md): Returns inbox posts that have comments, ordered by most-recently-commented. Supports filtering by account, platform, minimum comment count, and date range. Uses cursor-based pagination. YouTube has no webhooks, so YouTube commented posts are served live from the platform and only appear when the req…
- [List comments on a post](https://docs.social-api.ai/api-reference/inbox-comments/list-comments-on-a-post.md): Returns comments for a specific inbox post, including per-platform capability flags (can_reply, can_delete, can_hide, can_like, can_private_reply). Comments are fetched live from the platform on every request. Uses cursor-based pagination.
- [List replies to a comment](https://docs.social-api.ai/api-reference/inbox-comments/list-replies-to-a-comment.md): Returns paginated replies to a specific comment. Same response shape as top-level comments. Uses cursor-based pagination.
- [Reply to a comment](https://docs.social-api.ai/api-reference/inbox-comments/reply-to-a-comment.md): Posts a reply on the platform. If comment_id is provided, replies to that specific comment (threaded reply); otherwise replies to the post itself (top-level comment). Consumes 1 interaction credit.
- [Send a private reply to a commenter](https://docs.social-api.ai/api-reference/inbox-comments/send-a-private-reply-to-a-commenter.md): Sends a direct message to the author of a comment. This is a one-time DM triggered by a specific comment - only supported on Instagram and Facebook. Check the can_private_reply capability flag.
- [Unhide a comment](https://docs.social-api.ai/api-reference/inbox-comments/unhide-a-comment.md): Restores a previously hidden comment so it is publicly visible again. Supported on Instagram, Facebook, Threads, and YouTube.
- [Unlike a comment](https://docs.social-api.ai/api-reference/inbox-comments/unlike-a-comment.md): Removes a like from a comment on the platform. Supported on Instagram, Facebook, Twitter/X, and Reddit.
- [List Accounts with reviews](https://docs.social-api.ai/api-reference/inbox-reviews/list-accounts-with-reviews.md): Lists your review-capable connected Accounts, each with its live review summary (average rating, total count, last review time). Use this to build the reviews inbox navigation, then GET /inbox/reviews/{account_id} for one Account's reviews.
- [List reviews for an Account](https://docs.social-api.ai/api-reference/inbox-reviews/list-reviews-for-an-account.md): Returns one page of reviews for a single connected Account, newest first by default. Reviews are proxied live from the platform and not stored. Currently only Google Business Profile returns reviews.
- [Reply to a review](https://docs.social-api.ai/api-reference/inbox-reviews/reply-to-a-review.md): Posts a public reply to a review on the platform (e.g. Google Business Profile). The reply is visible to anyone who views the review. Consumes 1 interaction credit.
- [Get a conversation](https://docs.social-api.ai/api-reference/inbox/get-a-conversation.md): Returns a single inbox conversation by ID.
- [List inbox conversations](https://docs.social-api.ai/api-reference/inbox/list-inbox-conversations.md): Returns paginated DM conversations for the authenticated user, optionally filtered by account, platform, and status.
- [List messages in a conversation](https://docs.social-api.ai/api-reference/inbox/list-messages-in-a-conversation.md): Returns paginated messages for an inbox conversation, newest first.
- [Mark conversation as read](https://docs.social-api.ai/api-reference/inbox/mark-conversation-as-read.md): Resets the unread count on a conversation to zero.
- [Send a message in a conversation](https://docs.social-api.ai/api-reference/inbox/send-a-message-in-a-conversation.md): Sends an outgoing DM via the connected platform account and records it in the conversation.
- [Update conversation status](https://docs.social-api.ai/api-reference/inbox/update-conversation-status.md): Sets the status of a conversation to active or archived.
- [List active Instagram stories](https://docs.social-api.ai/api-reference/instagram/list-active-instagram-stories.md): Returns the currently-active stories for a connected Instagram account. Stories are ephemeral and expire about 24 hours after posting; each item carries is_story and a computed expires_at in metadata. Returns 501 for non-Instagram accounts.
- [Create an invite link](https://docs.social-api.ai/api-reference/invites/create-an-invite-link.md): Creates a single-use invite link for an external user to connect a social account to a brand. The brand must not already have a connected account for the specified platform, and no active (unused, unexpired) invite may exist for the same brand+platform combination.
- [List invites for a brand](https://docs.social-api.ai/api-reference/invites/list-invites-for-a-brand.md): Returns all invites (active and used/expired) for a brand, ordered by created_at DESC.
- [Redeem an invite link](https://docs.social-api.ai/api-reference/invites/redeem-an-invite-link.md): Public endpoint (no auth). Validates the invite token and redirects the user to the platform's OAuth authorization page. On successful OAuth callback, the account is connected to the invite creator's brand.
- [Revoke an invite](https://docs.social-api.ai/api-reference/invites/revoke-an-invite.md): Marks an invite as used (revoked), preventing it from being redeemed.
- [Get LinkedIn page insights](https://docs.social-api.ai/api-reference/linkedin/get-linkedin-page-insights.md)
- [Delete a media file](https://docs.social-api.ai/api-reference/media/delete-a-media-file.md)
- [Get a presigned media upload URL](https://docs.social-api.ai/api-reference/media/get-a-presigned-media-upload-url.md): Returns a presigned S3 PUT URL for client-side media upload. Upload the file directly via HTTP PUT to the returned URL, then call POST /v1/media/:id/verify to confirm.
- [Get storage usage](https://docs.social-api.ai/api-reference/media/get-storage-usage.md): Returns total bytes used, the plan limit, and file count for the authenticated user.
- [List media files](https://docs.social-api.ai/api-reference/media/list-media-files.md): Returns a paginated list of uploaded media files for the authenticated user.
- [Upload media (server-side)](https://docs.social-api.ai/api-reference/media/upload-media-server-side.md): Upload a media file directly through the API server.
- [Verify a media upload](https://docs.social-api.ai/api-reference/media/verify-a-media-upload.md): Confirms that a presigned-URL upload completed successfully and marks the media as ready.
- [List brand mentions](https://docs.social-api.ai/api-reference/mentions/list-brand-mentions.md): Fetches posts and stories where your brand account was mentioned or tagged. Results are sorted newest-first. Returns 501 for platforms that do not support mention tracking.
- [Reply to a mention](https://docs.social-api.ai/api-reference/mentions/reply-to-a-mention.md): Replies, as a public comment, to a mention of the connected account, including on a third-party post where the normal comment-reply endpoint is not permitted. Provide media_id (the media/post the mention is on); set comment_id only when the mention was in a comment (omit it to reply to a mention in…
- [Bulk import posts from CSV](https://docs.social-api.ai/api-reference/posts/bulk-import-posts-from-csv.md): Upload a CSV file to create multiple posts. Use dry_run=true to validate without creating.
- [Create or schedule a post](https://docs.social-api.ai/api-reference/posts/create-or-schedule-a-post.md): Creates a post for one or more connected accounts. Set `publish_now: true` to publish immediately: the post is accepted with status `publishing` and delivery runs in the background (so slow reel/video uploads do not block the request). The terminal status (`published`, `partial`, or `failed`) arrive…
- [Delete or cancel a post](https://docs.social-api.ai/api-reference/posts/delete-or-cancel-a-post.md): Deletes a draft/scheduled/failed post locally, or deletes a published post from every platform that supports it. Platforms that do not support deletion (or fail) keep their copy live and the post is kept (shrunk) rather than removed. Returns a per-platform result.
- [Get a single post](https://docs.social-api.ai/api-reference/posts/get-a-single-post.md): Fetch a post by its ID with all platform delivery details.
- [Get platform constraints](https://docs.social-api.ai/api-reference/posts/get-platform-constraints.md): Returns media and text constraints for all supported platforms. Cacheable.
- [Get post metrics](https://docs.social-api.ai/api-reference/posts/get-post-metrics.md): Fetches live engagement metrics from platform APIs for a published post.
- [List all posts](https://docs.social-api.ai/api-reference/posts/list-all-posts.md): Returns posts with rich filtering and cursor pagination. Supports filtering by status, platform, account_ids, date range, and text search.
- [Publish a draft post now](https://docs.social-api.ai/api-reference/posts/publish-a-draft-post-now.md): Publishes a post in `draft` or `scheduled` status immediately. The post is accepted with status `publishing` and delivery runs in the background (so slow reel/video uploads do not block the request); the terminal status arrives via the `post.published`/ `post.partial`/`post.failed` webhooks and by p…
- [Retry a failed post](https://docs.social-api.ai/api-reference/posts/retry-a-failed-post.md): Re-attempts publication of a post in `failed` or `partial` status. Consumes 1 post credit.
- [Unpublish a post](https://docs.social-api.ai/api-reference/posts/unpublish-a-post.md): Unpublishes a published post from a specific account (if account_id provided) or all accounts.
- [Update a post](https://docs.social-api.ai/api-reference/posts/update-a-post.md): Updates the text, media, schedule time, targets, or hidden status of a pending post. Only posts in `draft`, `scheduled`, or `failed` status can be updated.
- [Validate post content](https://docs.social-api.ai/api-reference/posts/validate-post-content.md): Dry-run validation. Returns errors for hard limit violations and warnings for best-practice issues.
- [Get platform usage limits](https://docs.social-api.ai/api-reference/usage/get-platform-usage-limits.md): Returns platform-specific quota data for a connected account as a key/value map where values are remaining counts. Keys are platform-defined - for example Instagram returns `posts_remaining`. An empty object is returned for platforms without usage limits.
- [Get resource usage for the current billing period](https://docs.social-api.ai/api-reference/usage/get-resource-usage-for-the-current-billing-period.md): Returns brands, posts, and interactions consumed during the current billing period alongside the plan limits. -1 means unlimited (all paid plans). Period boundaries come from Stripe subscription or rolling 30-day windows for free users.
- [Delete user account](https://docs.social-api.ai/api-reference/users/delete-user-account.md): Permanently deletes the authenticated user account and all associated data (API keys, connected accounts, usage logs). This action is irreversible.
- [Get current user](https://docs.social-api.ai/api-reference/users/get-current-user.md): Returns the authenticated user's profile (id, email, plan tier, onboarding flag, beta_tester flag, allowed_platforms list).
- [Update current user](https://docs.social-api.ai/api-reference/users/update-current-user.md): Updates the authenticated user's profile. Supports setting onboarding=false to mark onboarding as complete, and optionally storing use_case and referral for onboarding analytics.
- [Create webhook endpoint](https://docs.social-api.ai/api-reference/webhooks/create-webhook-endpoint.md): Registers a new webhook endpoint and performs a live reachability ping. If the endpoint is unreachable or returns an unexpected response, the request fails with 400 (webhook_verification_failed). The generated secret is returned once - store it securely.
- [Delete webhook endpoint](https://docs.social-api.ai/api-reference/webhooks/delete-webhook-endpoint.md): Removes a webhook endpoint. Future events will not be delivered to this URL.
- [Get webhook delivery](https://docs.social-api.ai/api-reference/webhooks/get-webhook-delivery.md): Returns the full record of a single webhook delivery attempt, including request payload, response status, response body excerpt, and timing.
- [Get webhook endpoint](https://docs.social-api.ai/api-reference/webhooks/get-webhook-endpoint.md): Returns the configuration and aggregate delivery stats for a single webhook endpoint owned by the caller.
- [List available webhook event types](https://docs.social-api.ai/api-reference/webhooks/list-available-webhook-event-types.md): Returns the catalog of webhook event types you can subscribe to, grouped by category (posts, inbox, accounts).
- [List webhook deliveries](https://docs.social-api.ai/api-reference/webhooks/list-webhook-deliveries.md): Returns recent delivery attempts for a webhook endpoint. Optionally filter by status (success, failed, pending) or event_type. Cursor-paginated.
- [List webhook endpoints](https://docs.social-api.ai/api-reference/webhooks/list-webhook-endpoints.md): Returns all webhook endpoints for the authenticated user.
- [Retry webhook delivery](https://docs.social-api.ai/api-reference/webhooks/retry-webhook-delivery.md): Requeues a failed webhook delivery for another attempt. Returns the updated delivery record.
- [Send test webhook delivery](https://docs.social-api.ai/api-reference/webhooks/send-test-webhook-delivery.md): Sends a synthetic event payload to the webhook endpoint to validate signature, reachability, and consumer handling. Returns the delivery result.
- [Update webhook endpoint](https://docs.social-api.ai/api-reference/webhooks/update-webhook-endpoint.md): Partially updates a webhook endpoint. All fields are optional; at least one must be provided.
- [Create a message template](https://docs.social-api.ai/api-reference/whatsapp/create-a-message-template.md): Submits a new message template to the WhatsApp Business Account (WABA) for review. The request body is the raw WhatsApp Cloud API template payload (name, category, language, components). New templates start in PENDING status; Meta reviews them and the status transitions to APPROVED or REJECTED async…
- [Delete a message template](https://docs.social-api.ai/api-reference/whatsapp/delete-a-message-template.md): Deletes a template by name from the WhatsApp Business Account (WABA) associated with this connected account. WhatsApp deletes all language variants that share the given name. Templates cannot be deleted while they are being used in active campaigns.
- [Deregister a phone number from WhatsApp Business](https://docs.social-api.ai/api-reference/whatsapp/deregister-a-phone-number-from-whatsapp-business.md): Releases the phone number from WhatsApp Business, freeing it for use with another Business Solution Provider (BSP). This does not delete the connected account on SocialAPI; the account remains until it is disconnected explicitly.
- [Edit a message template](https://docs.social-api.ai/api-reference/whatsapp/edit-a-message-template.md): Updates the components of an existing message template by its WhatsApp template ID. Only APPROVED templates can be edited, and editing resets the template to PENDING for re-review. APPROVED templates are limited to one edit per day.
- [Get a message template](https://docs.social-api.ai/api-reference/whatsapp/get-a-message-template.md): Returns a single message template by its WhatsApp template ID. Any active WhatsApp account on the caller's workspace is used to authorize the lookup; the template itself is scoped by its platform ID.
- [Get a WhatsApp Business Profile](https://docs.social-api.ai/api-reference/whatsapp/get-a-whatsapp-business-profile.md): Returns the public business profile for a WhatsApp phone number, including about text, address, description, contact email, websites, and vertical. The profile is visible to customers in the WhatsApp chat header.
- [Get phone number registration status](https://docs.social-api.ai/api-reference/whatsapp/get-phone-number-registration-status.md): Returns whether a phone number is verified and registered with WhatsApp Business. Used by client UIs to decide which step of the registration flow to show.
- [List message templates](https://docs.social-api.ai/api-reference/whatsapp/list-message-templates.md): Returns all message templates configured on the WhatsApp Business Account (WABA) associated with this connected account. Templates include approved, pending, rejected, and paused entries. Use the after cursor from paging.cursors to fetch subsequent pages.
- [Register a phone number with WhatsApp Business](https://docs.social-api.ai/api-reference/whatsapp/register-a-phone-number-with-whatsapp-business.md): Registers a previously verified phone number with WhatsApp Business and sets the 6-digit two-step verification PIN. The phone number must be verified via verify-code first. The PIN must be retained by the caller: losing it triggers a mandatory 7-day wait before it can be reset.
- [Request a phone number verification code](https://docs.social-api.ai/api-reference/whatsapp/request-a-phone-number-verification-code.md): Asks WhatsApp to send a one-time verification code to the phone number via SMS or voice call. The code is delivered to the underlying phone line, not to the API caller; follow up with verify-code once the user receives it. Step 1 of the phone-number registration flow (request-code, verify-code, regi…
- [Send a template message](https://docs.social-api.ai/api-reference/whatsapp/send-a-template-message.md): Sends an approved WhatsApp template message to a recipient phone number. Template messages can be sent outside the 24-hour customer service window. The template must already be APPROVED on the WABA, and the language code must match an approved variant. Component parameter order must match the templa…
- [Update a WhatsApp Business Profile](https://docs.social-api.ai/api-reference/whatsapp/update-a-whatsapp-business-profile.md): Updates one or more fields of the public business profile (about, address, description, email, websites, vertical, profile_picture_handle). Only provided fields are changed. The profile picture itself is changed by passing a profile_picture_handle obtained from the Resumable Upload API; profile_pict…
- [Validate a message template](https://docs.social-api.ai/api-reference/whatsapp/validate-a-message-template.md): Dry-run validation of a WhatsApp message template against the Cloud API rules (name format, component cardinality, header format, text limits, placeholder sequencing, button constraints). Returns errors for hard violations that WhatsApp would reject and warnings for best-practice issues. Performs no…
- [Verify a phone number with a code](https://docs.social-api.ai/api-reference/whatsapp/verify-a-phone-number-with-a-code.md): Submits the 6-digit code received via SMS or voice to prove ownership of the phone number. Once verified, the phone number can be registered with WhatsApp Business. Codes expire quickly; if verification fails, request a new code.
- [Edit a published YouTube video](https://docs.social-api.ai/api-reference/youtube/edit-a-published-youtube-video.md)
- [Edit a YouTube comment](https://docs.social-api.ai/api-reference/youtube/edit-a-youtube-comment.md): Edits the text of one of the connected account's own YouTube comments via comments.update. Only the comment author (the connected account) can edit. YouTube only.
- [Get YouTube channel summary](https://docs.social-api.ai/api-reference/youtube/get-youtube-channel-summary.md)
- [Moderate a YouTube comment](https://docs.social-api.ai/api-reference/youtube/moderate-a-youtube-comment.md): Sets the moderation status of a YouTube comment (published, held_for_review, or rejected), optionally banning the author. ban_author is only valid with status=rejected. YouTube only.
- [Re-sync a YouTube account's videos](https://docs.social-api.ai/api-reference/youtube/re-sync-a-youtube-accounts-videos.md)
- [Facebook](https://docs.social-api.ai/connectors/facebook.md): Connect and interact with Facebook Pages via the Meta Graph API.
- [Google Business Profile](https://docs.social-api.ai/connectors/google.md): Connect and interact with Google Business Profile locations via the Google Business Profile API.
- [Instagram](https://docs.social-api.ai/connectors/instagram.md): Connect and interact with Instagram accounts via the Meta Graph API.
- [LinkedIn](https://docs.social-api.ai/connectors/linkedin.md): Connect a LinkedIn member account to publish posts as the individual, or connect a LinkedIn organization page (beta).
- [Connectors Overview](https://docs.social-api.ai/connectors/overview.md): Platform capabilities and feature matrix.
- [Telegram](https://docs.social-api.ai/connectors/telegram.md): Connect a Telegram bot to read and reply to direct messages through SocialAPI.
- [Threads](https://docs.social-api.ai/connectors/threads.md): Connect and interact with Threads accounts via the Meta Threads API.
- [TikTok](https://docs.social-api.ai/connectors/tiktok.md): Connect and interact with TikTok accounts via the TikTok API.
- [Trustpilot](https://docs.social-api.ai/connectors/trustpilot.md): Trustpilot connector for SocialAPI.AI.
- [X / Twitter](https://docs.social-api.ai/connectors/twitter.md): Connect and interact with X (Twitter) accounts via the X API v2.
- [Twitter BYOK setup](https://docs.social-api.ai/connectors/twitter-byok.md): Bring your own Twitter Developer app to connect Twitter accounts to SocialAPI.
- [YouTube](https://docs.social-api.ai/connectors/youtube.md): Connect and interact with YouTube channels via the YouTube Data API.
- [Authentication](https://docs.social-api.ai/guides/authentication.md): How to authenticate requests using API keys, dashboard JWTs, or OAuth 2.1 tokens.
- [Core concepts](https://docs.social-api.ai/guides/concepts.md): The five nouns SocialAPI's API exposes (Brand, Account, Post, Interaction, Capability) and how they fit together.
- [Debugging with request IDs](https://docs.social-api.ai/guides/debugging.md): Use X-Request-ID to correlate API calls with server-side logs.
- [Error Handling](https://docs.social-api.ai/guides/errors.md): Error response format and the catalog of error codes returned by the API.
- [Unified inbox](https://docs.social-api.ai/guides/inbox.md): Read and respond to comments, DMs, reviews, and mentions across platforms through a single social media inbox API.
- [Interaction IDs](https://docs.social-api.ai/guides/interaction-ids.md): How SocialAPI IDs encode type and platform.
- [Media uploads](https://docs.social-api.ai/guides/media.md): Upload images and videos, then attach them to posts with a media ID.
- [OAuth Flows](https://docs.social-api.ai/guides/oauth.md): Connecting social accounts via platform OAuth and authenticating MCP clients via OAuth 2.1.
- [Pagination](https://docs.social-api.ai/guides/pagination.md): Page through large result sets using cursors.
- [Platform credentials](https://docs.social-api.ai/guides/platform-credentials.md): Whose OAuth app do you authenticate through? SocialAPI provides managed apps for every connector except Twitter.
- [Platform Support](https://docs.social-api.ai/guides/platforms.md): Which platforms support which capabilities.
- [Plans & Limits](https://docs.social-api.ai/guides/rate-limits.md): Resource limits, billing periods, export quotas, and how to monitor your usage.
- [Use cases](https://docs.social-api.ai/guides/use-cases.md): Common ways developers and AI agents use the SocialAPI.ai unified social media API: unified inbox, management, publishing, and AI agents.
- [Webhooks](https://docs.social-api.ai/guides/webhooks.md): Receive real-time notifications when interactions arrive on your connected accounts.
- [SocialAPI.AI](https://docs.social-api.ai/index.md): Unified social media API for developers. Manage your inbox, publish content, and monitor engagement across Instagram, Facebook, Threads, TikTok, YouTube, and X (Twitter) through a single REST API. Google Business and LinkedIn coming soon.
- [ChatGPT](https://docs.social-api.ai/integrations/chatgpt.md): Connect SocialAPI.AI to ChatGPT on web, desktop, and mobile.
- [Claude](https://docs.social-api.ai/integrations/claude.md): Connect SocialAPI.AI to Claude on web, desktop, CLI, and mobile.
- [Cursor](https://docs.social-api.ai/integrations/cursor.md): Connect SocialAPI.AI to Cursor via config file or Settings UI.
- [Custom MCP clients](https://docs.social-api.ai/integrations/custom.md): Connect any MCP client to SocialAPI.AI using an API key, for headless agents, server-side scripts, and CI jobs.
- [Mistral / Le Chat](https://docs.social-api.ai/integrations/mistral.md): Connect SocialAPI.AI to Le Chat on web and mobile.
- [Use with AI Assistants](https://docs.social-api.ai/integrations/overview.md): Connect the social media API for AI agents to Claude, ChatGPT, Mistral, Cursor, VS Code, and other AI tools as an MCP server.
- [VS Code + GitHub Copilot](https://docs.social-api.ai/integrations/vscode.md): Connect SocialAPI.AI to VS Code with GitHub Copilot via config file or Command Palette.
- [Facebook publishing](https://docs.social-api.ai/posts/facebook.md): Full reference for publishing Facebook Page posts via SocialAPI, including text, link preview, photo, and video posts.
- [Google Business Profile publishing](https://docs.social-api.ai/posts/google.md): Full reference for publishing Google Business Profile local posts via SocialAPI, including text, image, event, offer, and alert posts.
- [Instagram publishing](https://docs.social-api.ai/posts/instagram.md): Full reference for publishing Instagram posts via SocialAPI, including images, videos, reels, carousels, and platform-specific parameters.
- [LinkedIn Posts](https://docs.social-api.ai/posts/linkedin.md): Publish and manage posts on LinkedIn as the authenticated member.
- [Posts overview](https://docs.social-api.ai/posts/overview.md): Compare post publishing capabilities across all supported platforms.
- [Scheduling posts](https://docs.social-api.ai/posts/scheduling.md): Schedule posts across platforms via the unified social media API. One call, multiple targets, one scheduled time.
- [Threads publishing](https://docs.social-api.ai/posts/threads.md): Full reference for publishing Threads posts via SocialAPI, including text, images, videos, and carousels, plus platform-specific parameters.
- [TikTok publishing](https://docs.social-api.ai/posts/tiktok.md): Full reference for publishing TikTok videos and photo carousels via SocialAPI, including platform-specific parameters, creator validation, and polling behavior.
- [YouTube publishing](https://docs.social-api.ai/posts/youtube.md): Full reference for publishing YouTube videos via SocialAPI, including metadata, native scheduling, updates, and platform-specific parameters.
- [Quickstart](https://docs.social-api.ai/quickstart.md): Make your first social media inbox API call in under 5 minutes.

## OpenAPI Specs

- [openapi](https://docs.social-api.ai/api-reference/openapi.json)

## Optional

- [Support](mailto:support@social-api.ai)
- [GitHub](https://github.com/SocialAPI-AI)