search_endpoints

Free. Search fetcher.sh's web-data endpoints (Twitter/X, YouTube, TikTok, Instagram, Reddit, Google, Google Maps, Google News, Google Play, App Store, Yelp) by keyword and/or service. Returns paths, descriptions and per-call prices. Start here.

Parameters2

query	string	optional	Keywords, e.g. 'twitter followers' or 'reviews'
service	string	optional	Restrict to one service slug, e.g. 'twitter'

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords, e.g. 'twitter followers' or 'reviews'"
    },
    "service": {
      "type": "string",
      "description": "Restrict to one service slug, e.g. 'twitter'"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

describe_endpoint

Free. Show the full call signature for one endpoint: required and optional parameters, allowed values, price, and response shape.

Parameters1

path

string

required

Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fetch_data

Paid. Fetch live data from any fetcher.sh endpoint. Pass the endpoint path plus its parameters (path and query parameters together in `params`). Priced per call in USDC on Base, Polygon, Arbitrum, Monad or Solana: pay with x402, or send an Authorization: Bearer bby_live_... header to spend prepaid credits. Call describe_endpoint first if unsure about parameters.

Parameters2

path	string	required	Endpoint path from search_endpoints, e.g. /api/twitter/search
params	object	optional	All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path from search_endpoints, e.g. /api/twitter/search"
    },
    "params": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_balance

Free. Show the remaining credit balance for the API key sent in this connection's Authorization header. Call this before a long run of paid requests.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

topup_credits

Paid (the amount you choose, minimum $1). Buy prepaid credits with x402 so later calls skip the per-call payment round trip. With an Authorization: Bearer bby_live_... header on this connection it recharges that key. Without one, the paying wallet becomes the account and a new API key is minted and returned once — store it as a secret, it cannot be recovered.

Parameters2

amount	number	required	Amount to add, in USD. Minimum 1.
rotate	boolean	optional	Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "minimum": 1,
      "description": "Amount to add, in USD. Minimum 1."
    },
    "rotate": {
      "type": "boolean",
      "description": "Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent."
    }
  },
  "required": [
    "amount"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

appstore_apps

Paid ($0.003). Apps — App Store. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters4

term	string	required	Required.
page	string	optional	Optional.
country	string	optional	Optional.
lang	string	optional	Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "term": {
      "type": "string",
      "description": "Required."
    },
    "page": {
      "type": "string",
      "description": "Optional."
    },
    "country": {
      "type": "string",
      "description": "Optional."
    },
    "lang": {
      "type": "string",
      "description": "Optional."
    }
  },
  "required": [
    "term"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

google_maps_place_search

Paid ($0.005). Place search — Google Maps. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters7

query	string	required	Required.
languageCode	string	optional	Optional.
countryCode	string	optional	Optional.
latitude	string	optional	Optional.
longitude	string	optional	Optional.
offset	string	optional	Optional.
zoom	string	optional	Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Required."
    },
    "languageCode": {
      "type": "string",
      "description": "Optional."
    },
    "countryCode": {
      "type": "string",
      "description": "Optional."
    },
    "latitude": {
      "type": "string",
      "description": "Optional."
    },
    "longitude": {
      "type": "string",
      "description": "Optional."
    },
    "offset": {
      "type": "string",
      "description": "Optional."
    },
    "zoom": {
      "type": "string",
      "description": "Optional."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

google_news_search

Paid ($0.005). Search — Google News. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters2

keyword	string	required	Required.
languageCode	string	required	Required.

Raw schema

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "description": "Required."
    },
    "languageCode": {
      "type": "string",
      "description": "Required."
    }
  },
  "required": [
    "keyword",
    "languageCode"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

google_search

Paid ($0.005). Search — Google Search. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters7

query	string	required	Required.
safe	string	optional	Optional.
page	string	optional	Optional.
hl	string	optional	Optional.
country	string	optional	Optional.
count	string	optional	Optional. One of: 10.
noEncode	string	optional	Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Required."
    },
    "safe": {
      "type": "string",
      "description": "Optional."
    },
    "page": {
      "type": "string",
      "description": "Optional."
    },
    "hl": {
      "type": "string",
      "description": "Optional."
    },
    "country": {
      "type": "string",
      "description": "Optional."
    },
    "count": {
      "type": "string",
      "enum": [
        "10"
      ],
      "description": "Optional. One of: 10."
    },
    "noEncode": {
      "type": "string",
      "description": "Optional."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

googleplay_apps

Paid ($0.003). Apps — Google Play. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters4

search	string	required	Required.
price	string	optional	Optional. One of: all, free, paid.
country	string	optional	Optional.
lang	string	optional	Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "description": "Required."
    },
    "price": {
      "type": "string",
      "enum": [
        "all",
        "free",
        "paid"
      ],
      "description": "Optional. One of: all, free, paid."
    },
    "country": {
      "type": "string",
      "description": "Optional."
    },
    "lang": {
      "type": "string",
      "description": "Optional."
    }
  },
  "required": [
    "search"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

instagram_user_handle

Paid ($0.004). User handle — Instagram. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters1

handle

string

required

Required. Path parameter.

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    }
  },
  "required": [
    "handle"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit_search_post

Paid ($0.002). Search post — Reddit. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters3

keyword	string	required	Required.
sort	string	optional	Optional. One of: relevance, hot, new, top, comments.
cursor	string	optional	Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "description": "Required."
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "hot",
        "new",
        "top",
        "comments"
      ],
      "description": "Optional. One of: relevance, hot, new, top, comments."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tiktok_post_search

