---
title: "Get a YouTube creator from the dataset"
method: GET
path: "/datasets/youtube-creators/items/{channel_id}"
tags: ["Datasets"]
---

# Get a YouTube creator from the dataset

`GET /datasets/youtube-creators/items/{channel_id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/youtube-creators/items/{channel_id}`
- Auth: API key in header `x-api-key`

Returns one YouTube channel from the dataset by `channel_id`. The record has channel name and URL, bio, region, join date, links, profile picture, and subscriber, video and view counts, each with an availability flag. A channel not in the dataset returns 404.

## Path parameters

- `channel_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsYoutubeCreatorResponseDoc
  - `code` integer
  - `data` EsYoutubeChannelCandidate
    - `bio` string
    - `channel_id` string
    - `channel_name` string
    - `channel_url` string
    - `discovered_at` string
    - `discovery_source` string
    - `followers_count` integer
    - `followers_count_available` boolean
    - `hydrated_at` string
    - `joined_date` string
    - `links` string[]
    - `profile_pic` string
    - `region` string
    - `status` string
    - `videos_count` integer
    - `videos_count_available` boolean
    - `views_count` integer
    - `views_count_available` boolean
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `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/028417aa35bb?raw)