---
title: "One creator profile"
method: GET
path: "/v1/raw/{platform}/creator/{handle}"
tags: ["Raw"]
---

# One creator profile

`GET /v1/raw/{platform}/creator/{handle}`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/raw/{platform}/creator/{handle}`
- Auth: HTTP bearer

Profile and current counts for one creator. Live data fetched at request time, not stored by Virlo. Typical latency is a few seconds, up to about 25 s. 1 credit ($0.01) per call, including an empty page. Errors (400, 404, 5xx) are not billed.

## Path parameters

- `platform` 'tiktok' | 'youtube' | 'instagram', required
- `handle` string, required

## Response `200`

- RawCreatorResponseDto
  - `data` RawCreatorDto, required
    - `id` string, nullable, required
    - `platform` 'tiktok' | 'youtube' | 'instagram', required
    - `handle` string, required: Handle without the leading @.
    - `display_name` string, nullable, required
    - `bio` string, nullable, required
    - `avatar_url` string, nullable, required: Avatar image URL on the platform CDN. These links can expire.
    - `url` string, required
    - `verified` boolean, nullable, required
    - `external_url` string, nullable, required: Link in bio, when set.
    - `stats` RawCreatorStatsDto, required
      - `followers` number, nullable, required
      - `following` number, nullable, required
      - `likes` number, nullable, required: Total likes received across the account. Null where the platform does not expose it.
      - `videos` number, nullable, required: Number of posts or videos on the account.
    - `platform_data` object, required: Platform-only fields, snake_case. Keys differ by platform and may be absent when the platform does not return them.

## Other responses

- `400`: Invalid input (`validation_error`), operation not offered on this platform (`unsupported_platform`), or a bad cursor (`invalid_cursor`). Not billed.
- `401`: Missing or invalid API key (`missing_api_key` / `invalid_api_key`)
- `402`: Not enough credits (`insufficient_credits`).
- `404`: The platform has no public item for this input (`not_found`). Not billed.
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header
- `502`: The platform did not return data (`upstream_error`). Retry. Not billed.
- `503`: Temporarily unavailable (`service_unavailable`). Retry later. Not billed.
- `504`: The platform took too long to answer (`request_timeout`). Retry. Not billed.

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)