Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalog, with no credit card. Nothing about it expires.

What happens when I hit the quota?

Requests return 429 with the limit, what you have used, and which window you tripped — nothing is queued, and nothing is charged. The monthly quota resets on the 1st (UTC). There is no rollover: unused requests do not carry into the next month.

Do failed requests use up my quota?

A 5xx does not. If a source breaks on our side, the request is excluded from your monthly count. A 4xx does count — a wrong parameter is still a request we answered. Per-minute throttling counts everything, so a retry loop is still throttled.

Which tier do I need?

Start on Free. Every response carries the remaining quota in its headers, and the dashboard reads the same number enforcement uses, so you will see the ceiling coming rather than discovering it.

How is Zapi different from RapidAPI or Apify?

Zapi focuses on a consistent REST contract — one API key, one response format, one error pattern for every source. No need to learn per-provider quirks like on traditional marketplaces, and no need to set up scraping workflows like on Apify.

What about the legality of accessing public data?

Zapi only accesses data that is publicly available without a login. Responsibility for how it is ultimately used stays with the developer — make sure your use case complies with the original source's ToS and the regulations in your operating region.

Is there an official SDK?

One: zpi-sdk, for TypeScript and JavaScript. It carries a typed error hierarchy, retries only what is safe to retry, submits bulk jobs, and verifies webhook signatures. Everything else is plain REST — cURL or any HTTP client works.

Can I request a source that isn't in the catalog yet?

Yes, through the community Discord, on any tier.

Why are Pro and Ultra marked Soon?

Checkout is not open yet. The limits and features listed on those tiers are already built and enforced — what is pending is billing, not the product.

Youtube Scraper

Dapatkan data profile, postingan, comment, dan lainnya dengan lengkap dan konsisten.

Endpoints: 8
Requests: 94
Updated: 3 months ago
For LLMs: llms.txt

Endpoint health9 hours ago

profilepassing, 0.4s
videospassing, 0.3s
videopassing, 1.3s
commentspassing, 1.3s
searchpassing, 0.7s

+ 3 more endpoints

8/8 passingdaily 01:00 WIB

Playground

8 endpoints

GET/v1/social-media:youtube-scraper/profile/:channel10m cache1 paramchecking key…

Parameters

Response

EXAMPLE

{
  "url": "https://www.youtube.com/@MrBeast",
  "title": "MrBeast",
  "avatar": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj",
  "banner": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w1060-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
  "handle": "@MrBeast",
  "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UCX6OQ3DkcsbYNE6H8uQQuVA",
  "country": "PT",
  "keywords": "mrbeast6000 beast mrbeast Mr.Beast mr",
  "verified": true,
  "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "vanityUrl": "http://www.youtube.com/@MrBeast",
  "familySafe": true,
  "videoCount": 982,
  "description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- Built wells in Africa\n- Built and gave away 100 houses\n- Adopted every dog in a shelter (twice)\n- Given millions to charity\n- Started my own snack company Feastables\n- Started my own software company Viewstats\n- Gave away a private island (twice)\n- Gave away 1 million meals\n- I counted to 100k\n- Ran a marathon in the world's largest shoes\n- Survived 50 hours in Antarctica\n- Recreated Squid Game in real life\n- Created the largest competition show with 1000 people (Beast Games)\n- Gave $5,000,000 to one person\n\nTerms & Conditions of Current Sweepstakes: \nhttps://mrb.gg/bow-and-arrow\nhttps://bit.ly/MrB_Birthday_YT\nhttps://bit.ly/MrB_Cash_Giveaway\n\n\n",
  "subscriberText": "489M subscribers",
  "videoCountText": "982 videos",
  "subscriberCount": 489000000
}

Code examples

Get User Profile

zpi-sdkrecommended

// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("social-media:youtube-scraper", "profile", {
  "channel": "MrBeast"
});
console.log(data);

Full SDK reference →

cURL

request.sh

curl -X GET "https://api.zpi.web.id/v1/social-media:youtube-scraper/profile/MrBeast" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

8 endpoints · plain text

GETGet User Profile/v1/social-media:youtube-scraper/profile/:channelDapatkan data profile, postingan, comment, dan lainnya dengan lengkap dan konsisten.

Parameters

