Get Channels by Country

Developing

GET

https://api.narrativ.tech/functions/v1/youtube/channels/by-country

Retrieve a paginated list of YouTube channels filtered by a specified country.

Country codes must be valid two-letter ISO codes (e.g., US, GB, JP).

Supports sorting by channel name or creation date, with pagination for large result sets.

Request

Authorization

Add parameter in header

api-key

Example:

api-key: ********************

Query Params

Responses

🟢200Success

application/json

Body

🟠400Wrong Params - Invalid Country Code

🟠401Unauthorized - Missing Auth Token

🟠401Unauthorized - Invalid Key

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.narrativ.tech/functions/v1/youtube/channels/by-country?country_code=US&page_limit=100&page_offset&sort_by=&asc' \
--header 'api-key: <api-key>'

Response Example

200 - Success - List of channels

{
    "data": [
        {
            "id": "91",
            "name": "Ron Leuschke-Watsica",
            "handle": "aliqua anim elit quis",
            "country": "CA",
            "description": "Venia usitas vere addo voluptate cattus culpo fuga deserunt contra. Voro audacia clamo cupio reiciendis sint. Dapifer ipsum vulnus aedificium tempora torqueo barba truculenter apparatus. Torrens nihil caste via testimonium bardus utrum comitatus allatus.",
            "avatarUrl": "https://avatars.githubusercontent.com/u/47458652",
            "channelUrl": "https://beneficial-importance.name/",
            "createdAt": "2025-11-07T00:50:15.356Z",
            "defaultLanguage": null,
            "keywords": null,
            "localized": {
                "title": "who boohoo pigpen unless masquerade",
                "description": "Vulnero sum deleo denuo antiquus amiculum trepide usus triduana vindico. Patrocinor termes desidero ipsa defendo adicio arguo pauper. Calamitas tabesco aro voluptates barba adicio conqueror aptus combibo. Decimus mollitia soleo. Admiratio urbanus aequitas timidus soluta charisma. Amitto tepidus coerceo depopulo. Adeptio admiratio conturbo vulgivagus abundans nisi adulatio similique."
            }
        },
        {
            "id": "32",
            "name": "Della Hackett",
            "handle": "laboris elit eu",
            "country": "CA",
            "description": "Iusto videlicet supellex pecto. Assentator decerno amet nostrum arx sursum acerbitas paens adamo adulescens. Debeo dignissimos adsuesco casus audacia convoco. Demens velut decipio tamisium statua supellex.",
            "avatarUrl": "https://avatars.githubusercontent.com/u/93195377",
            "channelUrl": "https://pitiful-recommendation.us/",
            "createdAt": "2025-11-06T21:09:44.125Z",
            "defaultLanguage": null,
            "keywords": null,
            "localized": null
        }
    ],
    "pagination": {}
}

Get Followers Chart

Get Social Volume