Tutorial · Python
How to scrape YouTube search results with Python (2026)
A Python walkthrough for GET /v1/youtube/search. Copy the snippet, run it, then read the JSON.
GET /v1/youtube/search · 1 credit per successful request.
In this tutorial
You'll search YouTube for a phrase and see the video results you get back.
Example job: find YouTube videos for a phrase, then open the URLs you keep.
Step 1
Get ready
You need a Social Fetch API key and a working Python environment. New accounts include 100 free credits.
API key. Create a Social Fetch account and copy an API key. New accounts include 100 free credits.
Python setup. Python 3 with requests installed (pip install requests). Export SOCIALFETCH_API_KEY.
When you're done, SOCIALFETCH_API_KEY is set in your shell.
Step 2
Make the request
Copy the Python snippet, keep SOCIALFETCH_API_KEY in the environment, and send GET /v1/youtube/search with the x-api-key header. Example path: /v1/youtube/search?query=api+tutorial. The sample uses public values for search results.
You should see HTTP 200, then response.json() with data and meta. Call raise_for_status() before parsing.
Step 3
Read the response
A JSON body with data (the search results) and meta (creditsCharged, requestId). The sample below is illustrative; field-level docs live on the endpoint page. Credits charge on completed lookups, not transport failures.
Branch on data.lookupStatus when present, then keep meta.requestId if a row looks wrong.
Watch out
duration filters apply to videos, not Shorts. Keep type, uploadDate, duration, and sortBy stable across cursor pages. Keyword search will not substitute for /search/hashtags on tag-led campaigns.
Step 4
You finished
Same path and credits in playground, docs, and production. Pick a next action below.
FAQ
Common questions
Do I need an official YouTube developer account?
No. Social Fetch authenticates with your Social Fetch API key. You call GET /v1/youtube/search and we handle upstream access. You still need to follow each platform's terms for how you use public data.
What does the youtube search endpoint return?
A JSON envelope with data (the search results) and meta (creditsCharged, requestId). Shape details and field docs live on the endpoint page and in the OpenAPI docs.
Can I filter YouTube search by type, date, or duration?
Yes. type accepts videos, shorts, channels, or playlists. uploadDate accepts today, this_week, this_month, or this_year. duration accepts under_3_min, between_3_and_20_min, or over_20_min (for videos, not Shorts). sortBy can be relevance or popular. Keep filters stable when you paginate.
YouTube keyword search vs hashtag search?
Use this route for free-text phrases plus type/date/duration filters. Use GET /v1/youtube/search/hashtags for tag-led campaigns. They are separate operations — do not expect hashtag semantics from the keyword route.
How much does a successful request cost?
1 credit per successful request.
Is this okay for production?
Yes. Same production API as the rest of Social Fetch: typed errors, requestId on every response, and credit charges only on completed lookups (not infrastructure failures). New accounts get 100 free credits.
Any Python-specific tips for this request?
Yes. Call response.raise_for_status() before response.json(), set a timeout on requests.get, and keep response.json()["meta"]["requestId"] when a row looks wrong.
Related