---
title: "Retrieve channel profile"
method: GET
path: "/youtube/profile/{id}"
tags: ["YouTube"]
---

# Retrieve channel profile

`GET /youtube/profile/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/youtube/profile/{id}`
- Auth: API key in header `x-api-key`

Returns the profile of a YouTube channel by `id`, which can be a channel id, `@handle`, `/c` or `/user` path, bare username or full channel URL. The profile has channel id, name and URL, bio, join date, region, profile picture, links, and `stats` with `followers_count`, `videos_count` and `views_count`.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

Wrapped *Profile* payload

- YoutubeProfileResponseDoc
  - `code` integer
  - `data` YoutubeProfile
    - `bio` string
    - `channel_id` string
    - `channel_name` string
    - `channel_url` string
    - `created_at` string
    - `id` string
    - `joined_date` string
    - `links` string[]
    - `profile_pic` string
    - `region` string
    - `stats` YoutubeProfileStats
      - `followers_count` integer
      - `videos_count` integer
      - `views_count` integer
    - `updated_at` string
  - `msg` string

## Other responses

- `400`: Missing or invalid *id* parameter
- `429`: Rate limit exceeded
- `500`: Internal server error

---

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