Plan your next video
Search a topic, compare the videos around it, and find an angle worth covering.
Search videos, follow channel uploads, and read transcripts and comments. Choose player details or expanded video context for your tools.
PUT IT TO WORK
Three ways to use YouTube data.
Search a topic, compare the videos around it, and find an angle worth covering.
Pull comments into a research sheet. Spot the questions that keep coming up.
Use timestamped captions to build a transcript index that points readers back to the video.
YOUR FIRST REQUEST
Find videos about home espresso. Change the query to your own topic, then use the results in a research sheet or content brief.
Set SCRAPEATLAS_API_KEY in your environment.
Use the sample request as a starting point.
Send the result to your app, sheet or research tool.
# ScrapeAtlas · use your customer API key
export BASE_URL="https://api.scrapeatlas.com"
curl --get "$BASE_URL/v1/youtube/search" \
-H "x-api-key: $SCRAPEATLAS_API_KEY" \
--data-urlencode "query=home espresso" \
--data-urlencode "type=videos"const baseUrl = "https://api.scrapeatlas.com";
const url = new URL('/v1/youtube/search', baseUrl);
url.searchParams.set("query", "home espresso");
url.searchParams.set("type", "videos");
const response = await fetch(url, {
method: 'GET',
headers: {
'x-api-key': process.env.SCRAPEATLAS_API_KEY
}
});
const data = await response.json();
console.log(data);type Result = {
status: "success" | "partial" | "failed" | "challenged";
requestId: string;
[field: string]: unknown;
};
const response = await fetch(
"https://api.scrapeatlas.com/v1/youtube/search?query=home+espresso&type=videos",
{
headers: {
"x-api-key": process.env.SCRAPEATLAS_API_KEY!
}
}
);
const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
throw new Error(`YouTube request failed: ${data.requestId}`);
}
console.log(data);import requests
response = requests.get(
"https://api.scrapeatlas.com/v1/youtube/search",
headers={"x-api-key": "YOUR_API_KEY"},
params={
"query": "home espresso",
"type": "videos"
},
timeout=60,
)
data = response.json()
print(data["status"], data)package main
import (
"encoding/json"
"fmt"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/youtube/search?query=home+espresso&type=videos", nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var data map[string]interface{}
json.NewDecoder(resp.Body).Decode(&data)
fmt.Println(data["status"], data)
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
.uri(URI.create("https://api.scrapeatlas.com/v1/youtube/search?query=home+espresso&type=videos"))
.GET()
.header("x-api-key", "YOUR_API_KEY")
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}/v1/youtube/searchJSON responseUse your ScrapeAtlas API key. Replace the sample input with your own.
API DIRECTORY / 17
/v1/youtube/channelGETList a channel's videos/v1/youtube/channel-videosGETList a channel's Shorts/v1/youtube/channel/shortsGETList a channel's playlists/v1/youtube/channel/playlistsGETList a channel's live streams/v1/youtube/channel/livesGETList a channel's community posts/v1/youtube/channel/community-posts/v1/youtube/videoGETGet a video transcript/v1/youtube/video/transcriptGETInfer a video's sponsors/v1/youtube/video/sponsorsGETSearch YouTube/v1/youtube/searchGETGet search suggestions/v1/youtube/search/typeaheadGETSearch by hashtag/v1/youtube/search/hashtagGETList a video's comments/v1/youtube/video/commentsGETList a comment's replies/v1/youtube/video/comment/repliesGETList trending Shorts/v1/youtube/shorts/trendingGETGet a playlist/v1/youtube/playlistGETGet a community post/v1/youtube/community-postCreate a ScrapeAtlas API key, send it in the x-api-key header, and pass the endpoint’s request fields. The example above is ready to adapt to your own input.
Search videos, follow channel uploads, and read transcripts and comments. Choose player details or expanded video context for your tools. Each endpoint’s reference shows its response fields and a JSON example.
Yes. Connect ScrapeAtlas through MCP to use YouTube tools from your assistant. You can also call the same API from your own scripts or the CLI.
We use essential storage to keep the site working. With your permission, optional analytics cookies help us understand visits. You can change your choice anytime. Privacy policy
Google Analytics and PostHog measure visits, page engagement, signup-link clicks and website performance. Rejecting optional cookies does not affect access to the site.
Allow Affonso to record your referral visit and store a cookie for 30 days. If you sign up, we share your verified email with Affonso to attribute purchases. Privacy policy