Paid ($0.004). Post search — TikTok. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters5

keyword	string	required	Required.
cursor	string	optional	Optional.
region	string	optional	Optional.
sortType	string	optional	Optional. One of: RELEVANCE, MOST_LIKED, DATE_POSTED.
dateRange	string	optional	Optional. One of: ALL_TIME, YESTERDAY, THIS_WEEK, THIS_MONTH, LAST_THREE_MONTHS, LAST_SIX_MONTHS.

Raw schema

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "description": "Required."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    },
    "region": {
      "type": "string",
      "description": "Optional."
    },
    "sortType": {
      "type": "string",
      "enum": [
        "RELEVANCE",
        "MOST_LIKED",
        "DATE_POSTED"
      ],
      "description": "Optional. One of: RELEVANCE, MOST_LIKED, DATE_POSTED."
    },
    "dateRange": {
      "type": "string",
      "enum": [
        "ALL_TIME",
        "YESTERDAY",
        "THIS_WEEK",
        "THIS_MONTH",
        "LAST_THREE_MONTHS",
        "LAST_SIX_MONTHS"
      ],
      "description": "Optional. One of: ALL_TIME, YESTERDAY, THIS_WEEK, THIS_MONTH, LAST_THREE_MONTHS, LAST_SIX_MONTHS."
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

twitter_search

Paid ($0.005). Search — Twitter / X. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters3

query	string	required	Required.
sort	string	optional	Optional. One of: Latest, Top.
cursor	string	optional	Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Required."
    },
    "sort": {
      "type": "string",
      "enum": [
        "Latest",
        "Top"
      ],
      "description": "Optional. One of: Latest, Top."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

yelp_search

Paid ($0.003). Search — Yelp. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters4

page	string	optional	Optional.
query	string	required	Required.
location	string	required	Required.
sortBy	string	optional	Optional. One of: recommended, rating, reviewCount.

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "string",
      "description": "Optional."
    },
    "query": {
      "type": "string",
      "description": "Required."
    },
    "location": {
      "type": "string",
      "description": "Required."
    },
    "sortBy": {
      "type": "string",
      "enum": [
        "recommended",
        "rating",
        "reviewCount"
      ],
      "description": "Optional. One of: recommended, rating, reviewCount."
    }
  },
  "required": [
    "query",
    "location"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

youtube_search_video

Paid ($0.005). Search video — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters8

query	string	required	Required.
cursor	string	optional	Optional.
duration	string	optional	Optional. One of: short, medium, long.
features	string	optional	Optional. One of: hd, subtitles, creative_commons, 3d, live, purchased, 4k, 360, location, hdr, vr180.
uploadDate	string	optional	Optional. One of: hour, today, week, month, year.
sortBy	string	optional	Optional. One of: relevance, rating, upload_date, view_count.
lang	string	optional	Optional.
geo	string	optional	Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Required."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    },
    "duration": {
      "type": "string",
      "enum": [
        "short",
        "medium",
        "long"
      ],
      "description": "Optional. One of: short, medium, long."
    },
    "features": {
      "type": "string",
      "enum": [
        "hd",
        "subtitles",
        "creative_commons",
        "3d",
        "live",
        "purchased",
        "4k",
        "360",
        "location",
        "hdr",
        "vr180"
      ],
      "description": "Optional. One of: hd, subtitles, creative_commons, 3d, live, purchased, 4k, 360, location, hdr, vr180."
    },
    "uploadDate": {
      "type": "string",
      "enum": [
        "hour",
        "today",
        "week",
        "month",
        "year"
      ],
      "description": "Optional. One of: hour, today, week, month, year."
    },
    "sortBy": {
      "type": "string",
      "enum": [
        "relevance",
        "rating",
        "upload_date",
        "view_count"
      ],
      "description": "Optional. One of: relevance, rating, upload_date, view_count."
    },
    "lang": {
      "type": "string",
      "description": "Optional."
    },
    "geo": {
      "type": "string",
      "description": "Optional."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fetcher.sh — web data for agents

sh.fetcher/mcp (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_endpoints

describe_endpoint

fetch_data

check_balance

topup_credits

appstore_apps

google_maps_place_search

google_news_search

google_search

googleplay_apps

instagram_user_handle

reddit_search_post

tiktok_post_search

twitter_search

yelp_search

youtube_search_video

Install

Remote endpoint