channelstringrequiredin path: Channel handle (@user), channel ID (UCxxx), atau full YouTube URL

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:youtube-scraper/profile/MrBeast" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "url": "https://www.youtube.com/@MrBeast",
  "title": "MrBeast",
  "avatar": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj",
  "banner": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w1060-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
  "handle": "@MrBeast",
  "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UCX6OQ3DkcsbYNE6H8uQQuVA",
  "country": "PT",
  "keywords": "mrbeast6000 beast mrbeast Mr.Beast mr",
  "verified": true,
  "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "vanityUrl": "http://www.youtube.com/@MrBeast",
  "familySafe": true,
  "videoCount": 982,
  "description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- Built wells in Africa\n- Built and gave away 100 houses\n- Adopted every dog in a shelter (twice)\n- Given millions to charity\n- Started my own snack company Feastables\n- Started my own software company Viewstats\n- Gave away a private island (twice)\n- Gave away 1 million meals\n- I counted to 100k\n- Ran a marathon in the world's largest shoes\n- Survived 50 hours in Antarctica\n- Recreated Squid Game in real life\n- Created the largest competition show with 1000 people (Beast Games)\n- Gave $5,000,000 to one person\n\nTerms & Conditions of Current Sweepstakes: \nhttps://mrb.gg/bow-and-arrow\nhttps://bit.ly/MrB_Birthday_YT\nhttps://bit.ly/MrB_Cash_Giveaway\n\n\n",
  "subscriberText": "489M subscribers",
  "videoCountText": "982 videos",
  "subscriberCount": 489000000
}

GETGet User Videos/v1/social-media:youtube-scraper/videos/:channelDapatkan data profile, postingan, comment, dan lainnya dengan lengkap dan konsisten.

Parameters

channelstringrequiredin path: Channel handle (@user), channel ID (UCxxx), atau full YouTube URL
tabenumoptional: Tab yang di-scrape. Default 'videos'. Cursor TIDAK kompatibel antar-tab Values: videos, shorts, streams.
pagenumberoptional: Nomor halaman. Default 1, max 50. Per page ~30 video

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:youtube-scraper/videos/MrBeast?tab=&page=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "tab": "videos",
  "page": 1,
  "count": 30,
  "videos": [
    {
      "url": "https://www.youtube.com/watch?v=AaMdXZMvT3w",
      "title": "Survive 30 Days On An Island With Your Ex, Win $250,000",
      "videoId": "AaMdXZMvT3w",
      "duration": 0,
      "thumbnail": "https://i.ytimg.com/vi/AaMdXZMvT3w/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAfwDXsWdeKhhuSk9s8s1TnaZVv0Q",
      "viewCount": 65000000,
      "viewCountText": "65M views",
      "publishedTimeText": "6 days ago"
    },
    {
      "url": "https://www.youtube.com/watch?v=6Zy5VLcEbZc",
      "title": "I Stranded 100 People In The Wilderness For $250,000",
      "videoId": "6Zy5VLcEbZc",
      "duration": 0,
      "thumbnail": "https://i.ytimg.com/vi/6Zy5VLcEbZc/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDXMEvwxFyL_olBjmhazAn6BR96jw",
      "viewCount": 110000000,
      "viewCountText": "110M views",
      "publishedTimeText": "2 weeks ago"
    },
    {
      "url": "https://www.youtube.com/watch?v=zRtGL0-5rg4",
      "title": "Last To Leave Grocery Store, Wins $250,000",
      "videoId": "zRtGL0-5rg4",
      "duration": 0,
      "thumbnail": "https://i.ytimg.com/vi/zRtGL0-5rg4/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAG-ou5PizjilKG7ZXLg61ZkWF6-g",
      "viewCount": 140000000,
      "viewCountText": "140M views",
      "publishedTimeText": "1 month ago"
    }
  ],
  "channel": {
    "title": "MrBeast",
    "handle": "@MrBeast",
    "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA"
  },
  "hasMore": true,
  "nextPage": 2
}

GETGet Video Detail/v1/social-media:youtube-scraper/video/:idDapatkan data profile, postingan, comment, dan lainnya dengan lengkap dan konsisten.

Parameters

