Endpoint Playground

Try the Get GOAT search facet values API

Returns the accepted values for goat_search's filter parameters: categories, colors, genders, conditions, brands, and years are returned live so a value GOAT adds is discoverable without any client-side change, while product_types and activities are served from a maintained list because GOAT exposes no live facet for them. brands is GOAT's top brands ordered by product count, not the complete brand list -- when brands_truncated is true, brands beyond the ones listed exist and remain valid goat_search values.

What a live request returned

14 Oct 2026: Single record response; 9 fields had a value in every checked item.

Observed request: GET /goat/search/facets
Fields with a value in every checked item: categories, colors, genders, conditions, product_types, activities, brands, brands_truncated

Sample value profiles: brands_truncated: true; categories: 12 entries; colors: 18 entries.

Request: GET /goat/search/facets
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 98.1%, median 4.43 s
Monitored request: GET /goat/search/facets

Get GOAT search facet values API documentation GOAT platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/goat/search/facets' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

No request parameters

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      "footwear",
      "apparel",
      "accessories",
      "bags",
      "collectibles",
      "jewelry",
      "home",
      "media",
      "sports",
      "objects",
      "other",
      "art"
    ],
    "colors": [
      "black",
      "white",
      "blue",
      "grey",
      "green",
      "red",
      "multi-color",
      "brown",
      "pink",
      "cream",
      "tan",
      "purple",
      "yellow",
      "orange",
      "silver",
      "gold",
      "teal",
      "copper"
    ],
    "genders": [
      "men",
      "women",
      "youth",
      "infant"
    ],
    "conditions": [
      "new_no_defects",
      "used",
      "new_with_defects",
      "goat_clean"
    ],
    "product_types": [
      "sneakers",
      "sandals",
      "cleats",
      "boots",
      "slip-ons"
    ],
    "activities": [
      "lifestyle",
      "basketball",
      "running",
      "skateboarding"
    ],
    "brands": [
      "nike",
      "adidas",
      "new-balance",
      "puma",
      "supreme",
      "air-jordan"
    ],
    "brands_truncated": true,
    "years": [
      "2023",
      "2024",
      "2022",
      "2025",
      "2021",
      "2020"
    ]
  }
}

More GOAT endpoints

Get a GOAT curated product collection Get GOAT countries Get GOAT curated links Get GOAT live listing count Get GOAT product detail Get GOAT recommended products for a product Search GOAT products Get GOAT trending searches Autocomplete a GOAT search

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestgoat.facetsResponseDocGOAT

GET /goat/search/facets

Get GOAT search facet values

Response behavior

