AI Search

Valid AI-search filters for your region

Changed on

The filter vocabulary the /ai-search/* endpoints accept for your shop's region — call this before building a filters payload rather than guessing at keys or enum spellings.

filters maps each categorical field (product categories, follower age and gender, content language, production quality, face visibility, hasEmail, …) to its allowed {label, value} options. creatorLevel options additionally carry min and max — the half-open [min, max) GMV band that level stands for, so you can map a gmv range onto levels without hardcoding our thresholds. A side is OMITTED where the band is unbounded (the lowest level has no min, the highest no max), and the All option carries neither. No other filter's options carry them at all. When mapping, mind that the gmv filter's own max is INCLUSIVE while a band's is exclusive, so a range ending exactly on a threshold also overlaps the level above it.

sliders gives the numeric ranges — min, max and step for averageViews, engagementRate, gmv, unitsSold, postRate and followers.

The response is region-stripped: a filter whose backing column has effectively no data in your region is omitted entirely, because applying it would return zero creators regardless of the range. postRate is absent for most non-US/UK regions and the community hashtag filter is absent where the hashtag pipeline hasn't tagged enough creators — treat anything missing here as unsupported for your shop.

Region comes from the shop, so this needs a single x-shop-id.

get/ai-search/filters

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/ai-search/filters
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Response

Successful Response

region'US' | 'UK' | 'IT' | 'ES' | 'DE' | 'FR' | 'IE' | 'MX' | 'BR' | 'JP' | 'NL' | 'AT' | 'BE' | 'CZ' | 'GR' | 'HU' | 'PL' | 'PT' required
filtersobject required
slidersobject required

Changes

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status