idstringoptionalin path: Video ID (11 chars) atau full YouTube URL (watch, shorts, youtu.be)
urlstringoptional: Full YouTube video URL — alias untuk id (dipakai bulk async scraping)

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:youtube-scraper/video/dQw4w9WgXcQ?url=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "tags": [],
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "isLive": false,
  "channel": {
    "name": "Rick Astley",
    "avatar": "https://yt3.ggpht.com/MOWpaiGJdgN4aKMI-NGQLL4jMVP3aDORlQpOBWooi0GSE2TGt4_9ncyepk1pCh-yWQ795AhPbw=s176-c-k-c0x00ffffff-no-rj",
    "handle": "@RickAstleyYT",
    "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "subscriberCount": 4500000,
    "subscriberCountText": "4.5M subscribers"
  },
  "videoId": "dQw4w9WgXcQ",
  "captions": [
    {
      "name": "English",
      "language": "en",
      "isAutoGenerated": false
    },
    {
      "name": "English (auto-generated)",
      "language": "en",
      "isAutoGenerated": true
    },
    {
      "name": "German (Germany)",
      "language": "de-DE",
      "isAutoGenerated": false
    }
  ],
  "category": "Music",
  "duration": 213,
  "keywords": [
    "rick astley",
    "Never Gonna Give You Up",
    "nggyu"
  ],
  "isPrivate": false,
  "likeCount": 19111621,
  "thumbnail": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/maxresdefault.webp",
  "viewCount": 1775242717,
  "hasCaption": true,
  "isUnlisted": false,
  "uploadDate": "2009-10-24T23:57:33-07:00",
  "description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy and listen to Rick’s ‘Never’ playlist ❤️ …",
  "publishDate": "2009-10-24T23:57:33-07:00",
  "allowRatings": true,
  "isFamilySafe": true,
  "likeCountText": "19M",
  "availableCountries": [
    "AD",
    "AE",
    "AF"
  ]
}

GETGet Video Comments/v1/social-media:youtube-scraper/comments/:idDapatkan data profile, postingan, comment, dan lainnya dengan lengkap dan konsisten.

Parameters

idstringrequiredin path: Video ID (11-char) atau full YouTube URL
pagenumberoptional: Nomor halaman. Default 1, max 50. Per page ~20 komentar

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:youtube-scraper/comments/dQw4w9WgXcQ?page=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "page": 1,
  "count": 20,
  "hasMore": true,
  "videoId": "dQw4w9WgXcQ",
  "comments": [
    {
      "author": {
        "avatar": "https://yt3.ggpht.com/3s6evpqAiDU9tQR4sC2siJippbH2RWVPnwHgyl4V0th2iuQz0VDQZbUhQBGmsxLYo-mjG6TqZQ=s88-c-k-c0x00ffffff-no-rj",
        "channelId": "UCBR8-60-B28hp2BmDPdntcQ",
        "isCreator": false,
        "isVerified": true,
        "displayName": "@YouTube"
      },
      "content": "can confirm: he never gave us up",
      "commentId": "Ugzge340dBgB75hWBm54AaABAg",
      "likeCount": 243000,
      "replyCount": 1000,
      "replyLevel": 0,
      "likeCountText": "243K",
      "replyCountText": "1K",
      "publishedTimeText": "1 year ago"
    },
    {
      "author": {
        "avatar": "https://yt3.ggpht.com/ytc/AIdro_l_cdb12iEvfbconWqKW89iqSh69jL-NdmjZIuXCkr9Yg3iLzKFdf8SG32lYrR3AmrM9A=s88-c-k-c0x00ffffff-no-rj",
        "channelId": "UCc4EU495shmfFPGMtoth0cQ",
        "isCreator": false,
        "isVerified": false,
        "displayName": "@Sarah-x3j3z"
      },
      "content": "🇫🇷🇫🇷🇫🇷🇫🇷🇫🇷🍾🥂🎄💕😍👍🏻👌🏻🥰🥰🥰🥳😘🇫🇷🇫🇷🇫🇷",
      "commentId": "Ugz_UZfwxElvwKkPfkl4AaABAg",
      "likeCount": 0,
      "replyCount": 0,
      "replyLevel": 0,
      "likeCountText": " ",
      "publishedTimeText": "2 minutes ago"
    },
    {
      "author": {
        "avatar": "https://yt3.ggpht.com/WG1XhzebAPM055lM0LsEgtxNxirp0UMkvCQ0Us399-evEbG-K53F8pdUxwlq9dbleDo_qEfshMM=s88-c-k-c0x00ffffff-no-rj",
        "channelId": "UC2icBtNHVnZL591ZoIpTrMQ",
        "isCreator": false,
        "isVerified": false,
        "displayName": "@Hishamisgoodturbotrubo"
      },
      "content": "Get rickrolled",
      "commentId": "UgxVqhrNBP9d4R0Zi_x4AaABAg",
      "likeCount": 0,
      "replyCount": 0,
      "replyLevel": 0,
      "likeCountText": " ",
      "publishedTimeText": "6 minutes ago"
    }
  ],
  "nextPage": 2
}

GETSearch/v1/social-media:youtube-scraper/searchCari video, channel, atau playlist di YouTube.

Parameters

