YouTube Channel Community API
List the posts on a channel's community tab.
- 1 credit per call
- Failed calls are free
- Updated
- youtube.channel-community.list
{ "summary": { "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA", "pages": 1, "tab": "community", "total_items": 3 }, "items": [ { "content": "Some more fun wedding photos 🥰", "author": "MrBeast", "post_id": "UgkxB7POmB4C7U0I3kIEWRZpYfE2t-ieP9CA", "type": "post", "vote_count": "3.2M" }, { "content": "I found MrsBeast ❤️❤️❤️", "author": "MrBeast", "post_id": "Ugkxg-YuyvHwnlFZRktAZHHELzGBrskCHChJ", "type": "post", "vote_count": "3.1M" } ]}
| # | Content | Author | Type | Vote count | Post id |
|---|---|---|---|---|---|
| 1 | Some more fun wedding photos 🥰 | MrBeast | post | 3.2M | UgkxB7POmB4C7U0I3kIEWRZpYfE2t-ieP9CA |
| 2 | I found MrsBeast ❤️❤️❤️ | MrBeast | post | 3.1M | Ugkxg-YuyvHwnlFZRktAZHHELzGBrskCHChJ |
| 3 | World Cup was fun | MrBeast | post | 1.9M | Ugkx5QH9-Xr0EWbVJ1riARjVrDcXRN1LfJS7 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| url | string | yes | Public URL of the page to fetch. | https://www.youtube.com/@MrBeast |
| limit | integer | no | Maximum number of results to return. From 1 to 500. Default: 100. |
3 |
| max_pages | integer | no | Maximum number of result pages to fetch. From 1 to 100. Default: 5. |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].content | string | The post's text. | Some more fun wedding photos 🥰 |
| items[].author | string | The channel that posted it. | MrBeast |
| items[].post_id | string | YouTube's ID for the post. | UgkxB7POmB4C7U0I3kIEWRZpYfE2t-ieP9CA |
| items[].type | string | What kind of item it is, such as video. | post |
| items[].vote_count | string | Likes on the post, as YouTube shows them. | 3.2M |
| items | array | The channel's community posts. | 3 records |
| summary | object | Totals and paging details for this answer. | 4 fields |
| summary.channel_id | string | YouTube's ID for the channel. | UCX6OQ3DkcsbYNE6H8uQQuVA |
| summary.pages | integer | How many pages were read for this answer. | 1 |
| summary.tab | string | Which channel tab the items come from. | community |
| summary.total_items | integer | How many items this answer holds. | 3 |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "youtube.channel-community.list", "input": { "limit": 3, "url": "https://www.youtube.com/@MrBeast" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "youtube.channel-community.list", "input": { "limit": 3, "url": "https://www.youtube.com/@MrBeast" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "youtube.channel-community.list", "input": { "limit": 3, "url": "https://www.youtube.com/@MrBeast" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
With Upscrape, get the YouTube channel community for https://www.youtube.com/@MrBeast. Tell me what it costs before you run it, then show the results as a table.
More from the YouTube API
- YouTube Video API1 credit
- YouTube Channel API1 credit
- YouTube Channel Videos API1 credit
- YouTube Search API1 credit
- YouTube Comments API1 credit
- YouTube Channel Shorts API1 credit
- YouTube Channel Live Streams API1 credit
- YouTube Channel Playlists API1 credit
- YouTube Playlist API1 credit
- YouTube Community Post API1 credit
- YouTube Hashtag Videos API1 credit
- YouTube Typeahead Search API1 credit
- YouTube Trending Shorts API1 credit
YouTube Channel Community API FAQ
The short answers. The docs have the long ones.
How much does the YouTube Channel Community API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send url. The input fields below list every option with its type and limits.
Do I need a YouTube login?
No. It reads public YouTube data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds youtube.channel-community.list, checks its price and runs it with the same credits as the REST API.
Your first YouTube call is free.
Up to 100 free credits to start, no card needed.