Reddit Search post API

One GET request returns search post from Reddit as JSON. $0.002 per call, no account and no OAuth — pay with x402 or spend a prepaid balance with one API key.

$0.002 per callGET · JSON envelopeUSDC · gas sponsored

pay from any of:BasePolygonArbitrumMonadSolana

endpointGET /api/reddit/search/post

keywordrequiredsortoptionalcursoroptional

API key — optional · stays in your browser

/api/reddit/search/post

fill required: keyword

opens the payment page in a new tab · $0.002 per call

Parameters

name	in	req	values
keyword	query	required	—
sort	query	optional	relevance · hot · new · top · comments
cursor	query	optional	—

Pay per call (x402)

Call it with no payment and the server answers 402 with machine-readable requirements on Base, Polygon, Arbitrum, Monad or Solana. Sign, retry, done — libraries like @x402/fetch do the loop for you.

curl — the payment challenge

# call without payment to inspect the 402 challenge
curl -i 'https://fetcher.sh/api/reddit/search/post?keyword=...'
# HTTP/1.1 402 Payment Required
# payment-required: <base64 payment requirements>

Prepaid credits

Top up once and every call is a plain HTTP request against your balance — no signing, no chain round trip. Generate a key.

curl — with your API key

curl -H 'Authorization: Bearer bby_live_...' \
  'https://fetcher.sh/api/reddit/search/post?keyword=...'

Response

Every endpoint returns the same envelope, and the HTTP status mirrors the status field. The upstream payload arrives untouched in data.

200 OK

{
  "status": 200,
  "message": "ok",
  "data": { }
}

All Reddit endpoints: /reddit · machine contract: openapi.json