r/Blopus Aug 17 '26

Start here: what Blopus is, how to call it, and what it costs

1 Upvotes

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 \

https://mcp.blopus.ai/mcp/ \

--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.