# YouTube user profile API

user_profile on YouTube: 0.2 credits per successful call, with clear inputs, source data and billing.

Canonical: https://socialtoai.com/youtube-user-profile-api/

## One request

0.2 credits per successful or empty call. Failed calls cost 0.

Replace any PASTE_PUBLIC placeholder with a supported public identifier. This is a request template; it does not run automatically.

```
curl --request POST 'https://api.socialtoai.com/v1/user_profile' \
  --header "X-API-Key: $SOCIALTOAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
  --data '{"platform":"youtube","user":"PASTE_PUBLIC_ACCOUNT_ID"}'
```

## Native support

Result shape: profile_card. Pagination: not supported.

These values describe the reference card. Additional restrictions can apply to user discovery or a content subtype. Inspect applied_params and warnings instead of assuming an unsupported filter was honored.

## A schema-checked example

Illustrative result with one invented value and an example trial balance. It shows the response shape; it is not a live response or a production availability measurement.

```
{
  "request_id": "example_only_not_a_live_call",
  "schema_version": "v1",
  "fetched_at": "2026-09-05T00:00:00Z",
  "status": "ok",
  "applied_params": {},
  "warnings": [],
  "items": [
    {
      "kind": "profile_card",
      "id": "EXAMPLE_ACCOUNT_ID",
      "name": "Example account",
      "bio": "Illustrative profile, not a real account.",
      "followers": 12800,
      "posts_count": 214
    }
  ],
  "platform": "youtube",
  "billing": {
    "cost": 0.2,
    "balance": 1.8,
    "unit": "credits",
    "pricing": "standard"
  }
}
```

## Platform limitations

Content search returns videos; user search returns channels. Playlists and movies are excluded. User discovery supports relevance/all; unsupported content filters produce warnings.

Use an 11-character video ID or standard watch/shorts/youtu.be URL for items. Profiles and creator posts require a UC channel ID or /channel/ URL, not an @handle.

Replies require both reply_of and the cursor returned with that comment branch.

Trending currently supports Gaming only. Other categories are not claimed as available.

Count trims projected results. Encrypted cursors preserve remaining items and omit adjacent duplicates with warnings.

[All YouTube actions →](https://socialtoai.com/platforms/youtube/)