> ## Documentation Index
> Fetch the complete documentation index at: https://docs.copyfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# list_filter_options

> List the valid values for a Copyfy filter: niches, countries, languages, currencies, domains, pixels, social networks, themes, apps, and sort 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

```json Tool call theme={null}
{
  "name": "list_filter_options",
  "arguments": { "kind": "niches" }
}
```

```json Result (trimmed) theme={null}
{
  "kind": "niches",
  "values": [
    {
      "id": 4,
      "name": "Health",
      "sub_niches": [{ "id": 40, "name": "Fitness" }]
    }
  ]
}
```

Search Shopify apps by name:

```json Tool call theme={null}
{
  "name": "list_filter_options",
  "arguments": { "kind": "apps", "query": "review" }
}
```

```json Result (trimmed) theme={null}
{ "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.

<AccordionGroup>
  <Accordion title="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`
  </Accordion>

  <Accordion title="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`
  </Accordion>

  <Accordion title="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`
  </Accordion>

  <Accordion title="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`
  </Accordion>

  <Accordion title="Pixels">
    `TikTok`, `Snapchat`, `Facebook`, `Instagram`, `Google`, `Twitter`, `Pinterest`, `Reddit`, `TripleWhale`, `Applovin`
  </Accordion>

  <Accordion title="Social networks">
    `Facebook`, `Instagram`, `TikTok`, `YouTube`, `Pinterest`, `Twitter`, `Snapchat`, `Reddit`
  </Accordion>

  <Accordion title="Ad media types">
    `video`, `image`, `carousel`, `dco`, `dpa`
  </Accordion>

  <Accordion title="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`
  </Accordion>

  <Accordion title="Store sort options">
    `recommended`, `revenue`, `traffic`, `traffic_growth`, `active_ads`, `products_count`, `newest`
  </Accordion>

  <Accordion title="Product sort options">
    `recommended`, `revenue`, `orders`, `traffic`, `traffic_growth`, `active_ads`, `price`, `newest`
  </Accordion>

  <Accordion title="Ad sort options">
    `recommended`, `newest`, `oldest`, `reach`, `revenue`, `traffic`, `traffic_growth`
  </Accordion>
</AccordionGroup>