Skip to main content
POST
/
posts
/
validate
Validate post content
curl --request POST \
  --url https://api.social-api.ai/v1/posts/validate \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_ids": [
    "<string>"
  ],
  "media_ids": [
    "<string>"
  ],
  "platforms": [
    "<string>"
  ],
  "scheduled_at": "2026-04-01T10:00:00Z",
  "targets": [
    {
      "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
      "first_comment": "<string>",
      "media_ids": [
        "<string>"
      ],
      "page_id": "sapi_page_01JRQX...",
      "platform_data": {},
      "scheduled_at": "2026-04-01T10:00:00Z",
      "text": "Platform-specific version of the post",
      "title": "Custom title for LinkedIn",
      "visibility": "public"
    }
  ],
  "text": "Check out our new product! #launch"
}
'
{
  "errors": [
    {
      "field": "text",
      "message": "exceeds 2200 character limit (2350/2200)",
      "platform": "instagram",
      "target": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J"
    }
  ],
  "valid": true,
  "warnings": [
    {
      "field": "text",
      "message": "exceeds 2200 character limit (2350/2200)",
      "platform": "instagram",
      "target": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J"
    }
  ]
}

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.

Authorizations

Authorization
string
header
required

Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...

Body

application/json

Content to validate

account_ids
string[]

AccountIDs lists connected account IDs — their platforms are resolved automatically.

media_ids
string[]

MediaIDs are media file IDs to validate (checks count and type limits).

platforms
string[]

Platforms lists platform names to validate against (e.g. ["instagram", "linkedin"]).

scheduled_at
string

ScheduledAt validates the schedule time (must be in the future, within platform limits).

Example:

"2026-04-01T10:00:00Z"

targets
object[]

Targets validates per-target overrides if provided.

text
string

Text is the post content to validate against platform constraints.

Example:

"Check out our new product! #launch"

Response

OK

errors
object[]
valid
boolean
warnings
object[]