Please log in to access your API credentials and start using our APIs. Log In & Start Free Trial

Social Account Validator API

Validate a social profile or supported post URL and return status, screenshot URL, HTML URL, and account visibility fields.

API Endpoint

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

Overview

Use this API to validate a social account or supported post URL. The API returns status fields, optional screenshot and HTML URLs, and the timestamp when those URLs are invalidated.

Platforms: supported social platforms
Input: full profile or supported post URL
Targets: profiles and supported posts
Output: status, platform, handle, target type, confidence, evidence, account activity signal, screenshot URL, HTML URL, and artifact invalidation timestamp

Authentication

All requests require your API key and secret in headers.

Header Authentication

X-API-Key: your_api_key_here
X-API-Secret: your_api_secret_here

Credit Usage

Credits are charged for each POSTed target that completes.

Social Account Validator: 10 credits per completed POSTed target
Batch requests: charged per completed target
Processing failures: not charged

POST /person/social-account-validator

Queue validation for one social target.

POST /person/social-account-validator

Parameters

url (string, required)
Full profile or supported post URL. Platform, handle, and target type are derived automatically.

callback_url (string, optional)
Webhook URL for the final result.

Request Example

{ "url": "https://social.example/profile/example" }

Queued Response

{ "success": true, "data": { "request_id": "sav_abc123...", "status": "queued" } }

POST /person/social-account-validator/batch

Queue up to 25 social targets in one parent request.

POST /person/social-account-validator/batch

Request Example

{ "targets": [ { "url": "https://social.example/profile/example" }, { "url": "https://social.example/post/example" } ], "callback_url": "https://yourapp.com/webhooks/social-account-validator" }

GET /person/social-account-validator

Poll with the returned request ID until the request is completed or failed.

GET /person/social-account-validator?request_id=sav_abc123...

Completed Response Example

{ "success": true, "data": { "request_id": "sav_abc123...", "status": "completed", "platform": "supported_social_site", "target_type": "profile", "handle": "example", "normalized_url": "https://social.example/profile/example", "validation_status": "visible_profile_with_login_prompt", "account_active": true, "confidence": 0.74, "primary_screenshot_url": "https://api.nyne.ai/social-account-validation-artifacts/sav_abc123/primary.png", "html_url": "https://api.nyne.ai/social-account-validation-artifacts/sav_abc123/primary.html.txt", "image_invalidated_at": "2026-05-05T12:00:00", "artifacts_invalidated_at": "2026-05-05T12:00:00", "evidence": [ "Handle or target path appears in page text/metadata." ], "credits_charged": 10 } }

html_url is available when an HTML artifact is returned. artifacts_invalidated_at is the timestamp when the returned screenshot and HTML URLs are invalidated; image_invalidated_at is retained for screenshot-specific compatibility.

Validation Statuses

visible_public_profile
visible_profile_with_login_prompt
visible_public_post
visible_post_with_login_prompt
login_wall_or_consent_only
private_or_restricted
not_found
not_found_unverified
verified_profile_exists
verified_profile_exists_login_wall
verified_profile_exists_no_screenshot
verification_inconclusive_no_screenshot
unclear_profile_possible
unclear_screenshot_captured
unclear_no_screenshot

Callbacks

If callback_url is provided, the API sends the final single or batch payload after processing finishes. Your endpoint should return HTTP 2xx.

Error Codes

HTTP	Code	Description
400	`missing_parameters`	Missing URL.
400	`invalid_request_id`	The request ID format is invalid.
400	`unsupported_platform`	The URL host is not supported.
401	`invalid_credentials`	API key or secret is incorrect.
402	`insufficient_credits`	Not enough credits for the requested targets.
404	`request_not_found`	The request ID was not found for this API key.
429	`rate_limit_exceeded`	Too many requests for the current key.
503	`service_unavailable`	The API is temporarily unavailable.