YouTube API · Endpoint
YouTube Hashtag Videos API
List the videos YouTube shows on a hashtag's page.
- 1 credit per call
- Failed calls are free
- Updated
- youtube.hashtag.list
Response
completed
{ "summary": { "has_more": false, "hashtag": "mrbeast", "pages": 1, "total_items": 1 }, "items": [ { "title": "Ages 1 - 100 Fight For $500,000", "views": "165M views", "type": "video", "video_id": "Tn6-PIqcHd4" } ]}
summary.has_morebooleanfalse
summary.hashtagstringmrbeast
summary.pagesinteger1
summary.total_itemsinteger1
Input
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 | Hashtag hub URL or bare tag | https://www.youtube.com/hashtag/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. |
Response
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].title | string | The video's title. | Ages 1 - 100 Fight For $500,000 |
| items[].views | string | Views as YouTube writes them. | 165M views |
| items[].type | string | What kind of item it is, such as video. | video |
| items[].video_id | string | YouTube's ID for the video. | Tn6-PIqcHd4 |
| items | array | Videos with the hashtag. | 1 records |
| summary | object | Totals and paging details for this answer. | 4 fields |
| summary.has_more | boolean | Whether more items are available. | false |
| summary.hashtag | string | The hashtag searched. | mrbeast |
| summary.pages | integer | How many pages were read for this answer. | 1 |
| summary.total_items | integer | How many items this answer holds. | 1 |
REST API · MCP server
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.hashtag.list", "input": { "limit": 3, "url": "https://www.youtube.com/hashtag/mrbeast" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "youtube.hashtag.list", "input": { "limit": 3, "url": "https://www.youtube.com/hashtag/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.hashtag.list", "input": { "limit": 3, "url": "https://www.youtube.com/hashtag/mrbeast" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
In your AI agent
Claude · Cursor · any MCP client
1Add the Upscrape MCP server
2Ask for the data in plain words
The agent finds the endpoint, shows you the price, and runs it with your credits.
https://data.upscrape.com/mcp
With Upscrape, get the YouTube hashtag videos for https://www.youtube.com/hashtag/mrbeast. Tell me what it costs before you run it, then show the results as a table.
YouTube
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 Channel Community API1 credit
- YouTube Community Post API1 credit
- YouTube Typeahead Search API1 credit
- YouTube Trending Shorts API1 credit
Same data, other platforms
The same data from other platforms
InstagramHashtag keyword search
Questions
YouTube Hashtag Videos API FAQ
The short answers. The docs have the long ones.
Still have a question?
Talk to the people who build the endpoints.
How much does the YouTube Hashtag Videos 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.hashtag.list, checks its price and runs it with the same credits as the REST API.
Get started
Your first YouTube call is free.
Up to 100 free credits to start, no card needed.