querystringrequired: Search terms
typeenumoptional: Result type. Default videos — an unfiltered search mixes shelves and returns an uneven count per page Values: videos, channels, playlists.
sortenumoptional: Ordering. Default relevance Values: relevance, viewCount.
glstringoptional: Two-letter country code. Changes ranking and locale text
hlstringoptional: Interface language code
pagenumberoptional: Page number. Default 1 — each page past the first costs one extra upstream round

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:youtube-scraper/search?query=lofi+hip+hop&type=videos&sort=relevance&gl=ID&hl=id&page=1" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "page": 1,
  "sort": "relevance",
  "type": "videos",
  "count": 20,
  "items": [
    {
      "url": "https://www.youtube.com/watch?v=n61ULEU7CO0",
      "title": "Best of lofi hip hop 2021 ✨ [beats to relax/study to]",
      "isLive": false,
      "channel": {
        "name": "Lofi Girl",
        "channelId": "UCSJ4gkVC6NrvII8umztf0Ow"
      },
      "videoId": "n61ULEU7CO0",
      "duration": 22258,
      "thumbnail": "https://i.ytimg.com/vi/n61ULEU7CO0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAi4TCpAtbxLFIBULRlcZHudl1uFw",
      "viewCount": 56337339,
      "description": "Listen on Spotify, Apple music and more → https://fanlink.tv/BestofLofi2021 The new Lofi Girl compilation “Best of 2021” is out now ...",
      "durationText": "6:10:58",
      "viewCountText": "56,337,339 views",
      "publishedTimeText": "4 years ago"
    },
    {
      "url": "https://www.youtube.com/watch?v=X4VbdwhkE10",
      "title": "lofi hip hop radio 📚 beats to relax/study to",
      "isLive": true,
      "channel": {
        "name": "Lofi Girl",
        "channelId": "UCSJ4gkVC6NrvII8umztf0Ow"
      },
      "videoId": "X4VbdwhkE10",
      "thumbnail": "https://i.ytimg.com/vi/X4VbdwhkE10/hq720.jpg?v=6a212016&sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAgn4FKbiWr9gXiEhIf0t5Y6y9TuQ",
      "viewCount": 12776,
      "description": "Listen on Spotify, Apple music and more → https://lnk.to/lofi-hiphop-beats-to-relax-study-to02 | Lofi Girl on all social media ...",
      "viewCountText": "12,776 watching"
    },
    {
      "url": "https://www.youtube.com/watch?v=CLeZyIID9Bo",
      "title": "Chill Lofi Mix [chill lo-fi hip hop beats]",
      "isLive": false,
      "channel": {
        "name": "Settle",
        "channelId": "UCkKT4qf-TcPFOmpqhTawrGA"
      },
      "videoId": "CLeZyIID9Bo",
      "duration": 6292,
      "thumbnail": "https://i.ytimg.com/vi/CLeZyIID9Bo/hq720.jpg?sqp=-oaymwE2CNAFEJQDSFXyq4qpAygIARUAAIhCGAFwAcABBvABAfgB_gmAAtAFigIMCAAQARhDIGQoZTAP&rs=AOn4CLCljfsoUy4QvdaH9IydXKSjwkcbgg",
      "viewCount": 34051654,
      "description": "YouTube Playlists: http://listen.settle.fm/youtube Listen on Spotify, Apple Music & more: https://listen.settle.fm/playlists Tracklist ...",
      "durationText": "1:44:52",
      "viewCountText": "34,051,654 views",
      "publishedTimeText": "3 years ago"
    }
  ],
  "query": "lofi hip hop",
  "total": 9365428,
  "hasMore": true,
  "nextPage": 2
}

GETGet Playlist/v1/social-media:youtube-scraper/playlist/:playlistIdIsi sebuah playlist YouTube.

Parameters

