Skip to main content
GET /api/v2/search is the default discovery route. Use it when the question is a topic (“what are writers saying about AI capex?”) rather than a ticker, person, or named publication. Requires an active plan on the account mount; wallet agents use GET /api/v2/x402/search with a zero-dollar identity proof. Results are candidates — ranked post cards with priceCents. The synthesizedSummary still comes from the paid post route. MCP: search_posts. This page covers Discover only. A full integration also wires Read (paid summaries) and Analyze (stock picks).

Request

q is required (minimum 2 characters). Default limit is 10.
Do not combine a platform that conflicts with source (for example platform=podcast with source=newsletter) — that returns 400. publishedAfter must not be later than publishedBefore. Search starts with publications curated for chat and can fall back to other indexed publications when the initial matches are weak. publicationSlug restricts the search to that publication. Disabled publications are excluded from returned items.

Response

Items carry publicationSlug, slug, title, subtitle, publishedAt, priceCents, and snippet fields. Present items as candidates and keep each item’s publicationSlug + slug — they address the paid post route.

Errors

400 invalid query or incompatible filters, 500 search failure (retry).