API reference
Fetch
Read the stored, cleaned content of a page from the Blopus index — one URL, or up to 50 in a single batch.
POSThttps://api.blopus.ai/v1/fetch
Fetch reads our stored index — it is not a live crawl. You get the cleaned content Blopus already has for a URL, which is fast and consistent. If a page isn't in the index, it's returned as a not-found result (and not billed).
Single fetch#
Pass one url. Billing: 1 credit.
Single response#
Batch fetch#
Pass a urls array (cap 50) to retrieve many pages in one multi-get request. Provide either url or urls — not both.
Batch response#
Found pages come back in results[]; misses in failed_results[]. count is the number found; credits billed are ceil(count / 10).
Billing#
| Call | Credits |
|---|---|
Single url | 1 credit |
Batch urls | 1 credit per block of 10 found URLs. Fetching 10 costs the same as fetching 1 — always batch. URLs we do not hold return in failed_results and are free. |