SUsugra
Research

Describe one official statistics indicator

Changed on

Returns one indicator of the Sugra statistics catalog: its name, unit, usual period, the Sugra direction it belongs to, the place types that have data, the first and last period and the agencies that publish it, each with its website. Pass an agency code as agency= to /series or /places to pick that agency's numbers.

get/api/v1/statistics/indicators/{indicator}

Request

  • Base URL
    https://sugra.ai
  • URL
    https://sugra.ai/api/v1/statistics/indicators/{indicator}
  • Auth
    API key in header x-api-key

Path parameters

indicatorstring required

Sugra indicator code.

Example:median-household-income

Response

The indicator and the agencies that publish it.

Example response

{
  "data": {
    "indicator": "median-household-income",
    "name": "Median household income",
    "unit": "USD",
    "period": "annual",
    "direction": "Macro",
    "place_types": [
      "country",
      "state",
      "county"
    ],
    "first": "2010",
    "last": "2024",
    "sources": [
      {
        "id": "census-bureau",
        "name": "U.S. Census Bureau",
        "url": "https://www.census.gov/",
        "method": "ACS 5-year estimate"
      }
    ]
  },
  "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