{"openapi":"3.1.0","info":{"title":"ScrapeMole data API for AI agents","version":"0.1.0","description":"Pay-per-call public web data for agents: Google Trends, YouTube transcripts, YouTube search, YouTube channel videos. Pay per successful call in USDC with x402; errors are never charged. No accounts, no API keys.\n\nPayments: x402 v2, scheme \"exact\", USDC on Base (eip155:8453). The payment is verified before the scrape and settled only when the response is 200. Terms: https://scrapemole-api-mainnet.scrapemole.workers.dev/terms","contact":{"email":"edgaras@mail.grokbot.com","url":"https://scrapemole.pages.dev"},"x-guidance":"Call any /v1 endpoint without payment to receive a 402 with the exact price, then retry with an x402 client (e.g. @x402/fetch). Read errors: 4xx/5xx responses are never charged."},"servers":[{"url":"https://scrapemole-api-mainnet.scrapemole.workers.dev"}],"x-discovery":{"ownershipProofs":[]},"components":{"securitySchemes":{"x402":{"type":"http","scheme":"x402","description":"HTTP 402 payment with USDC via the x402 protocol."}}},"paths":{"/v1/google-trends":{"get":{"operationId":"googleTrends","summary":"Google Trends for one search term (or up to 5 compared): interest over time, by region, related queries.","description":"Use when you need how search interest in a topic changes over time or by region, or which related queries are rising. Returns weekly/daily interest (0-100), per-region interest and top/rising related queries from Google Trends. $0.01 per successful call; errors are not charged.","tags":["google-trends","search-trends","seo","market-research"],"parameters":[{"name":"q","in":"query","required":true,"description":"Search term. Compare up to 5 terms by separating them with commas.","schema":{"type":"string","examples":["espresso machine"]}},{"name":"geo","in":"query","required":false,"description":"Country or region code (US, GB, DE, US-CA). Empty = worldwide.","schema":{"type":"string","examples":["US"]}},{"name":"time","in":"query","required":false,"description":"Time range.","schema":{"type":"string","enum":["now 1-H","now 4-H","now 1-d","now 7-d","today 1-m","today 3-m","today 12-m","today 5-y","all"],"default":"today 12-m"}},{"name":"regions","in":"query","required":false,"description":"Include interest by region.","schema":{"type":"string","enum":["true","false"],"default":"true"}},{"name":"related","in":"query","required":false,"description":"Include related queries.","schema":{"type":"string","enum":["true","false"],"default":"true"}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01","currency":"USD","network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Data (the payment settles only for this status).","content":{"application/json":{"example":{"type":"comparison","searchTerm":null,"searchTerms":["espresso machine","french press"],"geo":"US","timeRange":"today 12-m","category":0,"searchType":"web","trendsUrl":"https://trends.google.com/trends/explore?q=espresso+machine%2Cfrench+press&hl=en-US&geo=US&date=today+12-m","interestOverTime":[{"date":"2025-10-05T00:00:00.000Z","timestamp":1759622400,"formattedTime":"Oct 5 – 11, 2025","values":{"espresso machine":34,"french press":12},"hasData":true,"isPartial":false},{"date":"2025-10-12T00:00:00.000Z","timestamp":1760227200,"formattedTime":"Oct 12 – 18, 2025","values":{"espresso machine":29,"french press":12},"hasData":true,"isPartial":false},{"date":"2025-10-19T00:00:00.000Z","timestamp":1760832000,"formattedTime":"Oct 19 – 25, 2025","values":{"espresso machine":28,"french press":11},"hasData":true,"isPartial":false}],"averages":{"espresso machine":51,"french press":19},"interestByRegion":[{"geoCode":"US-WY","geoName":"Wyoming","values":{"espresso machine":73,"french press":27},"hasData":true},{"geoCode":"US-WA","geoName":"Washington","values":{"espresso machine":76,"french press":24},"hasData":true},{"geoCode":"US-CA","geoName":"California","values":{"espresso machine":76,"french press":24},"hasData":true}],"relatedQueries":{"espresso machine":{"top":[{"query":"espresso machine breville","value":100,"formattedValue":"100","isBreakout":false,"link":"https://trends.google.com/trends/explore?q=espresso+machine+breville&date=today+12-m&geo=US"},{"query":"breville","value":98,"formattedValue":"98","isBreakout":false,"link":"https://trends.google.com/trends/explore?q=breville&date=today+12-m&geo=US"},{"query":"espresso coffee machine","value":98,"formattedValue":"98","isBreakout":false,"link":"https://trends.google.com/trends/explore?q=espresso+coffee+machine&date=today+12-m&geo=US"}],"rising":[{"query":"espresso machine arc raiders","value":18250,"formattedValue":"Breakout","isBreakout":true,"link":"https://trends.google.com/trends/explore?q=espresso+machine+arc+raiders&date=today+12-m&geo=US"},{"query":"ninja luxe café premier series 3-in-1 espresso coffee & cold brew machine","value":15450,"formattedValue":"Breakout","isBreakout":true,"link":"https://trends.google.com/trends/explore?q=ninja+luxe+caf%C3%A9+premier+series+3-in-1+espresso+coffee+%26+cold+brew+machine&date=today+12-m&geo=US"},{"query":"alton brown espresso machine eggs","value":7200,"formattedValue":"Breakout","isBreakout":true,"link":"https://trends.google.com/trends/explore?q=alton+brown+espresso+machine+eggs&date=today+12-m&geo=US"}]},"french press":{"top":[{"query":"french press how to","value":100,"formattedValue":"100","isBreakout":false,"link":"https://trends.google.com/trends/explore?q=french+press+how+to&date=today+12-m&geo=US"},{"query":"french coffee press","value":90,"formattedValue":"90","isBreakout":false,"link":"https://trends.google.com/trends/explore?q=french+coffee+press&date=today+12-m&geo=US"},{"query":"the french press","value":41,"formattedValue":"41","isBreakout":false,"link":"https://trends.google.com/trends/explore?q=the+french+press&date=today+12-m&geo=US"}],"rising":[{"query":"lidl near me","value":1200,"formattedValue":"+1,200%","isBreakout":false,"link":"https://trends.google.com/trends/explore?q=lidl+near+me&date=today+12-m&geo=US"},{"query":"french toast near me","value":850,"formattedValue":"+850%","isBreakout":false,"link":"https://trends.google.com/trends/explore?q=french+toast+near+me&date=today+12-m&geo=US"},{"query":"bodum chambord french press coffee maker","value":300,"formattedValue":"+300%","isBreakout":false,"link":"https://trends.google.com/trends/explore?q=bodum+chambord+french+press+coffee+maker&date=today+12-m&geo=US"}]}},"relatedTopics":{},"errors":[]}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header carries the price and accepted networks."},"404":{"description":"Target not found or has no data (e.g. no captions). Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"503":{"description":"Blocked upstream or server busy; retry later. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}},"/v1/youtube/transcript":{"get":{"operationId":"youtubeTranscript","summary":"Transcript (captions) of one YouTube video, with timestamps and video metadata.","description":"Use when you need what is said in a YouTube video: full transcript text plus timestamped segments, in the requested language (manual captions preferred, auto-generated as fallback, optional translation). $0.005 per successful call; videos without captions and errors are not charged.","tags":["youtube","transcript","captions","subtitles"],"parameters":[{"name":"video","in":"query","required":true,"description":"YouTube video URL or 11-character video ID.","schema":{"type":"string","examples":["aircAruvnKk"]}},{"name":"lang","in":"query","required":false,"description":"Preferred language code(s), comma-separated, in order of preference.","schema":{"type":"string","default":"en","examples":["en"]}},{"name":"translate","in":"query","required":false,"description":"Translate the transcript into this language code if the video lacks it.","schema":{"type":"string","examples":["de"]}},{"name":"segments","in":"query","required":false,"description":"Include timestamped segments.","schema":{"type":"string","enum":["true","false"],"default":"true"}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005","currency":"USD","network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Data (the payment settles only for this status).","content":{"application/json":{"example":{"videoId":"aircAruvnKk","url":"https://www.youtube.com/watch?v=aircAruvnKk","title":"But what is a neural network? | Deep learning chapter 1","channelName":"3Blue1Brown","channelId":"UCYO_jab_esuFRV4b17AJtAw","channelUrl":"https://www.youtube.com/channel/UCYO_jab_esuFRV4b17AJtAw","durationSeconds":1120,"viewCount":24708996,"description":"What are the neurons, why are there layers, and what is the math underlying it?\nHelp fund future projects: https://www.patreon.com/3blue1brown\nWritten/interactive form of this series: https://www.3blue1brown.com/topics/neural-networks\n\nAdditional funding for this project was provided by Amplify Part…","keywords":[],"thumbnailUrl":"https://i.ytimg.com/vi/aircAruvnKk/sddefault.jpg","isLive":false,"publishDate":"2017-10-05","publishDateText":"Oct 5, 2017","language":"en","languageName":"English","isAutoGenerated":false,"isTranslated":false,"availableLanguages":[{"languageCode":"ar","languageName":"Arabic","isAutoGenerated":false},{"languageCode":"bn","languageName":"Bangla","isAutoGenerated":false},{"languageCode":"zh","languageName":"Chinese","isAutoGenerated":false}],"transcriptText":"This is a 3. It's sloppily written and rendered at an extremely low resolution of 28x28 pixels, but your brain has no trouble recognizing it as a 3. And I want you to take a moment to appreciate how crazy it is that brains can do this so effortlessly. I mean, this, this and this are also recognizabl…","segments":[{"start":4.22,"duration":1.18,"end":5.4,"text":"This is a 3."},{"start":6.06,"duration":4.653,"end":10.713,"text":"It's sloppily written and rendered at an extremely low resolution of 28x28 pixels,"},{"start":10.713,"duration":3.007,"end":13.72,"text":"but your brain has no trouble recognizing it as a 3."}],"srt":"1\n00:00:04,220 --> 00:00:05,400\nThis is a 3.\n\n2\n00:00:06,060 --> 00:00:10,713\nIt's sloppily written and rendered at an extremely low resolution of 28x28 pixels,\n\n3\n00:00:10,713 --> 00:00:13,720\nbut your brain has no trouble recognizing it as a 3.\n\n4\n00:00:14,340 --> 00:00:16,559\nAnd I want you to ta…","segmentCount":286,"wordCount":3357,"characterCount":18430,"transcriptSource":"IOS"}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header carries the price and accepted networks."},"404":{"description":"Target not found or has no data (e.g. no captions). Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"503":{"description":"Blocked upstream or server busy; retry later. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}},"/v1/youtube/search":{"get":{"operationId":"youtubeSearch","summary":"YouTube search results: up to 50 videos with views, channel, duration and publish date.","description":"Use when you need to find YouTube videos for a query, e.g. competitor or trend research. Returns up to 50 videos per call with title, channel, views, duration, approximate publish date and thumbnail; optional filters for sort order, upload date and duration. $0.01 per successful call (any number of videos up to the limit); errors are not charged.","tags":["youtube","video-search","social-media"],"parameters":[{"name":"q","in":"query","required":true,"description":"Search query.","schema":{"type":"string","examples":["espresso machine review"]}},{"name":"limit","in":"query","required":false,"description":"Max videos (1-50).","schema":{"type":"string","default":"20"}},{"name":"sort","in":"query","required":false,"description":"Sort order.","schema":{"type":"string","enum":["relevance","date","views","rating"],"default":"relevance"}},{"name":"uploaded","in":"query","required":false,"description":"Upload date filter.","schema":{"type":"string","enum":["any","hour","today","week","month","year"],"default":"any"}},{"name":"duration","in":"query","required":false,"description":"Duration filter.","schema":{"type":"string","enum":["any","short","medium","long"],"default":"any"}},{"name":"lang","in":"query","required":false,"description":"Interface language (hl), e.g. en, de.","schema":{"type":"string","examples":["en"]}},{"name":"country","in":"query","required":false,"description":"Country (gl), e.g. US, GB.","schema":{"type":"string","examples":["US"]}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01","currency":"USD","network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Data (the payment settles only for this status).","content":{"application/json":{"example":{"count":2,"videos":[{"videoId":"4MJnPVnY3_o","url":"https://www.youtube.com/watch?v=4MJnPVnY3_o","title":"The Best Espresso Machine You've Never Heard Of","channelName":"Daddy Got Coffee","channelId":"UCu7x43fFlwbBykF1r04T_wQ","channelHandle":"@DaddyGotCoffee","channelUrl":"https://www.youtube.com/channel/UCu7x43fFlwbBykF1r04T_wQ","viewCount":158741,"viewCountText":"158,741 views","publishedText":"8 months ago","publishedAtApprox":"2026-02-07","durationSeconds":1215,"durationText":"20:15","isShort":false,"isLive":false,"badges":["4K"],"isVerifiedChannel":false,"descriptionSnippet":"The $3000 espresso category hasn't changed in years — until now. The Arkel Coast brings saturated group performance, flow ...","thumbnailUrl":"https://i.ytimg.com/vi/4MJnPVnY3_o/maxresdefault.jpg","sourceType":"search","searchQuery":"espresso machine review","position":2,"likeCount":1986,"commentCount":280,"publishDate":"2026-02-07T03:00:13-08:00","uploadDate":"2026-02-07T03:00:13-08:00","category":"People & Blogs","description":"The $3,000 espresso category hasn’t changed in years — until now.\nThe Arkel Coast brings saturated group performance, flow control, shot programming, and pro-level build into a price bracket where those specs normally don’t exist.\n\n10% off Arkel Coast at Cafune  - https://geni.us/ArkelCoast (Use - D…","keywords":[],"isLiveNow":false,"isFamilySafe":true,"isShortsEligible":false,"availableCountriesCount":249},{"videoId":"miNqgmVH9I0","url":"https://www.youtube.com/watch?v=miNqgmVH9I0","title":"Best Entry Level Espresso Machines 2025 – Our Top Picks for Beginners","channelName":"Whole Latte Love","channelId":"UCJwRmBtnYh_7Xs9oXUrLhZg","channelHandle":"@Wholelattelovepage","channelUrl":"https://www.youtube.com/channel/UCJwRmBtnYh_7Xs9oXUrLhZg","viewCount":169694,"viewCountText":"169,716 views","publishedText":"11 months ago","publishedAtApprox":"2025-11-08","durationSeconds":929,"durationText":"15:30","isShort":false,"isLive":false,"badges":["4K"],"isVerifiedChannel":true,"descriptionSnippet":"Looking for the best entry level espresso machine in 2025? We tested the top affordable espresso machines to find which ones ...","thumbnailUrl":"https://i.ytimg.com/vi_webp/miNqgmVH9I0/maxresdefault.webp","sourceType":"search","searchQuery":"espresso machine review","position":3,"likeCount":1259,"commentCount":115,"publishDate":"2025-11-07T12:30:07-08:00","uploadDate":"2025-11-07T12:30:07-08:00","category":"Howto & Style","description":"Looking for the best entry level espresso machine in 2025? We tested the top affordable espresso machines to find which ones make real café-quality shots at home. In this video, John from Whole Latte Love shares our top picks, hands-on insights, and what to look for in your first espresso machine.\n\n…","keywords":["best entry level espresso machine 2025","espresso machine for beginners"],"isLiveNow":false,"isFamilySafe":true,"isShortsEligible":false,"availableCountriesCount":249}]}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header carries the price and accepted networks."},"404":{"description":"Target not found or has no data (e.g. no captions). Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"503":{"description":"Blocked upstream or server busy; retry later. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}},"/v1/youtube/channel":{"get":{"operationId":"youtubeChannel","summary":"Latest videos, shorts or live streams of one YouTube channel (up to 50).","description":"Use when you need what a YouTube channel has published: up to 50 of its latest videos, shorts or streams with views, duration and approximate publish date. Accepts @handle, channel URL or channel ID. $0.01 per successful call; errors are not charged.","tags":["youtube","channel","social-media"],"parameters":[{"name":"channel","in":"query","required":true,"description":"Channel @handle, URL or UC… channel ID.","schema":{"type":"string","examples":["@3blue1brown"]}},{"name":"tab","in":"query","required":false,"description":"Which feed.","schema":{"type":"string","enum":["videos","shorts","streams"],"default":"videos"}},{"name":"limit","in":"query","required":false,"description":"Max videos (1-50).","schema":{"type":"string","default":"20"}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01","currency":"USD","network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Data (the payment settles only for this status).","content":{"application/json":{"example":{"count":2,"videos":[{"videoId":"4MJnPVnY3_o","url":"https://www.youtube.com/watch?v=4MJnPVnY3_o","title":"The Best Espresso Machine You've Never Heard Of","channelName":"Daddy Got Coffee","channelId":"UCu7x43fFlwbBykF1r04T_wQ","channelHandle":"@DaddyGotCoffee","channelUrl":"https://www.youtube.com/channel/UCu7x43fFlwbBykF1r04T_wQ","viewCount":158741,"viewCountText":"158,741 views","publishedText":"8 months ago","publishedAtApprox":"2026-02-07","durationSeconds":1215,"durationText":"20:15","isShort":false,"isLive":false,"badges":["4K"],"isVerifiedChannel":false,"descriptionSnippet":"The $3000 espresso category hasn't changed in years — until now. The Arkel Coast brings saturated group performance, flow ...","thumbnailUrl":"https://i.ytimg.com/vi/4MJnPVnY3_o/maxresdefault.jpg","sourceType":"search","searchQuery":"espresso machine review","position":2,"likeCount":1986,"commentCount":280,"publishDate":"2026-02-07T03:00:13-08:00","uploadDate":"2026-02-07T03:00:13-08:00","category":"People & Blogs","description":"The $3,000 espresso category hasn’t changed in years — until now.\nThe Arkel Coast brings saturated group performance, flow control, shot programming, and pro-level build into a price bracket where those specs normally don’t exist.\n\n10% off Arkel Coast at Cafune  - https://geni.us/ArkelCoast (Use - D…","keywords":[],"isLiveNow":false,"isFamilySafe":true,"isShortsEligible":false,"availableCountriesCount":249},{"videoId":"miNqgmVH9I0","url":"https://www.youtube.com/watch?v=miNqgmVH9I0","title":"Best Entry Level Espresso Machines 2025 – Our Top Picks for Beginners","channelName":"Whole Latte Love","channelId":"UCJwRmBtnYh_7Xs9oXUrLhZg","channelHandle":"@Wholelattelovepage","channelUrl":"https://www.youtube.com/channel/UCJwRmBtnYh_7Xs9oXUrLhZg","viewCount":169694,"viewCountText":"169,716 views","publishedText":"11 months ago","publishedAtApprox":"2025-11-08","durationSeconds":929,"durationText":"15:30","isShort":false,"isLive":false,"badges":["4K"],"isVerifiedChannel":true,"descriptionSnippet":"Looking for the best entry level espresso machine in 2025? We tested the top affordable espresso machines to find which ones ...","thumbnailUrl":"https://i.ytimg.com/vi_webp/miNqgmVH9I0/maxresdefault.webp","sourceType":"search","searchQuery":"espresso machine review","position":3,"likeCount":1259,"commentCount":115,"publishDate":"2025-11-07T12:30:07-08:00","uploadDate":"2025-11-07T12:30:07-08:00","category":"Howto & Style","description":"Looking for the best entry level espresso machine in 2025? We tested the top affordable espresso machines to find which ones make real café-quality shots at home. In this video, John from Whole Latte Love shares our top picks, hands-on insights, and what to look for in your first espresso machine.\n\n…","keywords":["best entry level espresso machine 2025","espresso machine for beginners"],"isLiveNow":false,"isFamilySafe":true,"isShortsEligible":false,"availableCountriesCount":249}]}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header carries the price and accepted networks."},"404":{"description":"Target not found or has no data (e.g. no captions). Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"503":{"description":"Blocked upstream or server busy; retry later. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}}}}