# Social Profile Check (Facebook / Threads / Snapchat) (`social.profile_check`)

Check whether a handle exists on Facebook, Threads or Snapchat and get its public profile; a miss means the profile was not found.

Docs: https://primaryapi.com/docs/api-reference/social/profile_check

- Endpoint: `POST https://api.primaryapi.com/v1/run/social.profile_check`
- Category: Social · Platform: `social` · Kind: composite · Status: live
- Price: 2 credits per call. Every call costs the same, including calls that were retried automatically.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=social.profile_check`
- Execution: synchronous (answers 202 only if it outlives the wait window)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `platform` | enum | yes |  | one of: facebook, threads, snapchat | Platform to check. |
| `handle` | string | yes |  | max 200 chars | Handle, page name or username without the @ (a profile URL on that platform also works). |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

`output.data` is free-form JSON.

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/social.profile_check" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"threads","handle":"sportsillustrated"}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "id": "63496592589",
      "username": "sportsillustrated",
      "fullName": "Sports Illustrated",
      "biography": "Sports, sports and more sports.",
      "followerCount": 551296,
      "isVerified": true,
      "isPrivate": false,
      "profilePicUrl": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/483433564_655589117415062_s320.jpg",
      "url": "https://www.threads.com/@sportsillustrated",
      "bioLinks": [
        "https://lnk.bio/sportsillustrated"
      ]
    }
  },
  "provider": "PrimaryAPI",
  "credits": 2,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z"
}
```

## Pricing and reliability

- Usual price: 2 credits per call
- Price ceiling: the usual price, even when a call is retried. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=social.profile_check`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`. See https://primaryapi.com/docs/errors.

## Notes

Routes to facebook.profile, threads.profile or snapchat.profile and returns that SKU's data as is (a delegate cannot reshape it, so this is not the 1Lookup field layout). Only this composite's price is charged; inner fallbacks of the target SKU still apply. Other 1Lookup platforms (Instagram, TikTok, YouTube, X, Bluesky, Truth Social) live in other domains and are not wired in yet.

