Skip to main content

​
Census MARTS

Returns Census Bureau Monthly Advance Retail Trade Survey (MARTS) data, providing an official retail-sales baseline for consumer-signal interpretation. Use this alongside trend data to ground search-signal analysis in hard government statistics.

​
Endpoint

GET /api/census-marts

​
Authentication

Requires a valid JWT passed via the Authorization header.

​
Query Parameters

​
geography
string
required
ISO 3166-1 alpha-2 country code. Currently supports US.

​
Response

​
geography
string
Geography queried.
​
series
array
Array of monthly MARTS observations.
​
lastUpdated
string
ISO 8601 timestamp of the most recent data refresh.

​
Code Examples

curl -X GET "https://api.consumersignals.io/api/census-marts?geography=US" \
  -H "Authorization: Bearer <token>"

​
Example Response

{
  "geography": "US",
  "series": [
    {
      "month": "2026-03",
      "totalRetailSales": 623400,
      "yoyChange": 3.2,
      "momChange": 0.8,
      "categories": {
        "motor_vehicles": 112500,
        "food_beverage": 78200,
        "general_merchandise": 62100,
        "nonstore_retailers": 98700
      }
    },
    {
      "month": "2026-02",
      "totalRetailSales": 618500,
      "yoyChange": 2.9,
      "momChange": -0.4,
      "categories": {
        "motor_vehicles": 111200,
        "food_beverage": 77800,
        "general_merchandise": 61500,
        "nonstore_retailers": 97300
      }
    }
  ],
  "lastUpdated": "2026-03-28T12:00:00Z"
}