playlistIdstringrequiredin path: Playlist ID, or a full YouTube playlist URL
pagenumberoptional: Page number. Default 1, 100 videos per page. Upstream stops offering a cursor after ~2 pages, so deeper pages come back empty
glstringoptional: Two-letter country code
hlstringoptional: Interface language code

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:youtube-scraper/playlist/PL590L5WQmH8dpP0RyH5pCfIaDEdt9nk7r?page=1&gl=US&hl=en" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "page": 1,
  "count": 10,
  "videos": [
    {
      "url": "https://www.youtube.com/watch?v=DcKEPl-MpLA",
      "title": "How Google Search continues to improve results",
      "channel": "Google",
      "videoId": "DcKEPl-MpLA",
      "duration": 236,
      "thumbnail": "https://i.ytimg.com/vi/DcKEPl-MpLA/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDHfSGJ1-2RQ0-n9ok-cve-4i_AIw",
      "durationText": "3:56",
      "viewCountText": "274K views",
      "publishedTimeText": "5 years ago"
    },
    {
      "url": "https://www.youtube.com/watch?v=0eKVizvYSUQ",
      "title": "How Google Search Works (in 5 minutes)",
      "channel": "Google",
      "videoId": "0eKVizvYSUQ",
      "duration": 316,
      "thumbnail": "https://i.ytimg.com/vi/0eKVizvYSUQ/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDsjWS28Il8orntjudOP2IpTr7YYg",
      "durationText": "5:16",
      "viewCountText": "20M views",
      "publishedTimeText": "6 years ago"
    },
    {
      "url": "https://www.youtube.com/watch?v=WbSouimbtjU",
      "title": "How real people make Google Search better",
      "channel": "Google",
      "videoId": "WbSouimbtjU",
      "duration": 124,
      "thumbnail": "https://i.ytimg.com/vi/WbSouimbtjU/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAGcwbVKoZhzUsbmjqno98lkW_O-w",
      "durationText": "2:04",
      "viewCountText": "239K views",
      "publishedTimeText": "5 years ago"
    }
  ],
  "hasMore": true,
  "nextPage": 2,
  "playlist": {
    "url": "https://www.youtube.com/playlist?list=PL590L5WQmH8dpP0RyH5pCfIaDEdt9nk7r",
    "title": "How Search Works",
    "playlistId": "PL590L5WQmH8dpP0RyH5pCfIaDEdt9nk7r",
    "viewCountText": "162,752 views",
    "videoCountText": "10 videos"
  }
}

GETSearch Within Channel/v1/social-media:youtube-scraper/channel-search/:channelCari video di dalam satu channel YouTube.

Parameters

channelstringrequiredin path: Channel handle (@user), channel ID (UCxxx), or a full YouTube URL
querystringrequired: Search terms within that channel
glstringoptional: Two-letter country code
hlstringoptional: Interface language code

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:youtube-scraper/channel-search/MrBeast?query=chocolate&gl=US&hl=en" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 0,
  "query": "chocolate",
  "videos": [],
  "channel": "UCX6OQ3DkcsbYNE6H8uQQuVA"
}

GETGet Music Charts/v1/social-media:youtube-scraper/music-chartsPapan chart musik YouTube untuk negara tempat server berada. Pakai playlistId-nya di endpoint playlist buat baca lagunya.

Parameters

This endpoint takes no parameters.

Request

curl -X GET "https://api.zpi.web.id/v1/social-media:youtube-scraper/music-charts" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "charts": [
    {
      "url": "https://music.youtube.com/playlist?list=OLAK5uy_n7Ig_LAUbKE6_ZeQ1pwHmJcEhwX7BekBo",
      "title": "Trending 20 Indonesia",
      "subtitle": "Chart • YouTube Music",
      "thumbnail": "https://yt3.googleusercontent.com/BhSX1G3hoGzpiuZlyfGJ_JmzSv1nyOG2C_uw9n_IUid-jiNDvf_UvYVVPSpZ3GwAewiDnEpf1VU=s576",
      "playlistId": "OLAK5uy_n7Ig_LAUbKE6_ZeQ1pwHmJcEhwX7BekBo"
    },
    {
      "url": "https://music.youtube.com/playlist?list=PL4fGSI1pDJn4lW6MJA2q37CfnraqAizqE",
      "title": "Daily Top Music Videos - Indonesia",
      "subtitle": "Chart • YouTube Music",
      "thumbnail": "https://yt3.googleusercontent.com/K4qIvSWDZp1EFDoXTdfZUduvWKrVXL4LBq-ldC_JaTNd0gKbj9i9RTcyU40sU3aK159HfFlDxGcp=s576",
      "playlistId": "PL4fGSI1pDJn4lW6MJA2q37CfnraqAizqE"
    },
    {
      "url": "https://music.youtube.com/playlist?list=PL4fGSI1pDJn5QPpj0R4vVgRWk8sSq549G",
      "title": "Top 100 Music Videos Indonesia",
      "subtitle": "Chart • YouTube Music",
      "thumbnail": "https://yt3.googleusercontent.com/TfXZERTeKShtvTyI59SVIl3BEJvSbwdU5c_phyqKULSDMvTT-gXdfzBfcNRoRVZWFM9nTPX2eQ=s576",
      "playlistId": "PL4fGSI1pDJn5QPpj0R4vVgRWk8sSq549G"
    }
  ],
  "country": "Indonesia",
  "chartCount": 3
}

