Filter and Sort

Execute a search query with filtering and sorting capabilities against Elasticsearch indices.

This endpoint is the primary structured search method. Use it when you need exact-match filters, range queries, and field-based ordering.

Filter Logic:

• include array: filters that must ALL match (AND logic). A document must satisfy every filter to be included.
• exclude array: filters that must NOT match (NOT logic). A document matching any exclude filter is removed.
• Combined: (include[0] AND include[1] AND ...) AND NOT (exclude[0] OR exclude[1] OR ...)

Sorting: The sort_by parameter orders results by a numeric or date field. Without sort_by, results are ordered by Elasticsearch relevance score.

Available Indices:

• farcaster-items — Social posts from the Farcaster protocol
• polymarket-items — Prediction market contracts from Polymarket
• polymarket-wallets — User wallets and profiles from Polymarket
• zora-coins — Creator coins from the Zora platform

Refer to the Filter schema for the complete list of available filter types and per-index field mappings.