Paginate Reddit Keyword Search with a Fixed API Budget

Fetch page one, then use page.next_cursor exactly as returned if you need another page. Set a total page cap and a per-call price cap before starting.

Documentation reviewed: 2026-11-14 · By PostToData

Choose the required sample

For a recent-post digest, use the same query, sort=latest and limit on every page. Copy the cursor from the response. A page counter such as 2 is not a substitute for the returned token.

Approve page count and price together

For two pages, multiply the quoted unit price by two before starting. Set max_price_usd on each request. Successful pages are separate calls, even if the second page is short or contains duplicates.

Stop when the next page is unnecessary

End the run on an empty cursor, a repeated cursor, the agreed page limit or any error. Deduplicate with data.items[].id without losing source URLs. Keep successful pages and their request IDs for review before deciding to retry a failed page.

Example sources and documentation

Current prices & implemented operations

OperationPer successful call1,000 successful calls
Reddit · Search posts$0.003$3.00

The 1,000-call figure is list price multiplied by calls, not 1,000 records or a top-up package. The example only previews the first operation: no upstream fetch or charge. To retrieve data, remove dry_run=1 and supply Authorization: Bearer API_KEY. Keep max_price_usd to reject a price above the approved amount.

Free price preview
curl --get "https://posttodata.com/v1/reddit/search" \
  --data-urlencode 'query=standing desk' \
  --data-urlencode 'limit=10' \
  --data-urlencode 'sort=latest' \
  --data-urlencode 'max_price_usd=0.003' \
  --data-urlencode 'dry_run=1'

A per-call ceiling is not a shared budget for the whole task. Bound the number of approved calls and stop on 402, 412 or 429; do not automatically raise limits or rotate accounts.

Frequently asked questions

Does limit=20 mean I get exactly 20 new posts?

It is a requested upper bound. The source can return fewer rows, and consecutive pages may overlap.

Related guides

Browse all guides →