Wszystkie Skills / FETCHER-SH

fetcher-sh/fetcher-skills

x-api

An X API alternative and Twitter API alternative on fetcher.sh — pay-per-call in USDC via x402, or prepaid credits with a Bearer key, no OAuth and no developer application.

Zobacz źródło

Jak używać

Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.

npx skills add https://github.com/fetcher-sh/fetcher-skills --skill x-api

Przed rozpoczęciem

Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.

Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

X (Twitter) Data API

A drop-in X data source for agents: search posts, resolve profiles, pull timelines and followers, read Lists, and check trends — all as one plain HTTP GET, paid per call. No developer account, no app review, no OAuth handshake, and no waiting on X's own API tiers or rate-limit approvals. If your task mentions an X search query, a handle, a post/tweet ID, or a list ID, this is the skill.

Base URL: https://twitter.fetcher.sh — the API host is still named twitter (it predates the rebrand and matches what agents already search for); everything below is current X data.

Also published as `twitter-api` — identical endpoints, indexed under the "Twitter" name too since both are still in everyday use.

Quick reference


Base URL	`https://twitter.fetcher.sh`
Auth	`Authorization: Bearer bby_live_...` or x402 (USDC)
Price	$0.002–$0.005/call
Endpoints	15, all `GET`
MCP	`https://twitter.fetcher.sh/mcp`
Machine-readable	`/openapi.json` · `/llms.txt` · `/skill.md`

Which endpoint do I need?

I want to...	Call
Search posts by keyword or operator (`from:`, `since:`, `min_faves:`, ...)	`GET /api/search`
Search accounts by name	`GET /api/search/users`
Look up a profile by @handle	`GET /api/handle/{handle}`
Get a user's followers or followings	`GET /api/user/{id}/followers` or `/followings`
Get a single post by ID	`GET /api/tweet/{id}`
See who reposted a post	`GET /api/tweet/{id}/retweeters`
Read an X List's posts or members	`GET /api/list/{id}/tweets` or `/members`
Check trending topics for a country	`GET /api/trends`

Full param details for every row: `references/endpoints.md`.

Authentication

Two ways to pay, same data — full mechanics in the `fetcher` skill:

bash

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/search?query=hello"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

Every response is { "status": number, "message": string, "data": ... }; the HTTP status mirrors status.

Endpoints (15 — all GET, $0.005/call unless noted)

Endpoint	Price	What it returns
`/api/search`	$0.005	Posts matching a query; supports X's advanced search operators
`/api/search/users`	$0.005	Accounts matching a name/keyword query
`/api/handle/{handle}`	$0.005	Profile by @handle
`/api/handle/{handle}/about`	$0.005	Extended profile/about info by @handle
`/api/user/{id}`	$0.005	Profile by numeric user ID
`/api/user/{id}/tweets`	$0.005	A user's post timeline
`/api/user/{id}/replies`	$0.005	A user's replies
`/api/user/{id}/followers`	$0.005	A user's followers
`/api/user/{id}/followings`	$0.005	Accounts a user follows
`/api/tweet/{id}`	$0.002	A single post by ID
`/api/tweet/{id}/replies`	$0.005	Replies to a post
`/api/tweet/{id}/retweeters`	$0.005	Accounts that reposted a post
`/api/list/{id}/members`	$0.005	An X List's member accounts
`/api/list/{id}/tweets`	$0.005	An X List's post feed
`/api/trends`	$0.005	Trending topics for a country

{id} / {handle} are path parameters — substitute the real value. Optional query params (cursor, sort) paginate or reorder; only query (search) and country (trends) are required elsewhere they appear.

Scenarios

The query on /api/search goes straight to X's own search, so its operators work as-is: from:, to:, since:, until:, min_faves:, min_retweets:, filter:, -filter:.

Everything from one account:

bash

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/search?query=from%3AOpenAI&sort=Latest"

Between two dates:

bash

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=x402 since:2026-01-01 until:2026-02-01" -G \
  "https://twitter.fetcher.sh/api/search"

Popular posts only, replies excluded:

