search_datasets_v1_search_get
Search across datasets using full-text, semantic, or hybrid modes. Filter by provider, format, category, and status, with multiple sort options.
Instructions
GET /v1/search (public) — Search Datasets — Search across all datasets using full-text search.
Searches dataset names, descriptions, provider names, and column names. Results are ranked by relevance using PostgreSQL's FTS capabilities.
Search Modes:
keyword: Traditional FTS with tsvector matchingsemantic: Embedding-based similarity search (conceptual matching)hybrid: Combines both using Reciprocal Rank Fusion (RRF)
Query Syntax:
inflation- simple term search"consumer price index"- exact phrase searchcensus -historical- exclude terminflation OR unemployment- alternative terms
Sort Options:
relevance: FTS ranking (default when query provided)recency: Most recently updated firstname: Alphabetical by dataset name`populari…
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search query. Supports Google-style syntax: quotes for phrases, - to exclude, OR for alternatives. | |
| mode | No | Search mode: 'keyword' for FTS only, 'semantic' for embedding similarity, 'hybrid' for both combined with RRF fusion. | |
| provider | No | Filter by provider slug (e.g., 'bls', 'census') | |
| format | No | Filter by data format (e.g., 'csv', 'json') | |
| category | No | Filter by category tag | |
| status | No | Filter by dataset status. Defaults to 'ready' to show only queryable datasets. | |
| sort | No | Sort order for results. Options: 'relevance' (FTS ranking), 'recency' (updated_at), 'name' (alphabetical), 'popularity' (stars), 'trending' (time-decayed activity), 'queries' (query count), 'downloads' (download count). | |
| time_range | No | Time range for period-based metrics (trending, queries, downloads). Options: 'today', 'week', 'month', 'year', 'all_time'. Defaults to 'week' for trending sort, 'all_time' otherwise. | |
| limit | No | Maximum number of results to return (1-100) | |
| offset | No | Number of results to skip for pagination |