Skip to main content

​
Trend Baskets

Returns the catalogue of trend baskets configured for a geography, along with their keyword compositions. Use this to understand which consumer intent search data baskets drive the scores returned by the Trends endpoint.
The keywords array is redacted (returned as an empty array) unless your account is on the Enterprise tier.

​
Endpoint

GET /api/trends/baskets

​
Authentication

Requires a valid JWT passed via the Authorization header.

​
Query Parameters

​
geography
string
required
ISO 3166-1 alpha-2 country code (e.g. US, UK).

​
Response

​
geography
string
The geography these baskets apply to.
​
baskets
array
Array of basket definitions.
​
count
number
Number of baskets returned.

​
Code Examples

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

​
Example Response

{
  "geography": "US",
  "baskets": [
    {
      "id": "discount_seeking",
      "label": "Discount Seeking",
      "keywords": [],
      "geo": "US"
    },
    {
      "id": "trade_down",
      "label": "Trade Down",
      "keywords": [],
      "geo": "US"
    },
    {
      "id": "credit_stress",
      "label": "Credit Stress",
      "keywords": [],
      "geo": "US"
    }
  ],
  "count": 3
}