Skip to content
Docs

Validate posts and media before publishing; feedback and changelog.

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits7 endpointsMCP toolset tools

Character counts per network

POST/tools/validate/post-length

Weighted counts (X: URLs = 23, emoji/CJK = 2; x_premium = 25,000).

Access: readZernio: POST /v1/tools/validate/post-length

Try it with MCPAsk your agent to call validate-post-length (toolset tools)Set up MCP

Body object

textstringrequired

≤ 100000 characters

platformsarray of string

Returns object

objectstring

post_length

text_lengthinteger
platformsmap of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/tools/validate/post-length
curl -X POST "https://api.socialit.com/v1/tools/validate/post-length" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "platforms": [
      "string"
    ]
  }'
Response · 200
{
  "object": "post_length",
  "text_length": 1,
  "platforms": {
    "key": {
      "length": 1,
      "limit": 1,
      "remaining": 1,
      "valid": true
    }
  }
}

Validate a post for its target networks

POST/tools/validate/post

Same body as POST /posts; nothing is created. Runs shared limits, each network validator and platform_options schemas.

Access: readZernio: POST /v1/tools/validate/post

Try it with MCPAsk your agent to call validate-post (toolset tools)Set up MCP

Body object

contentstring

≤ 63206 characters

titlestring | null

≤ 300 characters

account_idsarray of string

≤ 200 items

profile_idstring | null

≤ 80 characters

group_idstring

≤ 80 characters

platformsarray of string

≤ 30 items

targetsarray of object

≤ 200 items

Show 8 item attributes
account_idstringrequired

socialAccount id (sa_…)

1–80 characters

contentstring

≤ 63206 characters

media_idsarray of string

≤ 35 items

media_urlsarray of any

Public HTTPS URLs or { url, alt_text?, type? }

≤ 35 items

mediaarray of object

≤ 35 items

Show 4 item attributes
media_idstring

media id (med_…)

1–80 characters

urlstring

≤ 2048 characters

alt_textstring

≤ 2000 characters

typestring

imagevideogifdocument

platform_optionsobject
first_commentstring

≤ 10000 characters

scheduled_atstring

≤ 40 characters

media_idsarray of string

≤ 35 items

media_urlsarray of any

Public HTTPS URLs or { url, alt_text?, type? }

≤ 35 items

mediaarray of object

≤ 35 items

Show 4 item attributes
media_idstring

media id (med_…)

1–80 characters

urlstring

≤ 2048 characters

alt_textstring

≤ 2000 characters

typestring

imagevideogifdocument

platform_optionsobject
first_commentstring | null

≤ 10000 characters

thread_itemsarray of object

≤ 25 items

Show 2 item attributes
contentstringrequired

≤ 63206 characters

media_idsarray of string

≤ 10 items

quote_post_idstring | null

≤ 80 characters

quote_urlstring | null

≤ 2048 characters

reply_to_urlstring | null

≤ 2048 characters

scheduled_atstring | null

ISO 8601; without offset = wall clock in timezone

≤ 40 characters

timezonestring | null

≤ 64 characters

publish_nowboolean
queueboolean
queue_idstring | null

≤ 80 characters

draftboolean
tagsarray of string

≤ 50 items

metadataobject
strictboolean
recycleobject | null
Show 7 child attributes
enabledbooleanrequired
intervalinteger

1–365

interval_unitstring

dayweekmonth

start_atstring (date-time)
max_countinteger | null

1–1000

expires_atstring (date-time) | null
content_variationsarray of string

≤ 20 items

notestring

≤ 5000 characters

Returns object

objectstring

post_validation

validboolean
errorsarray of object
Show 5 item attributes
account_idstring | null
platformstring | null
codestring
messagestring
paramstring | null
warningsarray of object
Show 5 item attributes
account_idstring | null
platformstring | null
codestring
messagestring
paramstring | null
targetsarray of object
Show 7 item attributes
account_idstring | null
platformstring
validboolean
lengthinteger | null
limitinteger | null
errorsarray of string
warningsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/tools/validate/post
curl -X POST "https://api.socialit.com/v1/tools/validate/post" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "title": "string",
    "account_ids": [
      "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ],
    "profile_id": "string",
    "group_id": "string"
  }'
Response · 200
{
  "object": "post_validation",
  "valid": true,
  "errors": [
    {
      "account_id": "string",
      "platform": "string",
      "code": "string",
      "message": "string",
      "param": "string"
    }
  ],
  "warnings": [
    {
      "account_id": "string",
      "platform": "string",
      "code": "string",
      "message": "string",
      "param": "string"
    }
  ],
  "targets": [
    {
      "account_id": "string",
      "platform": "string",
      "valid": true,
      "length": 1,
      "limit": 1,
      "errors": [
        "string"
      ],
      "warnings": [
        "string"
      ]
    }
  ]
}

Validate a media URL or library item

