Docs menu

GOAT API endpoint

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.

GETapiKey1 credit/requestGOATgoat.facetsResponseDoc/goat/search/facets

Endpoint facts

Method: GET
API path: /goat/search/facets
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: GOAT
Response schema: #/definitions/goat.facetsResponseDoc

GOAT API Try Get GOAT search facet values API in Playground GOAT API documentation

How this endpoint behaves

No parameters.

Response fields:

categories -- footwear, apparel, accessories, bags, collectibles, media, sports, jewelry, home, objects, other, art
colors -- black, white, blue, grey, red, green, pink, cream, brown, purple, multi-color, orange, tan, yellow, 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 -- brand slugs, ordered by product count descending
brands_truncated -- true when brands hit the upstream bucket limit
years -- season years, ordered by product count descending

Notable 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):

{
  "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"]
  }
}

Live monitoring

Monitored request: GET /goat/search/facets
Checks passed, 7 days to 14 Oct 2026: 98.1%
Median response time: 4.43 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /goat/search/facets
Fields returned with a value: 9

Field	In the sample	Value in the sample
categories	Has a value	12 entries
colors	Has a value	18 entries
genders	Has a value	4 entries
conditions	Has a value	4 entries
product_types	Has a value	5 entries
activities	Has a value	4 entries
brands	Has a value	500 entries
brands_truncated	Has a value	true
years	Has a value	70 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

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

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"
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/goat.facetsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	goat.SearchFacetsResponse	No
data.activities	array	No	lifestyle,basketball,running,skateboarding
data.brands	array	No	nike,adidas,new-balance,puma,supreme	Brands is ordered by product count descending and is GOAT's top brands, not its whole brand universe -- upstream truncates this bucket (see BrandsTruncated).
data.brands_truncated	boolean	No	true	BrandsTruncated reports that upstream returned its maximum brand bucket size, so brands beyond it exist but are not listed. A brand missing from Brands is still a valid goat_search brands value.
data.categories	array	No	footwear,apparel,accessories,bags,collectibles,media,sports,jewelry,home,objects,other,art
data.colors	array	No	black,white,blue,grey,red,green,pink,cream,brown,purple,multi-color,orange,tan,yellow,silver,gold,teal,copper
data.conditions	array	No	new_no_defects,used,new_with_defects,goat_clean
data.genders	array	No	men,youth,infant,women
data.product_types	array	No	sneakers,sandals,cleats,boots,slip-ons	ProductTypes and Activities are statically maintained, not live -- GOAT never returns them as aggregation buckets.
data.years	array	No	2026,2025,2024,2023	Years is the vocabulary for goat_search's years parameter, which filters on a product's season year.
msg	string	No	OK

Failure responses

Status	Description	Schema
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

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

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More GOAT endpoint docs GOAT API GOAT Collection API documentation Get GOAT countries API documentation Get GOAT curated links API documentation Get GOAT live listing count API documentation Get GOAT product detail API documentation GOAT Recommended Products API documentation

Open in Playground Back to group

Docs menu

GOAT API endpoint

Get GOAT search facet values API

GETapiKey1 credit/requestGOATgoat.facetsResponseDoc/goat/search/facets

Endpoint facts

Method: GET
API path: /goat/search/facets
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: GOAT
Response schema: #/definitions/goat.facetsResponseDoc

GOAT API Try Get GOAT search facet values API in Playground GOAT API documentation

How this endpoint behaves

No parameters.

Response fields:

categories -- footwear, apparel, accessories, bags, collectibles, media, sports, jewelry, home, objects, other, art
colors -- black, white, blue, grey, red, green, pink, cream, brown, purple, multi-color, orange, tan, yellow, 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 -- brand slugs, ordered by product count descending
brands_truncated -- true when brands hit the upstream bucket limit
years -- season years, ordered by product count descending

Notable 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):

{
  "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"]
  }
}

Live monitoring

Monitored request: GET /goat/search/facets
Checks passed, 7 days to 14 Oct 2026: 98.1%
Median response time: 4.43 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /goat/search/facets
Fields returned with a value: 9

Field	In the sample	Value in the sample
categories	Has a value	12 entries
colors	Has a value	18 entries
genders	Has a value	4 entries
conditions	Has a value	4 entries
product_types	Has a value	5 entries
activities	Has a value	4 entries
brands	Has a value	500 entries
brands_truncated	Has a value	true
years	Has a value	70 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

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

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"
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/goat.facetsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	goat.SearchFacetsResponse	No
data.activities	array	No	lifestyle,basketball,running,skateboarding
data.brands	array	No	nike,adidas,new-balance,puma,supreme	Brands is ordered by product count descending and is GOAT's top brands, not its whole brand universe -- upstream truncates this bucket (see BrandsTruncated).
data.brands_truncated	boolean	No	true	BrandsTruncated reports that upstream returned its maximum brand bucket size, so brands beyond it exist but are not listed. A brand missing from Brands is still a valid goat_search brands value.
data.categories	array	No	footwear,apparel,accessories,bags,collectibles,media,sports,jewelry,home,objects,other,art
data.colors	array	No	black,white,blue,grey,red,green,pink,cream,brown,purple,multi-color,orange,tan,yellow,silver,gold,teal,copper
data.conditions	array	No	new_no_defects,used,new_with_defects,goat_clean
data.genders	array	No	men,youth,infant,women
data.product_types	array	No	sneakers,sandals,cleats,boots,slip-ons	ProductTypes and Activities are statically maintained, not live -- GOAT never returns them as aggregation buckets.
data.years	array	No	2026,2025,2024,2023	Years is the vocabulary for goat_search's years parameter, which filters on a product's season year.
msg	string	No	OK

Failure responses

Status	Description	Schema
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

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

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Get GOAT search facet values API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Get GOAT search facet values API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related