SUsugra
Research

Find official statistics indicators by meaning

Changed on

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}.

get/api/v1/statistics/search

Request

  • Base URL
    https://sugra.ai
  • URL
    https://sugra.ai/api/v1/statistics/search
  • Auth
    API key in header x-api-key

Query parameters

qstring required

What to look for, in plain words.

Example:median household income
placestring nullable

Optional place code; keeps indicators with data for that type of place.

Example:USA
limitinteger

Maximum number of results.

Response

Matching indicators with a match score from 0 to 1.

Example response

{
  "data": {
    "results": [
      {
        "indicator": "median-household-income",
        "name": "Median household income",
        "unit": "USD",
        "period": "annual",
        "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": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes