# fetcher.sh > fetcher.sh is an x402-paywalled web-data API: 111 GET endpoints across 11 services (Twitter / X, YouTube, TikTok, Instagram, Reddit, Google Search, Google Maps, Google News, Google Play, App Store, Yelp), each payable per call in USDC on Base mainnet — or prepaid via a credit balance with a bby_live_ Bearer API key. Built for autonomous agents: no accounts, no OAuth, machine-readable 402 challenges. - Base URL: https://fetcher.sh - Agent setup instructions: https://fetcher.sh/skill.md - Human top-up page (browser wallet): https://fetcher.sh/topup - Payments: x402 "exact" scheme (EIP-3009 USDC transferWithAuthorization) on eip155:8453; gas sponsored, no ETH needed - Credits: POST /api/credits/topup?amount= (min $1, x402-paid; the first top-up returns the API key exactly once, &rotate=1 mints a fresh one), then Authorization: Bearer bby_live_... per call; GET /api/credits/balance reads the balance; sending Authorization: Bearer with the top-up recharges that key's account from any wallet - Response envelope: { "status": number, "message": string, "data": any } - No rate limits; no refunds on upstream failures (settlement precedes delivery) ## Services - Twitter / X — https://fetcher.sh/twitter — 15 endpoints — Search tweets, resolve profiles by handle or ID, and pull timelines, replies, followers, lists, and trends. - YouTube — https://fetcher.sh/youtube — 15 endpoints — Search videos, channels, and playlists; fetch video details, comments, shorts, live streams, and trending. - TikTok — https://fetcher.sh/tiktok — 13 endpoints — Search posts, resolve users by handle, and pull followers, hashtags, music, comments, and replies. - Instagram — https://fetcher.sh/instagram — 16 endpoints — Profiles, posts, reels, stories, followers, hashtags, locations, and comment threads. - Reddit — https://fetcher.sh/reddit — 15 endpoints — Search posts, subreddits, and users; pull hot/new/top/best feeds, comment trees, and user history. - Google Search — https://fetcher.sh/google — 1 endpoints — Programmatic Google web search results as clean JSON. - Google Maps — https://fetcher.sh/google-maps — 4 endpoints — Place search, place details, and reviews. - Google News — https://fetcher.sh/google-news — 12 endpoints — Headlines by section (world, business, technology, ...), keyword search, topics, and article URL decoding. - Google Play — https://fetcher.sh/googleplay — 7 endpoints — App search, app details, reviews, permissions, data safety, and developer catalogs. - App Store — https://fetcher.sh/appstore — 9 endpoints — Apple App Store app and bundle lookups, reviews, similar apps, and developer catalogs. - Yelp — https://fetcher.sh/yelp — 4 endpoints — Business search by query and location, place details, and reviews. ## Endpoints (price per call) ### Twitter / X GET /api/twitter/handle/{handle} — $0.005 — Handle GET /api/twitter/handle/{handle}/about — $0.005 — Handle about GET /api/twitter/list/{id}/members — $0.005 — List members GET /api/twitter/list/{id}/tweets — $0.005 — List tweets GET /api/twitter/search — $0.005 — Search GET /api/twitter/search/users — $0.005 — Search users GET /api/twitter/trends — $0.005 — Trends GET /api/twitter/tweet/{id} — $0.002 — Tweet GET /api/twitter/tweet/{id}/replies — $0.005 — Tweet replies GET /api/twitter/tweet/{id}/retweeters — $0.005 — Tweet retweeters GET /api/twitter/user/{id} — $0.005 — User GET /api/twitter/user/{id}/followers — $0.005 — User followers GET /api/twitter/user/{id}/followings — $0.005 — User followings GET /api/twitter/user/{id}/replies — $0.005 — User replies GET /api/twitter/user/{id}/tweets — $0.005 — User tweets ### YouTube GET /api/youtube/channel/handle/{handle} — $0.005 — Channel handle GET /api/youtube/channel/path — $0.005 — Channel path GET /api/youtube/channel/{id} — $0.005 — Channel GET /api/youtube/channel/{id}/live-streams — $0.005 — Channel live streams GET /api/youtube/channel/{id}/shorts — $0.005 — Channel shorts GET /api/youtube/channel/{id}/videos — $0.005 — Channel videos GET /api/youtube/hashtag/{tag} — $0.005 — Hashtag GET /api/youtube/playlist/{id}/videos — $0.005 — Playlist videos GET /api/youtube/search/channel — $0.005 — Search channel GET /api/youtube/search/playlist — $0.005 — Search playlist GET /api/youtube/search/video — $0.005 — Search video GET /api/youtube/shorts/{id} — $0.005 — Shorts GET /api/youtube/trending — $0.005 — Trending GET /api/youtube/video/{id} — $0.005 — Video GET /api/youtube/video/{id}/comments — $0.005 — Video comments ### TikTok GET /api/tiktok/hashtag/handle/{name} — $0.004 — Hashtag handle GET /api/tiktok/hashtag/{id}/posts — $0.004 — Hashtag posts GET /api/tiktok/location/{locationId}/posts — $0.004 — Location posts GET /api/tiktok/music/{id}/posts — $0.004 — Music posts GET /api/tiktok/post — $0.004 — Post GET /api/tiktok/post/search — $0.004 — Post search GET /api/tiktok/post/{id} — $0.004 — Post GET /api/tiktok/post/{id}/comments — $0.004 — Post comments GET /api/tiktok/post/{id}/comments/{commentId}/replies — $0.004 — Post comments replies GET /api/tiktok/user/handle/{username} — $0.004 — User handle GET /api/tiktok/user/{id}/followers — $0.004 — User followers GET /api/tiktok/user/{id}/followings — $0.004 — User followings GET /api/tiktok/user/{id}/posts — $0.004 — User posts ### Instagram GET /api/instagram/audio/{id}/posts — $0.004 — Audio posts GET /api/instagram/hashtag/{name}/posts — $0.004 — Hashtag posts GET /api/instagram/hashtag/{name}/reels — $0.004 — Hashtag reels GET /api/instagram/location/{id}/posts — $0.004 — Location posts GET /api/instagram/post/code/{code} — $0.004 — Post code GET /api/instagram/post/{id}/comments — $0.004 — Post comments GET /api/instagram/user/handle/{handle} — $0.004 — User handle GET /api/instagram/user/search — $0.004 — User search GET /api/instagram/user/{id} — $0.004 — User GET /api/instagram/user/{id}/followers — $0.004 — User followers GET /api/instagram/user/{id}/followings — $0.004 — User followings GET /api/instagram/user/{id}/posts — $0.004 — User posts GET /api/instagram/user/{id}/posts/tagged — $0.004 — User posts tagged GET /api/instagram/user/{id}/reels — $0.004 — User reels GET /api/instagram/user/{id}/stories — $0.004 — User stories GET /api/instagram/userid/{handle} — $0.004 — Userid ### Reddit GET /api/reddit/post/{id} — $0.002 — Post GET /api/reddit/post/{id}/comments — $0.002 — Post comments GET /api/reddit/post/{id}/comments/{commentId}/replies — $0.002 — Post comments replies GET /api/reddit/posts/best — $0.002 — Posts best GET /api/reddit/posts/hot — $0.002 — Posts hot GET /api/reddit/posts/new — $0.002 — Posts new GET /api/reddit/posts/top — $0.002 — Posts top GET /api/reddit/search/post — $0.002 — Search post GET /api/reddit/search/subreddit — $0.002 — Search subreddit GET /api/reddit/search/user — $0.002 — Search user GET /api/reddit/subreddit/{name} — $0.002 — Subreddit GET /api/reddit/subreddit/{name}/posts — $0.002 — Subreddit posts GET /api/reddit/user/{username} — $0.002 — User GET /api/reddit/user/{username}/comments — $0.002 — User comments GET /api/reddit/user/{username}/posts — $0.002 — User posts ### Google Search GET /api/google/search — $0.005 — Search ### Google Maps GET /api/google-maps/place/search — $0.005 — Place search GET /api/google-maps/place/{fid} — $0.005 — Place GET /api/google-maps/place/{fid}/reviews — $0.005 — Place reviews GET /api/google-maps/review/{id} — $0.005 — Review ### Google News GET /api/google-news/business — $0.005 — Business GET /api/google-news/decode-article-url — $0.005 — Decode article URL GET /api/google-news/entertainment — $0.005 — Entertainment GET /api/google-news/health — $0.005 — Health GET /api/google-news/language-regions — $0.005 — Language regions GET /api/google-news/latest — $0.005 — Latest GET /api/google-news/science — $0.005 — Science GET /api/google-news/search — $0.005 — Search GET /api/google-news/sport — $0.005 — Sport GET /api/google-news/technology — $0.005 — Technology GET /api/google-news/topic/{topicId} — $0.005 — Topic GET /api/google-news/world — $0.005 — World ### Google Play GET /api/googleplay/apps — $0.003 — Apps GET /api/googleplay/apps/{appId} — $0.003 — Apps GET /api/googleplay/apps/{appId}/datasafety — $0.003 — Apps datasafety GET /api/googleplay/apps/{appId}/permissions — $0.003 — Apps permissions GET /api/googleplay/apps/{appId}/reviews — $0.003 — Apps reviews GET /api/googleplay/apps/{appId}/similar — $0.003 — Apps similar GET /api/googleplay/developers/{developerId} — $0.003 — Developers ### App Store GET /api/appstore/apps — $0.003 — Apps GET /api/appstore/apps/{appId} — $0.003 — Apps GET /api/appstore/apps/{appId}/reviews — $0.003 — Apps reviews GET /api/appstore/apps/{appId}/similar — $0.003 — Apps similar GET /api/appstore/bundles — $0.003 — Bundles GET /api/appstore/bundles/{bundleId} — $0.003 — Bundles GET /api/appstore/bundles/{bundleId}/reviews — $0.003 — Bundles reviews GET /api/appstore/bundles/{bundleId}/similar — $0.003 — Bundles similar GET /api/appstore/developers/{developerId} — $0.003 — Developers ### Yelp GET /api/yelp/place/handle/{handle} — $0.003 — Place handle GET /api/yelp/place/{id} — $0.003 — Place GET /api/yelp/place/{id}/reviews — $0.003 — Place reviews GET /api/yelp/search — $0.003 — Search