{ "url": "https://www.youtube.com/@MrBeast", "title": "MrBeast", "avatar": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj", "banner": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w1060-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj", "handle": "@MrBeast", "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UCX6OQ3DkcsbYNE6H8uQQuVA", "country": "PT", "keywords": "mrbeast6000 beast mrbeast Mr.Beast mr", "verified": true, "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA", "vanityUrl": "http://www.youtube.com/@MrBeast", "familySafe": true, "videoCount": 982, "description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- Built wells in Africa\n- Built and gave away 100 houses\n- Adopted every dog in a shelter (twice)\n- Given millions to charity\n- Started my own snack company Feastables\n- Started my own software company Viewstats\n- Gave away a private island (twice)\n- Gave away 1 million meals\n- I counted to 100k\n- Ran a marathon in the world's largest shoes\n- Survived 50 hours in Antarctica\n- Recreated Squid Game in real life\n- Created the largest competition show with 1000 people (Beast Games)\n- Gave $5,000,000 to one person\n\nTerms & Conditions of Current Sweepstakes: \nhttps://mrb.gg/bow-and-arrow\nhttps://bit.ly/MrB_Birthday_YT\nhttps://bit.ly/MrB_Cash_Giveaway\n\n\n", "subscriberText": "489M subscribers", "videoCountText": "982 videos", "subscriberCount": 489000000 }

// npm i zpi-sdk import { ZpiClient } from "zpi-sdk"; const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" }); const data = await client.run("social-media:youtube-scraper", "profile", { "channel": "MrBeast" }); console.log(data);

{ "tab": "videos", "page": 1, "count": 30, "videos": [ { "url": "https://www.youtube.com/watch?v=AaMdXZMvT3w", "title": "Survive 30 Days On An Island With Your Ex, Win $250,000", "videoId": "AaMdXZMvT3w", "duration": 0, "thumbnail": "https://i.ytimg.com/vi/AaMdXZMvT3w/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAfwDXsWdeKhhuSk9s8s1TnaZVv0Q", "viewCount": 65000000, "viewCountText": "65M views", "publishedTimeText": "6 days ago" }, { "url": "https://www.youtube.com/watch?v=6Zy5VLcEbZc", "title": "I Stranded 100 People In The Wilderness For $250,000", "videoId": "6Zy5VLcEbZc", "duration": 0, "thumbnail": "https://i.ytimg.com/vi/6Zy5VLcEbZc/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDXMEvwxFyL_olBjmhazAn6BR96jw", "viewCount": 110000000, "viewCountText": "110M views", "publishedTimeText": "2 weeks ago" }, { "url": "https://www.youtube.com/watch?v=zRtGL0-5rg4", "title": "Last To Leave Grocery Store, Wins $250,000", "videoId": "zRtGL0-5rg4", "duration": 0, "thumbnail": "https://i.ytimg.com/vi/zRtGL0-5rg4/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAG-ou5PizjilKG7ZXLg61ZkWF6-g", "viewCount": 140000000, "viewCountText": "140M views", "publishedTimeText": "1 month ago" } ], "channel": { "title": "MrBeast", "handle": "@MrBeast", "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA" }, "hasMore": true, "nextPage": 2 }

