Unmet demand

get/v1/analytics/unmet-demand

What shoppers asked for that the catalogue could not answer, most asked first: searches that found nothing, and things they named that no product matched. Phrases only; nothing ties one to a shopper or a session.

A search with unfiltered above zero still found nothing when its filters were dropped, so the catalogue does not carry it, rather than the filters being too narrow.

Private keyapi.v1.analytics.unmetDemandNo demo

Query parameters

2
daysinteger

How many days, ending today.

default: 3073090
limitinteger

Rows per list.

default: 25min: 1max: 100

Response

200The two lists.
timezonestringrequired

The timezone the days are counted in.

rangeintegerrequired

The number of days.

startDaystringrequired

The first day, YYYY-MM-DD.

endDaystringrequired

The last day, YYYY-MM-DD.

array<object>required

Searches that found nothing, by query text.

termstring

The query

countinteger

How many times.

unfilteredinteger

How many of those still found nothing with every filter dropped.

lastSeenstring (date-time)

When it was last asked.

array<object>required

Things shoppers named that no product matched, by term.

termstring

The term

countinteger

How many times.

lastSeenstring (date-time)

When it was last asked.

Errors

21

Every error is JSON with a single error string unless noted. Match on the status code; the message is for humans.

422
days must be one of 7, 30, 90.

days is something else.

422
limit must be a whole number from 1 to 100.

limit is not a whole number, or outside 1 to 100.

curl -X GET "https://stylor.ai/api/v1/analytics/unmet-demand" \
  -H "Authorization: Bearer $STYLOR_API_KEY"
Response · 200
{
  "timezone": "America/Denver",
  "range": 30,
  "startDay": "2026-09-05",
  "endDay": "2026-10-04",
  "searches": [
    {
      "term": "white cowboy boots",
      "count": 41,
      "unfiltered": 41,
      "lastSeen": "2026-10-04T15:02:44.000Z"
    }
  ],
  "misses": [
    {
      "term": "bolo tie",
      "count": 17,
      "lastSeen": "2026-10-03T21:40:10.000Z"
    }
  ]
}