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 carrypublicationSlug, 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).