bash

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=ai agents min_faves:500 -filter:replies" -G \
  --data-urlencode "sort=Top" \
  "https://twitter.fetcher.sh/api/search"

Search accounts by name:

bash

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=climate scientist" -G \
  "https://twitter.fetcher.sh/api/search/users"

Resolve a profile by handle, then pull its bio/about:

bash

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/handle/nasa"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/handle/nasa/about"

A user's posts, replies, followers, or followings (by numeric ID from the handle lookup above):

bash

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/user/11348282/tweets"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/user/11348282/followers"

A single post, its replies, and who reposted it:

bash

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/tweet/1234567890123456789"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/tweet/1234567890123456789/replies"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/tweet/1234567890123456789/retweeters"

An X List's members and posts:

bash

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/list/1234567890/members"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/list/1234567890/tweets"

Trending topics for a country:

bash

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/trends?country=United%20States"

MCP

json

{
  "mcpServers": {
    "x": {
      "url": "https://twitter.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

Free: search_endpoints, describe_endpoint, check_balance. Paid: fetch_data (any endpoint above), topup_credits, plus the named shortcut twitter_search. Drop the headers block to pay per call with x402 instead — see the `fetcher` skill for the full flow.

Errors

400 — missing/invalid parameter (message names it)
401 — unknown or rotated key
402 — payment required (x402 challenge) or topup_required (credits

exhausted)

404 — not a priced path
No rate limits; no refunds on upstream failures (settlement precedes

delivery)

Reference

Deep dives: `references/endpoints.md` (every

param) · `references/scenarios.md` (one curl per endpoint) · `references/faq.md` · `references/comparison.md` (vs. the official X API and a browser scraper)

Task guides: search tweets ·

export followers

Powiązane zadania

z tego samego repozytorium

Więcej Skills

Wszystkie Skills

tiktok-api

A TikTok API alternative on fetcher.sh — pay-per-call in USDC via x402, or prepaid credits with a Bearer key, no login and no app review. Use when the user wants to search TikTok posts by keyword and sort by most-liked or most recent within a date range, look up a post by its share URL or ID, scrape a TikTok profile by @username, pull a user's posts, followers, or followings, fetch a hashtag's posts, pull posts using a specific sound/music track, get posts from a location, or read a post's comme

instalacje: 4
GitHub Stars: 2
Aktualizacja: 5 wrz

Zobacz szczegóły →

app-store

An Apple App Store API alternative on fetcher.sh — pay-per-call in USDC via x402, or prepaid credits with a Bearer key, no Apple Developer Program membership. Use when the user wants to search iOS apps by keyword in any country's storefront, fetch an app's or app bundle's full details, reviews sorted by recent/helpful, apps similar to a given app, search or fetch app bundles, or fetch a developer's app catalog. Also covers iOS app store optimization (ASO) research, competitor app monitoring, loc

instalacje: 4
GitHub Stars: 2
Aktualizacja: 5 wrz

Zobacz szczegóły →

google-maps

- A Google Maps API alternative and Google Places API alternative on fetcher.sh — pay-per-call in USDC via x402, or prepaid credits with a Bearer key, no Google Cloud billing account. Use when the user wants to search places by text query or anchor the search to a latitude/longitude coordinate, fetch a place's full details by its feature ID (fid), pull a place's reviews sorted by relevance/newest/rating, or look up a single review by ID. Also covers local business discovery, points-of-interest d

instalacje: 3
GitHub Stars: 2
Aktualizacja: 5 wrz

Zobacz szczegóły →

youtube-api

- A YouTube API alternative on fetcher.sh — pay-per-call in USDC via x402, or prepaid credits with a Bearer key, no OAuth and no daily quota. Use when the user wants to search YouTube videos with filters for upload date, duration, or sort order, search channels or playlists, look up a channel by ID, @handle, or custom URL path, list a channel's videos, shorts, or live streams, fetch a video's or short's details and comments, list a playlist's videos, pull posts under a hashtag, or check trending

instalacje: 3
GitHub Stars: 2
Aktualizacja: 5 wrz

Zobacz szczegóły →