Person APIs

Social Account Validator

Validates a public social profile or supported post URL and returns its status, a screenshot URL, an HTML capture URL, and account-visibility fields. The platform (Instagram / X / Twitter / Facebook / LinkedIn) and target type (profile vs post) are inferred from the URL; batch validation is not supported here. The request is normally queued and returns a request_id to poll (or to a callback_url); a cached target may instead return 200 with a completed status inline.

POST https://api.nyne.ai/person/social-account-validator API key

Try it needs this required parameter:

Overview

Validate a public social profile or post and capture a screenshot.

Parameters

url string required

The social profile or post URL to validate (aliased as social_media_url). Must be HTTP/HTTPS on a supported platform.

callback_url string optional

If set, the completed result is POSTed here when the job finishes. Must be a valid HTTP(S) URL on an allowed host when a callback allow-list is configured.

Retrieving the result

This endpoint is asynchronous. A successful submit returns 202 with a request_id while the job runs in the background. Poll the same path with a GET request — same authentication headers — passing the request_id as a query parameter:

curl "https://api.nyne.ai/person/social-account-validator?request_id=<request_id>" \
  -H "X-API-Key: nyne_live_a17f…3c9b" \
  -H "X-API-Secret: nyne_sec_••••••••"

Each poll returns the job's current status; once it is completed the payload carries the result shown under Responses. Polling an unknown or expired request_id returns 404 request_not_found.

Status	Meaning
queued · processing · pending	The job is still running — keep polling.
completed	The job finished; the payload carries the result and completed: true.
failed	Terminal — the job could not complete; the error field explains why.

Poll every few seconds at first, backing off for long-running jobs. Polling is free — status checks never burn credits.

Prefer push delivery?

Supply the optional callback_url parameter and the completed payload is POSTed to your endpoint when the job finishes — no polling required.

Credit usage

Credits are charged based on the matched configuration. The listed cost is the per-result unit price.

Feature	Credits	Notes
Social Account Validator	—	credit_costs.social_account_validation
Cache hit	full	Cached results are charged at the full rate

Heads up

A positive credit balance is required before each request. Empty results do not burn credits.

Responses

202 Validation queued — poll the status endpoint with the returned request_id

200 Served from cache — status: "completed" returned inline

400 Missing/invalid url, unsupported platform, or batch subaction

401 Missing or invalid API credentials

402 insufficient_credits

403 subscription_required or ip_not_allowed

429 rate_limit_exceeded

503 service_unavailable — backing store/queue unconfigured

A successful response wraps the payload in the { success, data, timestamp } envelope (also shown live in the panel on the right):

{
  "success": true,
  "data": {
    "request_id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4_1717000000_4271",
    "status": "completed",
    "completed": true,
    "result": {
      "validation_status": "verified",
      "account_active": true,
      "account_active_reason": "Account exists and the profile is public.",
      "confidence": 0.95,
      "screenshot_url": "https://cdn.example.com/screenshots/janedoe.png"
    },
    "completed_on": "2026-01-15T10:33:00Z"
  },
  "timestamp": "2026-06-12T10:55:49"
}