- Every live field reflects GOAT's vocabulary at request time -- treat this as the source of truth over any list hardcoded in other documentation, which can drift as GOAT adds values. - `brands` is GOAT's **top** brands, not its complete brand list. Upstream truncates the brand facet, and `brands_truncated` is `true` when that limit was hit. A brand missing from this list is still a valid `brands` value on `GET /goat/search` -- long-tail brands (for example single-product artists under the `art` category) simply never reach the top of the facet. Do not reject a caller-supplied brand for being absent here. - `years` matches a product's **season** year, which is the field `GET /goat/search`'s `years` parameter filters on. It is a superset of the release years GOAT shows elsewhere. - `product_types` and `activities` are maintained in this API rather than read live, so they can lag a GOAT change; every other field cannot. Example response (brand and year lists truncated for brevity): ```json { "code": 200, "msg": "OK", "data": { "categories": ["footwear", "apparel", "accessories", "bags", "collectibles", "jewelry", "home", "media", "sports", "objects", "other", "art"], "colors": ["black", "white", "blue", "grey", "green", "red", "multi-color", "brown", "pink", "cream", "tan", "purple", "yellow", "orange", "silver", "gold", "teal", "copper"], "genders": ["men", "women", "youth", "infant"], "conditions": ["new_no_defects", "used", "new_with_defects", "goat_clean"], "product_types": ["sneakers", "sandals", "cleats", "boots", "slip-ons"], "activities": ["lifestyle", "basketball", "running", "skateboarding"], "brands": ["nike", "adidas", "new-balance", "puma", "supreme", "air-jordan"], "brands_truncated": true, "years": ["2023", "2024", "2022", "2025", "2021", "2020"] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      "footwear",
      "apparel",
      "accessories",
      "bags",
      "collectibles",
      "jewelry",
      "home",
      "media",
      "sports",
      "objects",
      "other",
      "art"
    ],
    "colors": [
      "black",
      "white",
      "blue",
      "grey",
      "green",
      "red",
      "multi-color",
      "brown",
      "pink",
      "cream",
      "tan",
      "purple",
      "yellow",
      "orange",
      "silver",
      "gold",
      "teal",
      "copper"
    ],
    "genders": [
      "men",
      "women",
      "youth",
      "infant"
    ],
    "conditions": [
      "new_no_defects",
      "used",
      "new_with_defects",
      "goat_clean"
    ],
    "product_types": [
      "sneakers",
      "sandals",
      "cleats",
      "boots",
      "slip-ons"
    ],
    "activities": [
      "lifestyle",
      "basketball",
      "running",
      "skateboarding"
    ],
    "brands": [
      "nike",
      "adidas",
      "new-balance",
      "puma",
      "supreme",
      "air-jordan"
    ],
    "brands_truncated": true,
    "years": [
      "2023",
      "2024",
      "2022",
      "2025",
      "2021",
      "2020"
    ]
  }
}

Try the Get GOAT search facet values API

What a live request returned

14 Oct 2026: Single record response; 9 fields had a value in every checked item.

Observed request: GET /goat/search/facets
Fields with a value in every checked item: categories, colors, genders, conditions, product_types, activities, brands, brands_truncated

Sample value profiles: brands_truncated: true; categories: 12 entries; colors: 18 entries.

Request: GET /goat/search/facets
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 98.1%, median 4.43 s
Monitored request: GET /goat/search/facets

Get GOAT search facet values API documentation GOAT platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/goat/search/facets' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

No request parameters

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      "footwear",
      "apparel",
      "accessories",
      "bags",
      "collectibles",
      "jewelry",
      "home",
      "media",
      "sports",
      "objects",
      "other",
      "art"
    ],
    "colors": [
      "black",
      "white",
      "blue",
      "grey",
      "green",
      "red",
      "multi-color",
      "brown",
      "pink",
      "cream",
      "tan",
      "purple",
      "yellow",
      "orange",
      "silver",
      "gold",
      "teal",
      "copper"
    ],
    "genders": [
      "men",
      "women",
      "youth",
      "infant"
    ],
    "conditions": [
      "new_no_defects",
      "used",
      "new_with_defects",
      "goat_clean"
    ],
    "product_types": [
      "sneakers",
      "sandals",
      "cleats",
      "boots",
      "slip-ons"
    ],
    "activities": [
      "lifestyle",
      "basketball",
      "running",
      "skateboarding"
    ],
    "brands": [
      "nike",
      "adidas",
      "new-balance",
      "puma",
      "supreme",
      "air-jordan"
    ],
    "brands_truncated": true,
    "years": [
      "2023",
      "2024",
      "2022",
      "2025",
      "2021",
      "2020"
    ]
  }
}

Get GOAT search facet values

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "categories": [ "footwear", "apparel", "accessories", "bags", "collectibles", "jewelry", "home", "media", "sports", "objects", "other", "art" ], "colors": [ "black", "white", "blue", "grey", "green", "red", "multi-color", "brown", "pink", "cream", "tan", "purple", "yellow", "orange", "silver", "gold", "teal", "copper" ], "genders": [ "men", "women", "youth", "infant" ], "conditions": [ "new_no_defects", "used", "new_with_defects", "goat_clean" ], "product_types": [ "sneakers", "sandals", "cleats", "boots", "slip-ons" ], "activities": [ "lifestyle", "basketball", "running", "skateboarding" ], "brands": [ "nike", "adidas", "new-balance", "puma", "supreme", "air-jordan" ], "brands_truncated": true, "years": [ "2023", "2024", "2022", "2025", "2021", "2020" ] } }