Find official statistics indicators by meaning

GET

/api/v1/statistics/search

Last modified:2026-11-01 18:58:30

Maintainer:Not configured

OperationId:statistics_search

Searches the Sugra statistics catalog by meaning and returns matching indicators, best first, with their name, unit, period, the place types that have data, the first and last period and the agencies that publish them. Optional place keeps only indicators with data for that type of place. Use the indicator code with /series/{indicator} or /places/{indicator}.

Request

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sugra.ai/api/v1/statistics/search?q=undefined&place=undefined&limit=undefined' \
--header 'x-api-key:   ABCD314159'

Responses

🟢200OK

application/json

Matching indicators with a match score from 0 to 1.

Bodyapplication/json

Example

{
    "data": {
        "results": [
            {
                "indicator": "median-household-income",
                "name": "Median household income",
                "unit": "string",
                "period": "annual",
                "place_types": [
                    "string"
                ],
                "first": "string",
                "last": "string",
                "sources": [
                    {
                        "id": "census-bureau",
                        "name": "U.S. Census Bureau"
                    }
                ],
                "score": 0.97
            }
        ]
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "data_age_days": 0,
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true,
        "stale_since": "string",
        "period": "string",
        "notes": "string"
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴500Server Error

🔴503Service Unavailable

Modified at 2026-11-01 18:58:30

Population-only isolated time series for one country

Describe one official statistics indicator