{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "tags": [], "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)", "isLive": false, "channel": { "name": "Rick Astley", "avatar": "https://yt3.ggpht.com/MOWpaiGJdgN4aKMI-NGQLL4jMVP3aDORlQpOBWooi0GSE2TGt4_9ncyepk1pCh-yWQ795AhPbw=s176-c-k-c0x00ffffff-no-rj", "handle": "@RickAstleyYT", "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw", "subscriberCount": 4500000, "subscriberCountText": "4.5M subscribers" }, "videoId": "dQw4w9WgXcQ", "captions": [ { "name": "English", "language": "en", "isAutoGenerated": false }, { "name": "English (auto-generated)", "language": "en", "isAutoGenerated": true }, { "name": "German (Germany)", "language": "de-DE", "isAutoGenerated": false } ], "category": "Music", "duration": 213, "keywords": [ "rick astley", "Never Gonna Give You Up", "nggyu" ], "isPrivate": false, "likeCount": 19111621, "thumbnail": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/maxresdefault.webp", "viewCount": 1775242717, "hasCaption": true, "isUnlisted": false, "uploadDate": "2009-10-24T23:57:33-07:00", "description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy and listen to Rick’s ‘Never’ playlist ❤️ …", "publishDate": "2009-10-24T23:57:33-07:00", "allowRatings": true, "isFamilySafe": true, "likeCountText": "19M", "availableCountries": [ "AD", "AE", "AF" ] }

{ "page": 1, "count": 20, "hasMore": true, "videoId": "dQw4w9WgXcQ", "comments": [ { "author": { "avatar": "https://yt3.ggpht.com/3s6evpqAiDU9tQR4sC2siJippbH2RWVPnwHgyl4V0th2iuQz0VDQZbUhQBGmsxLYo-mjG6TqZQ=s88-c-k-c0x00ffffff-no-rj", "channelId": "UCBR8-60-B28hp2BmDPdntcQ", "isCreator": false, "isVerified": true, "displayName": "@YouTube" }, "content": "can confirm: he never gave us up", "commentId": "Ugzge340dBgB75hWBm54AaABAg", "likeCount": 243000, "replyCount": 1000, "replyLevel": 0, "likeCountText": "243K", "replyCountText": "1K", "publishedTimeText": "1 year ago" }, { "author": { "avatar": "https://yt3.ggpht.com/ytc/AIdro_l_cdb12iEvfbconWqKW89iqSh69jL-NdmjZIuXCkr9Yg3iLzKFdf8SG32lYrR3AmrM9A=s88-c-k-c0x00ffffff-no-rj", "channelId": "UCc4EU495shmfFPGMtoth0cQ", "isCreator": false, "isVerified": false, "displayName": "@Sarah-x3j3z" }, "content": "🇫🇷🇫🇷🇫🇷🇫🇷🇫🇷🍾🥂🎄💕😍👍🏻👌🏻🥰🥰🥰🥳😘🇫🇷🇫🇷🇫🇷", "commentId": "Ugz_UZfwxElvwKkPfkl4AaABAg", "likeCount": 0, "replyCount": 0, "replyLevel": 0, "likeCountText": " ", "publishedTimeText": "2 minutes ago" }, { "author": { "avatar": "https://yt3.ggpht.com/WG1XhzebAPM055lM0LsEgtxNxirp0UMkvCQ0Us399-evEbG-K53F8pdUxwlq9dbleDo_qEfshMM=s88-c-k-c0x00ffffff-no-rj", "channelId": "UC2icBtNHVnZL591ZoIpTrMQ", "isCreator": false, "isVerified": false, "displayName": "@Hishamisgoodturbotrubo" }, "content": "Get rickrolled", "commentId": "UgxVqhrNBP9d4R0Zi_x4AaABAg", "likeCount": 0, "replyCount": 0, "replyLevel": 0, "likeCountText": " ", "publishedTimeText": "6 minutes ago" } ], "nextPage": 2 }

{ "page": 1, "sort": "relevance", "type": "videos", "count": 20, "items": [ { "url": "https://www.youtube.com/watch?v=n61ULEU7CO0", "title": "Best of lofi hip hop 2021 ✨ [beats to relax/study to]", "isLive": false, "channel": { "name": "Lofi Girl", "channelId": "UCSJ4gkVC6NrvII8umztf0Ow" }, "videoId": "n61ULEU7CO0", "duration": 22258, "thumbnail": "https://i.ytimg.com/vi/n61ULEU7CO0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAi4TCpAtbxLFIBULRlcZHudl1uFw", "viewCount": 56337339, "description": "Listen on Spotify, Apple music and more → https://fanlink.tv/BestofLofi2021 The new Lofi Girl compilation “Best of 2021” is out now ...", "durationText": "6:10:58", "viewCountText": "56,337,339 views", "publishedTimeText": "4 years ago" }, { "url": "https://www.youtube.com/watch?v=X4VbdwhkE10", "title": "lofi hip hop radio 📚 beats to relax/study to", "isLive": true, "channel": { "name": "Lofi Girl", "channelId": "UCSJ4gkVC6NrvII8umztf0Ow" }, "videoId": "X4VbdwhkE10", "thumbnail": "https://i.ytimg.com/vi/X4VbdwhkE10/hq720.jpg?v=6a212016&sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAgn4FKbiWr9gXiEhIf0t5Y6y9TuQ", "viewCount": 12776, "description": "Listen on Spotify, Apple music and more → https://lnk.to/lofi-hiphop-beats-to-relax-study-to02 | Lofi Girl on all social media ...", "viewCountText": "12,776 watching" }, { "url": "https://www.youtube.com/watch?v=CLeZyIID9Bo", "title": "Chill Lofi Mix [chill lo-fi hip hop beats]", "isLive": false, "channel": { "name": "Settle", "channelId": "UCkKT4qf-TcPFOmpqhTawrGA" }, "videoId": "CLeZyIID9Bo", "duration": 6292, "thumbnail": "https://i.ytimg.com/vi/CLeZyIID9Bo/hq720.jpg?sqp=-oaymwE2CNAFEJQDSFXyq4qpAygIARUAAIhCGAFwAcABBvABAfgB_gmAAtAFigIMCAAQARhDIGQoZTAP&rs=AOn4CLCljfsoUy4QvdaH9IydXKSjwkcbgg", "viewCount": 34051654, "description": "YouTube Playlists: http://listen.settle.fm/youtube Listen on Spotify, Apple Music & more: https://listen.settle.fm/playlists Tracklist ...", "durationText": "1:44:52", "viewCountText": "34,051,654 views", "publishedTimeText": "3 years ago" } ], "query": "lofi hip hop", "total": 9365428, "hasMore": true, "nextPage": 2 }

{ "page": 1, "count": 10, "videos": [ { "url": "https://www.youtube.com/watch?v=DcKEPl-MpLA", "title": "How Google Search continues to improve results", "channel": "Google", "videoId": "DcKEPl-MpLA", "duration": 236, "thumbnail": "https://i.ytimg.com/vi/DcKEPl-MpLA/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDHfSGJ1-2RQ0-n9ok-cve-4i_AIw", "durationText": "3:56", "viewCountText": "274K views", "publishedTimeText": "5 years ago" }, { "url": "https://www.youtube.com/watch?v=0eKVizvYSUQ", "title": "How Google Search Works (in 5 minutes)", "channel": "Google", "videoId": "0eKVizvYSUQ", "duration": 316, "thumbnail": "https://i.ytimg.com/vi/0eKVizvYSUQ/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDsjWS28Il8orntjudOP2IpTr7YYg", "durationText": "5:16", "viewCountText": "20M views", "publishedTimeText": "6 years ago" }, { "url": "https://www.youtube.com/watch?v=WbSouimbtjU", "title": "How real people make Google Search better", "channel": "Google", "videoId": "WbSouimbtjU", "duration": 124, "thumbnail": "https://i.ytimg.com/vi/WbSouimbtjU/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAGcwbVKoZhzUsbmjqno98lkW_O-w", "durationText": "2:04", "viewCountText": "239K views", "publishedTimeText": "5 years ago" } ], "hasMore": true, "nextPage": 2, "playlist": { "url": "https://www.youtube.com/playlist?list=PL590L5WQmH8dpP0RyH5pCfIaDEdt9nk7r", "title": "How Search Works", "playlistId": "PL590L5WQmH8dpP0RyH5pCfIaDEdt9nk7r", "viewCountText": "162,752 views", "videoCountText": "10 videos" } }

{ "charts": [ { "url": "https://music.youtube.com/playlist?list=OLAK5uy_n7Ig_LAUbKE6_ZeQ1pwHmJcEhwX7BekBo", "title": "Trending 20 Indonesia", "subtitle": "Chart • YouTube Music", "thumbnail": "https://yt3.googleusercontent.com/BhSX1G3hoGzpiuZlyfGJ_JmzSv1nyOG2C_uw9n_IUid-jiNDvf_UvYVVPSpZ3GwAewiDnEpf1VU=s576", "playlistId": "OLAK5uy_n7Ig_LAUbKE6_ZeQ1pwHmJcEhwX7BekBo" }, { "url": "https://music.youtube.com/playlist?list=PL4fGSI1pDJn4lW6MJA2q37CfnraqAizqE", "title": "Daily Top Music Videos - Indonesia", "subtitle": "Chart • YouTube Music", "thumbnail": "https://yt3.googleusercontent.com/K4qIvSWDZp1EFDoXTdfZUduvWKrVXL4LBq-ldC_JaTNd0gKbj9i9RTcyU40sU3aK159HfFlDxGcp=s576", "playlistId": "PL4fGSI1pDJn4lW6MJA2q37CfnraqAizqE" }, { "url": "https://music.youtube.com/playlist?list=PL4fGSI1pDJn5QPpj0R4vVgRWk8sSq549G", "title": "Top 100 Music Videos Indonesia", "subtitle": "Chart • YouTube Music", "thumbnail": "https://yt3.googleusercontent.com/TfXZERTeKShtvTyI59SVIl3BEJvSbwdU5c_phyqKULSDMvTT-gXdfzBfcNRoRVZWFM9nTPX2eQ=s576", "playlistId": "PL4fGSI1pDJn5QPpj0R4vVgRWk8sSq549G" } ], "country": "Indonesia", "chartCount": 3 }

Playground

Code examples

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

TikTok Scraper

Instagram Scraper

GitHub User

Kaskus

Telegram Channel

NGL Send

Playground

Code examples

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

TikTok Scraper

Instagram Scraper

GitHub User

Kaskus

Telegram Channel

NGL Send