POST/tools/validate/media

Access: readZernio: POST /v1/tools/validate/media

Try it with MCPAsk your agent to call validate-media-url (toolset tools)Set up MCP

Body object

urlstring

≤ 2048 characters

media_idstring

media id (med_…)

1–80 characters

platformsarray of string

Returns object

objectstring

media_validation

validboolean
urlstring | null
content_typestring | null
sizeinteger | null
size_formattedstring | null
typestring | null
platformsmap of object
errorsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/tools/validate/media
curl -X POST "https://api.socialit.com/v1/tools/validate/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "media_id": "med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platforms": [
      "string"
    ]
  }'
Response · 200
{
  "object": "media_validation",
  "valid": true,
  "url": "https://example.com",
  "content_type": "string",
  "size": 1,
  "size_formatted": "string",
  "type": "string",
  "platforms": {
    "key": {
      "valid": true,
      "max_bytes": 1,
      "errors": [
        "string"
      ]
    }
  },
  "errors": [
    "string"
  ]
}

Check a subreddit

GET/tools/validate/subreddit

Existence, posting restrictions, rules and post requirements, through a connected Reddit account.

Access: readZernio: GET /v1/tools/validate/subreddit

Try it with MCPAsk your agent to call validate-subreddit (toolset tools)Set up MCP

Query parameters

namestringrequired

1–100 characters

account_idstring

Returns object

objectstring

subreddit_validation

namestring
existsboolean
validboolean
subredditobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/tools/validate/subreddit
curl "https://api.socialit.com/v1/tools/validate/subreddit?name=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "subreddit_validation",
  "name": "string",
  "exists": true,
  "valid": true,
  "subreddit": {}
}

TikTok video metadata

GET/tools/tiktok/download

Metadata and embed only: TikTok's official APIs don't allow downloading videos (download_url is always null).

Access: readZernio: GET /v1/tools/tiktok/download

Try it with MCPAsk your agent to call download-tik-tok-video (toolset tools)Set up MCP

Query parameters

urlstringrequired

10–2048 characters

actionstring

downloadmetadata

format_idstring

Returns object

objectstring

tiktok_video

urlstring
video_idstring | null
authorstring | null
titlestring | null
thumbnail_urlstring | null
embed_htmlstring | null
download_urlstring | null
unavailable_reasonstring | null
formatsarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/tools/tiktok/download
curl "https://api.socialit.com/v1/tools/tiktok/download?url=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "tiktok_video",
  "url": "https://example.com",
  "video_id": "string",
  "author": "string",
  "title": "string",
  "thumbnail_url": "https://example.com",
  "embed_html": "string",
  "download_url": "https://example.com",
  "unavailable_reason": "string",
  "formats": [
    {}
  ]
}

Send feedback to the Socialit team

POST/feedback

Bugs, missing features and docs issues; built for AI agents too.

Access: readIdempotency-KeyZernio: POST /v1/feedback

Try it with MCPAsk your agent to call submit-feedback (toolset tools)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

typestringrequired

bugmissing_featuredocsother

summarystringrequired

3–500 characters

detailsstring

≤ 10000 characters

endpointstring

≤ 300 characters

request_idstring

≤ 100 characters

expectedstring

≤ 5000 characters

actualstring

≤ 5000 characters

agentstring

≤ 100 characters

Returns object

objectstring

feedback

idstring
typestring
summarystring
detailsstring | null
endpointstring | null
request_idstring | null
expectedstring | null
actualstring | null
agentstring | null
created_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/feedback
curl -X POST "https://api.socialit.com/v1/feedback" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "bug",
    "summary": "string",
    "details": "string",
    "endpoint": "string",
    "request_id": "string"
  }'
Response · 201
{
  "object": "feedback",
  "id": "string",
  "type": "string",
  "summary": "string",
  "details": "string",
  "endpoint": "string",
  "request_id": "string",
  "expected": "string",
  "actual": "string",
  "agent": "string",
  "created_at": "2026-10-13T09:00:00.000Z"
}

API changelog

GET/changelog

Access: readZernio: GET /v1/changelog

Try it with MCPAsk your agent to call list-changelog (toolset tools)Set up MCP

Query parameters

typestring

new_featureimprovementbreaking_changedeprecationfix

impactstring

lowmediumhigh

platformstring
beforestring

≤ 30 characters

limitintegerdefault: 20

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
objectstring

changelog_entry

idstring
datestring
typestring
impactstring
titlestring
descriptionstring
platformsarray of string
operationsarray of string
urlstring | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/changelog
curl "https://api.socialit.com/v1/changelog" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "list",
  "data": [
    {
      "object": "changelog_entry",
      "id": "string",
      "date": "string",
      "type": "string",
      "impact": "string",
      "title": "string",
      "description": "string",
      "platforms": [
        "string"
      ],
      "operations": [
        "string"
      ],
      "url": "https://example.com"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}