list_filter_options

Returns the values a filter accepts, so the assistant can build a valid search. Assistants usually call it before a search, for example to turn “pet products” into the exact niche name. Cost: free.

Arguments

Argument	Type	Allowed values
`kind`	enum	`niches`, `countries`, `languages`, `currencies`, `domains`, `pixels`, `social_networks`, `themes`, `apps`, `media_types`, `ctas`, `shop_sort_options`, `product_sort_options`, `ad_sort_options`. Required.
`query`	string	For `kind: "apps"` only: text to search app names (1 to 100 characters). Optional.
`page`	integer	For `kind: "apps"` only: page of 50 app names, 1 to 20. Default: `1`. Check `has_more` for the next page.

Kind	Returns	Used by
`niches`	Niche tree: `{ id, name, sub_niches: [{ id, name }] }`	`niches` in every search tool
`countries`	ISO 3166-1 alpha-2 codes offered by the dashboard	`countries`
`languages`	Storefront languages	`languages`
`currencies`	ISO 4217 codes	`currencies`
`domains`	Domain extensions	`domains`
`pixels`	Tracking pixels	`pixels`
`social_networks`	Social networks	`social_networks`
`themes`	The 100 most used Shopify themes	`themes`
`apps`	50 Shopify app names per page, matching `query` when given	`apps`
`media_types`	Ad formats	`media_types` in `search_ads`
`ctas`	Ad call-to-action buttons	`ctas` in `search_ads`
`shop_sort_options`	`sort_by` values of `search_shops`	`search_shops`
`product_sort_options`	`sort_by` values of `search_products`	`search_products`
`ad_sort_options`	`sort_by` values of `search_ads`	`search_ads`

Example

Tool call

{
  "name": "list_filter_options",
  "arguments": { "kind": "niches" }
}

Result (trimmed)

{
  "kind": "niches",
  "values": [
    {
      "id": 4,
      "name": "Health",
      "sub_niches": [{ "id": 40, "name": "Fitness" }]
    }
  ]
}

Search Shopify apps by name:

Tool call

{
  "name": "list_filter_options",
  "arguments": { "kind": "apps", "query": "review" }
}

Result (trimmed)

{ "kind": "apps", "values": ["Judge.me Product Reviews", "Loox Product Reviews & Photos"], "page": 1, "has_more": false }

Static values

These lists are fixed. Niches, themes, and apps come from Copyfy’s live data, so call the tool to get them.

Countries

US, GB, CA, AU, FR, DE, NL, BE, ES, IT, CH, AT, IE, NZ, SE, NO, DK, FI, PL, PT, JP, KR, CN, SG, HK, AE, SA, BR, MX, IN, ZA, RU, TR, TH, ID, MY, PH, VN, AR, CO, CL, PE, EC, VE, UY, PY, BO, CR, PA, GT, HN, SV, NI, DO, CU, PR, JM, TT, GR, CZ, HU, RO, BG, HR, SK, SI, RS, UA, BY, LT, LV, EE, IL, EG, MA, TN, DZ, NG, KE, GH, TW, PK, BD, LK, NP, MM, KH, LA, QA, KW, OM, BH, JO, LB, CY, LU, MT, IS, MC

Languages

English, French, Spanish, German, Italian, Portuguese, Dutch, Polish, Norwegian, Swedish, Danish, Finnish, Chinese, Japanese, Korean, Arabic, Russian, Turkish, Hindi, Thai, Vietnamese, Indonesian, Greek, Czech, Hungarian, Romanian

Currencies

USD, EUR, GBP, CAD, AUD, CHF, JPY, CNY, INR, BRL, MXN, KRW, SEK, NOK, DKK, PLN, NZD, SGD, HKD, TRY, AED, SAR, MAD, ZAR, THB, IDR, MYR, PHP, VND, CZK, HUF, RON

Domain extensions

.com, .store, .shop, .co, .net, .io, .uk, .co.uk, .au, .ca, .de, .fr, .es, .it, .nl, .be, .ch, .at, .se, .no, .dk, .pl, .pt, .nz, .ie

Pixels

TikTok, Snapchat, Facebook, Instagram, Google, Twitter, Pinterest, Reddit, TripleWhale, Applovin

Ad media types

video, image, carousel, dco, dpa

Ad calls to action

Shop Now, Learn More, Buy Now, Order Now, Get Offer, Call Now, View product, Sign Up, Download, Watch More, Contact Us, Book Now, Get Quote, Subscribe

Store sort options

recommended, revenue, traffic, traffic_growth, active_ads, products_count, newest

Product sort options

recommended, revenue, orders, traffic, traffic_growth, active_ads, price, newest

Ad sort options

recommended, newest, oldest, reach, revenue, traffic, traffic_growth

Get started

Connect a client

Account

Tools reference

Guides

Help

list_filter_options

Arguments

Example

Static values

​Arguments

​Example

​Static values

Arguments

Example

Static values