ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceDiscoveryFilter values

Filter values

GET/api/v1/facets/{facet}

Every value a filter accepts, with live counts: niches, platforms, formats, countries, languages, shop platforms, Shopify apps, technologies, themes and email types. Agents should read these instead of guessing ids.

Bearer API keyMCP tool list_facets

Path parameters

facetstringrequired

One of niches, platforms, formats, countries, languages, shop-platforms, shop-apps, technologies, themes, email-campaign-types, email-promotion-types.

Query parameters

searchstring

Case-insensitive substring filter.

limitintegerdefault 100

1–500.

Try it

GET/api/v1/facets/niches
curl "https://provly.co/api/v1/facets/niches" \
  -H "Authorization: Bearer $PROVLY_API_KEY"
200 · Response
{
  "data": [
    {
      "value": "pet-supplies",
      "count": 18234
    },
    {
      "value": "beauty-care",
      "count": 51210
    }
  ],
  "meta": {
    "facet": "niches",
    "total": 18
  }
}