social data api

Creator tools

Cross-platform profile discovery and audience age and gender estimation.

Cross-platform account finder	`/v1/find-social-profiles`	10 requests
Estimated age and gender	`/v1/detect-age-gender`	1 request

GET/v1/find-social-profiles

Cross-platform account finder

10 requests

Starting from one creator handle on Instagram, Facebook, TikTok, YouTube or X (x and twitter are interchangeable), the API maps the creator's other public accounts. Send a bare handle, not a URL; on YouTube a 24-character channel ID also works. The source profile is read first: links in its bio are collected and known link-in-bio pages are opened. Up to three linked profiles and up to three websites the creator declares are then checked. The same handle is also tried on every other supported platform, and a bounded Google search looks for alternate handles, at most two per platform and four overall. An account is only added to profiles when the evidence ties it to the creator: it links back to the source profile, or both accounts point at the same website the creator controls. A matching handle or display name on its own is not enough, and parked domains or shared storefront hosting are never counted as a shared website. Each match carries a confidence score: 0.95 for a reciprocal link or a link declared by an already verified profile, 0.9 for a shared website, 0.75 for an exact display name or same-handle evidence, and 0.6 for a Google discovery. Every URL that was tried is reported, verified or not, in same_handle_candidate_urls, source_linked_profile_urls, google_candidate_urls, verified_google_candidate_urls and the matching failed_* fields. The result is deterministic, with no AI involved. If some steps fail, partial is set and the failure fields explain which. If every declared link-in-bio page fails and nothing else turns up a profile, the call returns 503 and costs nothing. A successful live lookup costs 10 requests.

Query parameters

`platform` stringrequired	Platform the handle belongs to. `instagramtiktokyoutubextwitterfacebook`
`handle` stringrequired	Creator handle, not a profile URL. The leading @ is optional.
`cache_max_age` string	Accept a stored response up to this age. Inside that window the answer is free and comes back with `cached: true` and a `cached_at` time; past it, the request runs live for 10 requests. `1d3d7d14d30d`

curl "https://api.pandorlabs.com/v1/find-social-profiles?platform=instagram&handle=creator" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 10,
  "source": {
    "platform": "instagram",
    "handle": "creator",
    "url": "https://www.instagram.com/creator"
  },
  "profiles": [
    {
      "platform": "instagram",
      "handle": "creator",
      "url": "https://www.instagram.com/creator",
      "confidence": 1,
      "evidence": [
        "source_profile"
      ]
    }
  ],
  "link_in_bio_urls": [
    "https://linktr.ee/creator"
  ],
  "expanded_website_urls": [
    "https://creator.com/"
  ],
  "source_linked_profile_urls": [
    "https://x.com/creator"
  ],
  "failed_source_linked_profile_urls": [],
  "same_handle_candidate_urls": [
    "https://www.tiktok.com/@creator"
  ],
  "partial": false,
  "failed_link_in_bio_urls": [],
  "failed_website_urls": [],
  "same_handle_search_partial": false,
  "google_search_used": true,
  "google_search_failed": false,
  "google_candidate_urls": [
    "https://www.facebook.com/creator-page"
  ],
  "google_candidate_link_in_bio_urls": [
    "https://linktr.ee/creator"
  ],
  "failed_google_candidate_link_in_bio_urls": [],
  "verified_google_candidate_urls": [
    "https://www.facebook.com/creator-page"
  ],
  "failed_google_candidate_urls": [],
  "google_verification_partial": false
}

GET/v1/detect-age-gender

Estimated age and gender

1 request

Estimates a creator's age and gender with an AI model applied to their profile photo. The response gives gender, an ageRange with a lower and upper bound, and a confidence value attached to the gender guess. Accuracy depends on the photo showing a clear, visible face.

Query parameters

url

stringrequired

Link to the user's social profile.

curl "https://api.pandorlabs.com/v1/detect-age-gender?url=https%3A%2F%2Ftwitter.com%2Flevelsio" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "ageRange": {
    "low": 23,
    "high": 29
  },
  "gender": "Male",
  "confidence": {
    "gender": 82.51082611083984
  }
}