Endpoint
GET/v1/search/alllive · proven10 creditsParameters
Query parameters
| Name | Required | Description | Example |
|---|---|---|---|
query | yes | What to search. Plain topics, "quoted phrases", @handles, owner/repo, domains and URLs are each understood. | model context protocol |
estimate | no | true returns the execution plan and maximum cost without running anything. Free. | true |
sources | no | Comma list restricting the fan-out. Default sources (github, hackernews, reddit, bluesky, youtube) run unless excluded; metered sources (tiktok, instagram, linkedin, threads, pinterest, x) run ONLY when named here; free niche lanes (polymarket, google_news) also run only when named. A leg that cannot serve the query kind is skipped with the reason in the receipts. Unknown names are ignored with a warning; 'twitter' is accepted for x. | github,reddit,tiktok |
exclude | no | Comma list of sources to leave out. | bluesky |
comments | no | true fetches the top comments for the top results, cited per item under top_comments — only from sources with a live comment endpoint (reddit, hackernews, youtube; tiktok/instagram when opted in via sources=). Enrichment receipts land in the enrichment section; failures degrade per item. | true |
lookback_days | no | Only results from the last N days, where the source supports it. | 7 |
timeframe | no | hour | day | week | month | year | all — coarse alternative to lookback_days. | week |
from_date | no | ISO date lower bound, where the source supports it. | 2026-01-01 |
to_date | no | ISO date upper bound, where the source supports it. | 2026-03-01 |
stream | no | 1 answers text/event-stream: plan, source-started, source-completed, cost and enrichment progress events as legs actually run, then one final result event carrying the exact envelope a plain call returns — same billing, same receipts. | 1 |
Examples
Make the request
curl
curl "https://www.monocrawl.com/v1/search/all?query=model%20context%20protocol" \ -H "x-api-key: mn_your_key_here"
TypeScript
typescript
const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
"https://www.monocrawl.com/v1/search/all?query=model%20context%20protocol",
{ headers: { "x-api-key": key } },
);
const body = await res.json();
if (!body.success) {
// one error shape for every endpoint — see /docs/errors
throw new Error(`${body.error.type}: ${body.error.message}`);
}
console.log(body.data, "credits left:", body.credits_remaining);Python
python
import os
import requests
res = requests.get(
"https://www.monocrawl.com/v1/search/all?query=model%20context%20protocol",
headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
timeout=60,
)
body = res.json()
if not body["success"]:
# one error shape for every endpoint — see /docs/errors
raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")
print(body["data"], "credits left:", body["credits_remaining"])Response
One envelope across every endpoint
This illustrative envelope is not a live response or a payload schema. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.
200 · application/json
{
"success": true,
"platform": "search",
"endpoint": "/v1/search/all",
"data": { "…": "platform-specific fields" },
"credits_used": 10,
"credits_remaining": 99,
"request_id": "req_…",
"cached": false
}Failures return the shared typed error envelope and cost nothing. Response contract · Error reference