Make a request
Send the page’s URL to scrape with ajson format that names one parser. Get an API key in the Quickstart.
curl -X POST https://api.stophy.dev/v1/scrape \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","formats":[{"type":"json","parser":"youtube-transcript"}]}'
const response = await fetch("https://api.stophy.dev/v1/scrape", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.STOPHY_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
formats: [{ type: "json", parser: "youtube-transcript" }],
}),
});
console.log(await response.json());
import os
import requests
response = requests.post(
"https://api.stophy.dev/v1/scrape",
headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
json={
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"formats": [{"type": "json", "parser": "youtube-transcript"}],
},
)
print(response.json())
Read the response
The parser’s data is indata.json. The URL must be the kind of page the parser reads, or the call fails with invalidRequest. This real response is cut to the first items.
{
"success": true,
"data": {
"json": {
"videoId": "dQw4w9WgXcQ",
"videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"language": "en",
"isAutoGenerated": false,
"durationSeconds": 213,
"text": "[♪♪♪] ♪ We're no strangers to love ♪ ♪ You know the rules and so do I ♪ ♪ A full commitment's what I'm thinking of ♪ ♪…"
},
"metadata": {
"sourceURL": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"statusCode": 200,
"contentType": "application/json",
"cacheState": "hit",
"cachedAt": "2026-11-13T18:00:17.852Z",
"scrapeId": "1f9bf570-b032-4f11-99f3-552b8c934ce1",
"creditsUsed": 1,
"costUsd": 0.001
}
},
"id": "1f9bf570-b032-4f11-99f3-552b8c934ce1",
"costUsd": 0.001,
"creditsUsed": 1,
"requestId": "1f9bf570-b032-4f11-99f3-552b8c934ce1"
}
Options
Each parser has its own options. Send them in theoptions object of the format, like {"type": "json", "parser": "youtube-transcript", "options": {"language": "en"}}. A parser’s page lists the options it takes. Some parsers read more than one kind of page and list each as a view. Set options.view to pick one where the page says so. To read the next page of results, send the cursor from the response as the cursor option.
Choose a parser
Search and the web
| Parser | Reads | Price |
|---|---|---|
| Google Patents | A Google Patents search page with q, inventor or assignee. | $1 per 1,000 calls. |
| Google Trends | A Google Trends explore page with search terms in q, or the trending now page. | $1 per 1,000 calls. |
| Emails | Any public web page. | $1 per 1,000 calls. |
| Phone numbers | Any public web page. | $1 per 1,000 calls. |
Video
| Parser | Reads | Price |
|---|---|---|
| YouTube search | A YouTube search results page with the search in search_query. | $1 per 1,000 calls. |
| YouTube video | A YouTube video link: watch, youtu.be, shorts or live. | $1 per 1,000 calls. |
| YouTube transcript | A YouTube video link: watch, youtu.be, shorts or live. | $1 per 1,000 calls. |
| YouTube comments | A YouTube video link: watch, youtu.be, shorts or live. | $1 per 1,000 calls. |
| YouTube channel | A YouTube channel link: @handle, /channel/, /c/ or /user/, with an optional tab. | $1 per 1,000 calls. |
| YouTube post | A YouTube community post link: /post/Ugkx… or a community page with ?lb=. | $1 per 1,000 calls. |
| YouTube playlist | A YouTube playlist page with list in the link. | $1 per 1,000 calls. |
| TikTok video | A TikTok video page or share link. | $1 per 1,000 calls. |
| TikTok comments | A TikTok video page or share link. | $1 per 1,000 calls. |
| TikTok transcript | A TikTok video page or share link. | $1 per 1,000 videos that have captions; otherwise $4 per 1,000 videos plus $0.72 per hour of audio, up to 3 minutes. |
| TikTok profile | A TikTok profile page. | $1 per 1,000 calls. |
| TikTok hashtag | A TikTok hashtag page. | $1 per 1,000 calls. |
| TikTok sound | A TikTok sound page that ends in the sound id. | $1 per 1,000 calls. |
| TikTok search | A TikTok user search page (/search/user) or video search page (/search) with a q query. | $1 per 1,000 calls. |
| TikTok followers | A TikTok profile page. | $1 per 1,000 calls. |
| TikTok following | A TikTok profile page. | $1 per 1,000 calls. |
| TikTok trending | TikTok’s Explore page, with an optional region in the link, such as region=DE, for another country’s feed. | $0.001 per 10 videos. |
| TikTok live | A TikTok account’s live page. | $1 per 1,000 calls. |
| Instagram transcript | An Instagram reel or video post. | $2 per 1,000 videos plus $0.24 per hour of audio, up to 5 minutes. |
Social
| Parser | Reads | Price |
|---|---|---|
| Reddit search | A Reddit search page with a q query, on reddit.com/search or inside a subreddit. | $1 per 1,000 calls. |
| Reddit post | A Reddit post page or a redd.it short link. | $0.005 per 1,000 comments, charged for each 200. |
| Reddit subreddit | A subreddit page, like reddit.com/r/programming/ or reddit.com/r/programming/top/?t=week. | $1 per 1,000 calls. |
| Reddit user | A Reddit user page, like reddit.com/user/spez or reddit.com/user/spez/comments. | $1 per 1,000 calls. |
| Reddit subreddits | The Reddit list of popular subreddits, reddit.com/subreddits. | $1 per 1,000 calls. |
| Instagram post | An Instagram post, reel or share link. | $1 per 1,000 calls. |
| Instagram profile | An Instagram profile page, like instagram.com/natgeo. | $1 per 1,000 calls. |
| Instagram comments | An Instagram post, reel or share link. | $1 per 1,000 calls. |
| Instagram feed | An Instagram hashtag, location or keyword search page, like instagram.com/explore/tags/travel. | $1 per 1,000 calls. |
| X profile | An X profile page, like x.com/nasa. | $1 per 1,000 calls. |
| X post | An X post page, like x.com/nasa/status/<id>. | $1 per 1,000 calls. |
| Threads profile | A Threads profile page, like threads.com/@nasa. | $1 per 1,000 calls. |
| Threads post | A Threads post page, like threads.com/@nasa/post/<code>. | $1 per 1,000 calls. |
| Pinterest search | A Pinterest pin or video search page with a q query, like pinterest.com/search/pins/?q=kitchen. | $1 per 1,000 calls. |
| Pinterest pin | A Pinterest pin page or a pin.it short link. | $1 per 1,000 calls. |
| Pinterest board | A Pinterest board page, like pinterest.com/<user>/<board>/. | $1 per 1,000 calls. |
| Pinterest profile | A Pinterest profile page, like pinterest.com/marthastewart/. | $1 per 1,000 calls. |
| Facebook page | A Facebook page, like facebook.com/NASA. | $1 per 1,000 calls. |
| Facebook post | A Facebook post, reel or video page, or an fb.watch link. | $1 per 1,000 calls. |
| Facebook comments | A Facebook post, reel or video page, or an fb.watch link. | $1 per 1,000 calls. |
| LinkedIn company | A LinkedIn company page. | $1 per 1,000 calls. |
| LinkedIn profile | A LinkedIn profile page. | $1 per 1,000 calls. |
| LinkedIn posts | A LinkedIn profile or company page. | $1 per 1,000 calls. |
| Bsky profile | A Bluesky profile page, like bsky.app/profile/bsky.app. | $1 per 1,000 calls. |
| Bsky post | A Bluesky post page, like bsky.app/profile/bsky.app/post/3n27yge3hys24. | $1 per 1,000 calls. |
| Link in bio | A Linktree, Komi, Linkbio or Linkme page, like linktr.ee/name, name.komi.io, linkbio.co/name, linkme.bio/name or link.me/name. | $1 per 1,000 calls. |
Places and travel
| Parser | Reads | Price |
|---|---|---|
| Google Maps | A Google Maps search page that names a place after in, near or around. | $1 per 1,000 calls. |
| Google Maps place | A Google Maps place page. | $1 per 1,000 calls. |
| Google Maps reviews | A Google Maps place page. | $0.001 per 10 reviews. |
| Google Flights | A Google Flights search page, from the address bar or with a q of IATA airport codes and a date, like Flights to JFK from LHR on 2026-12-15. | $1 per 1,000 calls. |
| Google Hotels | A Google Hotels page with a place in q, like hotels in Lisbon. | $1 per 1,000 calls. |
| Tripadvisor search | A Tripadvisor search page, like tripadvisor.com/Search?q=ritz+london. | $1 per 1,000 calls. |
| Tripadvisor place | A Tripadvisor hotel, restaurant or attraction page. | $1 per 1,000 calls. |
| Tripadvisor reviews | A Tripadvisor hotel, restaurant or attraction page. | $1 per 1,000 calls. |
| Yelp search | A Yelp search page with both what and where, like yelp.com/search?find_desc=pizza&find_loc=Austin%2C+TX. | $1 per 1,000 calls. |
| Yelp business | A Yelp business page, like yelp.com/biz/franklin-barbecue-austin. | $1 per 1,000 calls. |
| Yelp reviews | A Yelp business page, like yelp.com/biz/franklin-barbecue-austin. | $1 per 1,000 calls. |
| Booking.com search | A Booking.com search results page with a place in ss, like booking.com/searchresults.html?ss=Lisbon. | $1 per 1,000 calls. |
| Booking.com hotel | A Booking.com hotel page, like booking.com/hotel/pt/hf-fenix-urban.html. | $1 per 1,000 calls. |
| Booking.com reviews | A Booking.com hotel page, like booking.com/hotel/pt/hf-fenix-urban.html. | $1 per 1,000 calls. |
| Expedia Hotels | An Expedia hotel search page with a destination, like expedia.com/Hotel-Search?destination=Paris. | $1 per 1,000 calls. |
| Airbnb search | An Airbnb search page for a place with checkin and checkout dates, like airbnb.com/s/Lisbon—Portugal/homes?checkin=2026-12-10&checkout=2026-12-12. | $1 per 1,000 calls. |
| Airbnb listing | An Airbnb listing page, like airbnb.com/rooms/18249319. | $1 per 1,000 calls. |
| Airbnb reviews | An Airbnb listing page, like airbnb.com/rooms/18249319. | $1 per 1,000 calls. |
| Luma events | A Luma city page, like luma.com/sf or lu.ma/london. | $1 per 1,000 calls. |
| Luma event | A Luma event page, like luma.com/nighthack. | $1 per 1,000 calls. |
Jobs
| Parser | Reads | Price |
|---|---|---|
| LinkedIn jobs | A LinkedIn jobs search page with keywords, a location or a company filter. | $1 per 1,000 calls. |
| LinkedIn job | A LinkedIn job page or lnkd.in share link. | $1 per 1,000 calls. |
| Indeed search | An Indeed job search page with a search q or a place l, like indeed.com/jobs?q=nurse&l=Austin,+TX. | $1 per 1,000 calls. |
| Indeed job | An Indeed job page with a jk key, like indeed.com/viewjob?jk=17c2d37519bd8374. | $1 per 1,000 calls. |
| Upwork search | An Upwork job search page, like upwork.com/nx/search/jobs/?q=react. | $1 per 1,000 calls. |
| Upwork job | An Upwork job page, like upwork.com/jobs/~02.. | $1 per 1,000 calls. |
| Careers jobs | A company job board on Greenhouse, Lever, Ashby, Workday, Workable or SmartRecruiters, like boards.greenhouse.io/figma. | $1 per 1,000 calls. |
| Careers job | One job on a company job board, like boards.greenhouse.io/figma/jobs/5426468004. | $1 per 1,000 calls. |
| Glassdoor company | A Glassdoor company page (overview, reviews or salaries). | $1 per 1,000 calls. |
| Glassdoor reviews | A Glassdoor company page (overview, reviews or salaries). | $1 per 1,000 calls. |
| Glassdoor salaries | A Glassdoor company page (overview, reviews or salaries). | $1 per 1,000 calls. |
Shopping
| Parser | Reads | Price |
|---|---|---|
| Amazon search | An Amazon search page with a search word or a department, like amazon.com/s?k=laptop. | $1 per 1,000 calls. |
| Amazon product | An Amazon product page, like amazon.com/dp/<ASIN>. | $1 per 1,000 calls. |
| Amazon reviews | An Amazon product page. | $1 per 1,000 calls. |
| Amazon bestsellers | An Amazon Best Sellers category page, like amazon.com/Best-Sellers-Electronics/zgbs/electronics. | $1 per 1,000 calls. |
| TikTok Shop | A TikTok Shop search page (/k/), store page (/store/) or product page (/pdp/). Send options view reviews on a product page for its reviews. | $1 per 1,000 calls. |
| eBay search | An ebay.com search page, like ebay.com/sch/i.html?_nkw=iphone. | $1 per 1,000 calls. |
| eBay item | An eBay item page, like ebay.com/itm/<item id>. | $1 per 1,000 calls. |
| Facebook marketplace | A Facebook Marketplace search page with a city and a query, like facebook.com/marketplace/austin/search?query=bike. | $1 per 1,000 calls. |
| Craigslist search | A Craigslist search page with a five-digit US ZIP code in postal, like sfbay.craigslist.org/search/sss?query=bike&postal=94103. | $0.001 per 10 listings. |
| Trustpilot search | A Trustpilot search page, like trustpilot.com/search?query=stripe. | $1 per 1,000 calls. |
| Trustpilot company | A Trustpilot company page, like trustpilot.com/review/stripe.com. | $1 per 1,000 calls. |
| Trustpilot reviews | A Trustpilot company page, like trustpilot.com/review/stripe.com. | $1 per 1,000 calls. |
| Craigslist listing | One Craigslist post, like craigslist.org/view/d/hermosa-beach-thule-kayak-carrier-new/2uYpYvcvf6gMZMAkgfgSPg. | $1 per 1,000 calls. |
Apps
| Parser | Reads | Price |
|---|---|---|
| App Store search | An App Store search page, like apps.apple.com/us/iphone/search?term=notes. | $0.001 per 10 apps. |
| App Store app | An App Store app page, like apps.apple.com/us/app/notes/id1110145109. | $1 per 1,000 calls. |
| App Store reviews | An App Store app page, like apps.apple.com/us/app/notes/id1110145109. | $1 per 1,000 calls. |
| App Store top | An App Store top charts page, like apps.apple.com/us/iphone/charts. | $0.001 per 10 apps. |
| Google Play search | A Google Play apps search page with the search in q. | $0.001 per 10 apps. |
| Google Play app | A Google Play app page. | $1 per 1,000 calls. |
| Google Play reviews | A Google Play app page. | $1 per 1,000 calls. |
Real estate
| Parser | Reads | Price |
|---|---|---|
| Zillow search | A Zillow search page for a place, like zillow.com/homes/San-Francisco,-CA_rb/. | $4 per 1,000 calls. |
| Zillow property | A Zillow home page, like zillow.com/homedetails/…/123_zpid/. | $1 per 1,000 calls. |
| Realtor.com search | A Realtor.com search page for a place, like realtor.com/realestateandhomes-search/Austin_TX. | $1 per 1,000 calls. |
| Realtor.com property | A Realtor.com home page, like realtor.com/realestateandhomes-detail/.. | $1 per 1,000 calls. |
Ads
| Parser | Reads | Price |
|---|---|---|
| Meta ads | A Meta Ad Library search page with a q keyword, a page view with a view_all_page_id, or an ad page with an id. | $1 per 1,000 calls. |
| Google ads | A Google Ads Transparency Center advertiser page, ad page or search page with a domain. | $1 per 1,000 calls. |
| TikTok ads | A TikTok Ad Library search page with an adv_name keyword or advertiser, or an ad page. | $1 per 1,000 calls. |
| LinkedIn ads | A LinkedIn Ad Library search page with a keyword or accountOwner, or an ad page or lnkd.in share link. | $1 per 1,000 calls. |
Companies and reviews
| Parser | Reads | Price |
|---|---|---|
| Crunchbase company | A Crunchbase organization page, like crunchbase.com/organization/stripe. | $1 per 1,000 calls. |
| G2 reviews | A G2 product reviews page, like g2.com/products/slack/reviews. | $1 per 1,000 calls. |
Price
Each parser has its own price per call, most of them $1 per 1,000 calls. 16 parsers work without an API key when you send no options, up to 10 calls a minute and 50 calls a day per IP address. See Rate limits. Paging and other options need an API key. See Pricing.Read the list from code
GET /v1/parsers returns every parser. It is free and needs no API key.
curl -s https://api.stophy.dev/v1/parsers \
| jq -r '.data.parsers[] | select(.name | startswith("youtube")) | "\(.name): \(.takes)"'
takes (the page it reads), an example URL, its options, the fields it returns, its price, keyless: true when it works without an API key, and a sample response. See List parsers.