Nyne.ai API Get API key
Person APIs

Social Account Validation API

Validate a public social profile or supported post URL and return status, screenshot URL, HTML URL, and account-visibility fields when available. The platform and target type are inferred from the URL; multiple URLs can be validated with POST /person/social-account-validator/batch. The request is queued and returns a request_id to poll, or can deliver the final result to a callback_url.

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

Manual credentials take precedence over your account key.

Try it needs this required parameter:

Overview

The Social Account Validator checks a public social profile or post and captures supporting evidence for account verification and trust workflows.

Best for

  • Verifying social profile authenticity
  • Reviewing public account evidence
  • Trust and safety workflows

Returns

  • Validation status
  • Screenshot or evidence context
  • Profile or post metadata

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 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 and any endpoint-specific page values shown below as query parameters:

Loading your API credentials...

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. Delivery is retried up to 5 times with exponential backoff (1s, 5s, 15s, 1m, 5m) and a 30-second timeout per attempt; respond with a 2xx status to acknowledge receipt.

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 - Charged per completed validation target
Heads up
Empty results do not burn credits.

Responses

202 Validation queued - poll the status endpoint with the returned request_id
200 Completed validation returned inline with status: "completed"
400 Missing/invalid url or unsupported platform
401 Missing or invalid API credentials
402 insufficient_credits
403 subscription_required or ip_not_allowed
429 rate_limit_exceeded
503 service_unavailable - the API is temporarily unavailable

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": "sav_9f2c4e6a8b0d4f21a7c3e5b1d8a6c4f2",
    "batch_id": null,
    "target_index": 0,
    "status": "completed",
    "platform": "instagram",
    "target_type": "profile",
    "handle": "janedoe",
    "input_url": "https://instagram.com/janedoe",
    "normalized_url": "https://instagram.com/janedoe",
    "created_on": "2026-01-15T10:32:41",
    "completed_on": "2026-01-15T10:33:00",
    "credits_charged": 10,
    "validation_status": "visible_public_profile",
    "account_active": true,
    "account_active_reason": "The target account or post appears to exist in the page response.",
    "confidence": 0.84,
    "status_reason": "The page includes the account identity plus profile markers.",
    "primary_screenshot_url": "https://api.example.com/social-account-validation-artifacts/sav_9f2c4e6a8b0d4f21a7c3e5b1d8a6c4f2/primary.png",
    "screenshot_url": "https://api.example.com/social-account-validation-artifacts/sav_9f2c4e6a8b0d4f21a7c3e5b1d8a6c4f2/primary.png",
    "evidence": [
      "Handle or target path appears in page text/metadata.",
      "Profile markers seen: followers, following, posts"
    ],
    "artifact_urls": {
      "primary_screenshot_url": "https://api.example.com/social-account-validation-artifacts/sav_9f2c4e6a8b0d4f21a7c3e5b1d8a6c4f2/primary.png",
      "html_url": "https://api.example.com/social-account-validation-artifacts/sav_9f2c4e6a8b0d4f21a7c3e5b1d8a6c4f2/primary.html.txt"
    },
    "html_url": "https://api.example.com/social-account-validation-artifacts/sav_9f2c4e6a8b0d4f21a7c3e5b1d8a6c4f2/primary.html.txt",
    "image_invalidated_at": "2026-01-22T10:33:00",
    "artifacts_invalidated_at": "2026-01-22T10:33:00"
  },
  "timestamp": "2026-01-01T00:00:00"
}