Batch public profiles

curl --request POST \
  --url https://socialquery.dev/v1/prism/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "items": [
    {
      "platform": "bluesky",
      "handle": "bsky.app",
      "custom_id": "account-1"
    },
    {
      "platform": "youtube",
      "handle": "@GoogleDevelopers",
      "custom_id": "account-2"
    }
  ]
}
'

import requests

url = "https://socialquery.dev/v1/prism/profiles"

payload = { "items": [
        {
            "platform": "bluesky",
            "handle": "bsky.app",
            "custom_id": "account-1"
        },
        {
            "platform": "youtube",
            "handle": "@GoogleDevelopers",
            "custom_id": "account-2"
        }
    ] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    items: [
      {platform: 'bluesky', handle: 'bsky.app', custom_id: 'account-1'},
      {platform: 'youtube', handle: '@GoogleDevelopers', custom_id: 'account-2'}
    ]
  })
};

fetch('https://socialquery.dev/v1/prism/profiles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "data": {
    "items": [
      {
        "platform": "<string>",
        "handle": "<string>",
        "status": "ok",
        "data": {
          "username": "<string>",
          "display_name": "<string>",
          "avatar_url": "<string>",
          "bio": "<string>",
          "url": "<string>",
          "location": "<string>",
          "external_url": "<string>",
          "id": "<string>",
          "verified": true,
          "followers": 1,
          "following": 1,
          "posts_count": 1,
          "likes_count": 1,
          "ext": {}
        },
        "credits_used": 1,
        "ext": {
          "reason": "<string>"
        },
        "custom_id": "<string>"
      }
    ],
    "returned_count": 123,
    "succeeded": 123,
    "next_cursor": null
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

Prism

Batch public profiles

Batch public profile lookup in input order, preserving custom_id. Supported platforms: instagram, tiktok, youtube, bluesky, threads, truthsocial, twitch, snapchat, kwai, facebook, twitter, linkedin. Source identities are checked before returning canonical Author objects. Missing fields remain null. Reserve one credit per input (five for LinkedIn), then charge only successful profiles at that rate and refund all other rows. Public source access and provider allowances apply; Truth Social is limited to prominent publicly accessible accounts. Unsupported platforms return an unbilled row. JSON only: posts, since, stop_at_id and SSE are not implemented. Four bounded source workers; unstarted rows are deferred and unbilled. No response cache; idempotent replay is free. The serialized items array must fit the 16,000-character parameter limit.

POST

prism

profiles

curl --request POST \
  --url https://socialquery.dev/v1/prism/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "items": [
    {
      "platform": "bluesky",
      "handle": "bsky.app",
      "custom_id": "account-1"
    },
    {
      "platform": "youtube",
      "handle": "@GoogleDevelopers",
      "custom_id": "account-2"
    }
  ]
}
'

import requests

url = "https://socialquery.dev/v1/prism/profiles"

payload = { "items": [
        {
            "platform": "bluesky",
            "handle": "bsky.app",
            "custom_id": "account-1"
        },
        {
            "platform": "youtube",
            "handle": "@GoogleDevelopers",
            "custom_id": "account-2"
        }
    ] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    items: [
      {platform: 'bluesky', handle: 'bsky.app', custom_id: 'account-1'},
      {platform: 'youtube', handle: '@GoogleDevelopers', custom_id: 'account-2'}
    ]
  })
};

fetch('https://socialquery.dev/v1/prism/profiles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "data": {
    "items": [
      {
        "platform": "<string>",
        "handle": "<string>",
        "status": "ok",
        "data": {
          "username": "<string>",
          "display_name": "<string>",
          "avatar_url": "<string>",
          "bio": "<string>",
          "url": "<string>",
          "location": "<string>",
          "external_url": "<string>",
          "id": "<string>",
          "verified": true,
          "followers": 1,
          "following": 1,
          "posts_count": 1,
          "likes_count": 1,
          "ext": {}
        },
        "credits_used": 1,
        "ext": {
          "reason": "<string>"
        },
        "custom_id": "<string>"
      }
    ],
    "returned_count": 123,
    "succeeded": 123,
    "next_cursor": null
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

Pass 1–50 objects in items, each with platform, handle, and optional custom_id. Results retain input order and caller IDs. Handles may be bare, begin with @, or be canonical HTTPS profile URLs. URLs must match the selected platform; redirects, credentials, query strings and fragments are rejected. Supported platforms: Instagram, TikTok, YouTube, Twitter, Threads, Twitch, Snapchat, Truth Social, Bluesky, Kwai, LinkedIn and Facebook. Social profiles use ScrapeCreators, YouTube uses its official API, Bluesky uses its public API, and LinkedIn uses ScrapeBadger. Other platform values return unsupported, with no final charge. Truth Social is limited to prominent publicly accessible accounts. Facebook gated pages are rejected. LinkedIn’s id is the returned public profile slug (ext.id_kind: public_id), not a numeric member ID. Twitch partnership and Twitter blue-verification flags remain separate from canonical verification. Kwai counts reflect the public source even when surprisingly small; no values are inferred. Truth Social’s HTML biography remains in ext.bio_html, with canonical bio null. Provider access and available allowance determine whether a live lookup succeeds. Posts, since, per-item stop_at_id, and SSE are not implemented. Supplied enrichment options or SSE requests return 422 before spending. The JSON-serialized items array must fit the 16,000-character parameter limit. Every ok row contains a canonical Author in data. The returned identity must match the input. Unknown follower, verification or location fields remain null; hidden YouTube subscriber counts remain null. Provider errors are not treated as nonexistent accounts. A definitive source miss returns not_found. The request holds one credit per input, or five for a LinkedIn input, then refunds every not_found, unsupported, error and deferred row. Each successful profile costs one credit, or five for LinkedIn. Repeated input rows are separate lookups. Include the summed hold in X-Max-Credits. At most four source calls run concurrently, each with a twelve-second timeout. No new source work starts after twenty-eight seconds. Rows left unstarted return deferred and cost zero. A provider authentication or quota failure stops new calls to that provider while other providers continue. The response is never cached. Replay the same Idempotency-Key for zero-cost replay, or retry only failed/deferred rows with a new key. For MCP use execute_endpoint. The Python skill requires --allow-mutation, the batch budget and an idempotency key. Both clients calculate the complete hold before sending the batch.

Authorizations

x-api-key

string

header

required

Headers

Cache-Control

string

Idempotency-Key

string

X-Max-Credits

integer

Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero.

Required range: x >= 0

Body

application/json

items

object[]

required

Required array length: 1 - 50 elements

Show child attributes

Example:

[
  {
    "platform": "bluesky",
    "handle": "bsky.app",
    "custom_id": "account-1"
  },
  {
    "platform": "youtube",
    "handle": "@GoogleDevelopers",
    "custom_id": "account-2"
  }
]

include

enum<string>

Not implemented in this release; returns 422 before spending.

Available options:

posts

since

string

Not implemented in this release; returns 422 before spending.

Response

success

boolean

required

platform

string

required

endpoint

string

required

credits_used

integer

required

Required range: x >= 0

credits_remaining

integer | null

required

request_id

string

required

cached

boolean

required

data

object

required

The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.

Show child attributes