Utilities API

The TrueScrape cross-platform utility API exposes 2 public endpoints covering Find a creator's other social profiles. Every call is a GET against public, logged-out pages and returns the same unified schema as every other platform here. Calls cost 1–10 credits each. A cache hit is free, and a failed or empty response is never charged.

Endpoints

Reference

curl "$API/v1/find-social-profiles?platform=instagram&handle=%40mkbhd&cache_max_age=7d" \
  -H "x-api-key: $KEY"

const query = new URLSearchParams({
  platform: 'instagram',
  handle: '@mkbhd',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/find-social-profiles?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 10 credits, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);

import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/find-social-profiles",
    params={
        "platform": "instagram",
        "handle": "@mkbhd",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

curl "$API/v1/detect-age-gender?url=8XkPqR2nLvE&cache_max_age=7d" \
  -H "x-api-key: $KEY"

const query = new URLSearchParams({
  url: '8XkPqR2nLvE',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/detect-age-gender?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);

import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/detect-age-gender",
    params={
        "url": "8XkPqR2nLvE",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Questions

How much does the cross-platform utility API cost?

Calls cost 1–10 credits each. Every endpoint is cacheable, and a cache hit costs nothing. A failed request and an empty result are both free, on every endpoint.

Does the cross-platform utility API need a login or cookies?

No. Every endpoint reads public, logged-out pages only — no account, no cookies, no session. An API key identifies your own TrueScrape account and nothing else.

Can I fetch many cross-platform utility targets in one request?

Yes. 2 of 2 are batchable: one POST to /v1/jobs/batch takes many targets and returns a job id to poll.

Can I watch cross-platform utility endpoints for changes?

No. All 2 carry x-subscribable: false in the spec, so none can be subscribed to.