## search/all `GET /v1/search/all` Cross-platform search as a pipeline: query intent detection, per-source entity resolution (handles are verified before account legs run), fan-out to live sources only, cross-source deduplication, relevance scoring with a floor, and per-source receipts (latency, cost, kept/dropped). A search with nothing relevant returns NO_USEFUL_SIGNAL and charges 0; partial source failures prorate the price. Set estimate=true for a free plan + max-cost preview. *Cross-platform search* | Parameter | Required | Description | | --- | --- | --- | | `query` | yes | What to search. Plain topics, "quoted phrases", @handles, owner/repo, domains and URLs are each understood. — e.g. `model context protocol` | | `estimate` | no | true returns the execution plan and maximum cost without running anything. Free. — e.g. `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. — e.g. `github,reddit,tiktok` | | `exclude` | no | Comma list of sources to leave out. — e.g. `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. — e.g. `true` | | `lookback_days` | no | Only results from the last N days, where the source supports it. — e.g. `7` | | `timeframe` | no | hour \| day \| week \| month \| year \| all — coarse alternative to lookback_days. Accepted values: hour, day, week, month, year, all. Case, spaces, hyphens and underscores are interchangeable. — e.g. `week` | | `from_date` | no | ISO date lower bound, where the source supports it. — e.g. `2026-01-01` | | `to_date` | no | ISO date upper bound, where the source supports it. — e.g. `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. — e.g. `1` | | `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` | | `subject_match` | no | Set context for Conversations discovery across explicitly selected sources. — e.g. `context` | | `subject_context` | no | Optional subject meaning, up to 240 characters. Requires subject_match=context. — e.g. `authentication software` | | `cursor` | no | Opaque continuation from a context search. Keep the original query, sources, context and date settings. | ### Useful optional inputs - `timeframe`: Choose the source time window relevant to your task. A narrower window is not a completeness guarantee or a price reduction. - `sources`: Restrict a multi-source request to the platforms useful for your task. Use dry_run to inspect the resulting quote before fetching. - `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees. **Cost:** 10 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key. ```bash curl "https://www.monocrawl.com/v1/search/all?query=model%20context%20protocol" \ -H "x-api-key: mn_your_key_here" ``` ### Response data Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed. ```json { "_meta": { "billing": { "charged": 0, "formula": "example", "list_price": 0 }, "intent": { "kind": "example", "terms": [ "example" ], "value": "example" }, "mosaic_version": "example", "queries": { "bluesky": "example", "github": "example", "hackernews": "example", "reddit": "example", "youtube": "example" }, "ranking": { "formula": "example", "min_relevance": 0, "source_weights": { "bluesky": 0, "github": 0, "hackernews": 0, "reddit": 0, "youtube": 0 } }, "timings": { "total_ms": 0 } }, "_warnings": [ "example" ], "clusters": [ { "item_indices": [ 0 ], "label": "example", "size": 0, "sources": [ "example" ] } ], "count": 0, "divergence": { "notes": [ { "detail": "example", "formula": "example", "kind": "example" } ], "per_source": [ { "items": 0, "median_relevance": 0, "newest_at": "2026-09-01T12:00:00Z", "source": "example", "top_engagement": 0 } ] }, "dropped_below_floor": 0, "items": [ { "also_seen_on": [ "example" ], "author": "example", "author_association": "example", "body": "example", "cid": "example", "closed_at": "2026-09-01T12:00:00Z", "comments": 0, "comments_count": 0, "confidence": { "reasons": [ "example" ], "score": 0 }, "created_at": "2026-09-01T12:00:00Z", "embed_type": "example", "hn_url": "https://example.com/example", "id": "example", "indexed_at": "2026-09-01T12:00:00Z", "is_pull_request": false, "is_reply": false, "labels": [ "example" ], "langs": [ "example" ], "likes": 0, "number": 0, "points": 0, "quotes": 0, "reactions": 0, "replies": 0, "reposts": 0, "rkey": "example", "source": "example", "state": "example", "story_id": "example", "text": "example", "title": "example", "type": "example", "updated_at": "2026-09-01T12:00:00Z", "url": "https://example.com/example" } ], "outcome": "example", "query": "example", "sources": [ { "error": "example", "items_found": 0, "items_kept": 0, "latency_ms": 0, "reason": "example", "served_by": "example", "source": "example", "status": "example" } ], "sources_attempted": 0, "sources_searched": 0 } ``` [Field reference](https://www.monocrawl.com/docs/endpoints/search/all#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/search/all.json)