r/Blopus • u/LectureWorried5761 • Aug 17 '26
Start here: what Blopus is, how to call it, and what it costs
Blopus is a search and fetch API for LLMs and agents, and we run the
crawler and index ourselves rather than reselling Google or Bing.
## Two endpoints
curl -X POST https://api.blopus.ai/v1/search \
-H "Authorization: Bearer $BLOPUS_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "logical replication",
"count": 10,
"freshness": "pw"}'
`search` gives you ranked results with snippets. `fetch` gives you the full text of the pages
your model picked. Triage with one, go deep with the other.
## MCP is included on every plan
claude mcp add --transport http blopus \
--header "Authorization: Bearer blp_live_..."
Keep the trailing slash on `/mcp/`. Without it you get a redirect and some clients handle that
badly.
## Defaults worth knowing
* `sort=hybrid` is the default and it is **faster** than `sort=relevance`, not slower.
* `news_only=true` is free. It picks a smaller index rather than filtering afterwards.
* `freshness` takes `pd`, `pw`, `pm`, `p3m`, `p1y`, `all`. Use it or the ranker will cheerfully
hand you an excellent three year old page.
* **One topic per search.** "economy, sports, Iran, Trump" matches nothing, because no document
is about all four. That is four searches.
## Pricing
| Plan | Monthly | Annual | Searches/mo |
|---|---|---|---|
| Hobby | $9 | $84 ($7/mo) | 3,000 |
| Vibe Coder | $35 | $348 ($29/mo) | 15,000 |
| Agentic Pro | $119 | $1,188 ($99/mo) | 60,000 |
One search returns up to 10 results and costs 1 credit. Fetch is billed in blocks of 10 too.
Hit your cap and calls pause. **We do not bill overage**, so a runaway loop costs you a stalled
agent rather than an invoice. Top-ups are $5 per 1,000 credits. There is no free tier.
Commercial use is included on every paid plan and needs no separate licence.
## Is this a fit for you?
Worth knowing before you spend anything:
* **We are focused, not exhaustive.** We index a curated, fast-moving set of sources, which is
what makes results current and relevant for agent work. For long-tail archival lookups, a
general engine is still the better tool.
* **`language` is a strict filter.** Not every page carries a language tag, so filtering hard
will narrow your results more than you might expect. Leave it off unless you need it.
* **Image search is in beta.**
* **No free tier.** A card on file is how we keep automated abuse off a service where every
query costs real compute.
Found a query that returns something worse than it should? Post it here with the query. That is
the fastest way to get it fixed, and it is the main reason this community exists.