Searches curated indicators by text, concept, and country.
Endpoint
GET /api/indicators/search
Query Parameters
| Name | Type | Description |
|---|---|---|
q | string | Full-text query. |
concept | string | Optional standardized concept key. Invalid concept keys return 404. |
country | ISO country code | Narrows results to country-specific variants when available. |
preferredCountry | ISO country code | Ranking hint for generic searches. Ignored when country is set or the text query names a country. |
limit | number | Maximum result count. Non-numeric values are ignored. |
Example
GET /api/indicators/search?q=inflation&country=US&limit=10
Response
The response is the same programmatic search surface used by the indicator library UI. It includes matching indicators, concept metadata, country availability where available, and release-family summaries.
preferredCountryCode is returned when a country preference was applied as a
ranking hint. It is not a filter; use country when you need country-scoped
results only.
Relevance Disclosure
Search relevance is benchmarked separately in docs/search-relevance-baseline.md.
The API returns ranked matches; callers should not treat every result as a
perfect semantic match.