Docs menu

GOAT API endpoint

GOAT Collection API

Returns a page of one of GOAT's curated product collections (an editorial rail like "top trending" or "new arrivals"), as shown in GOAT's own product-page "you may also like" rails and homepage modules. Collection slugs are not enumerable by this API -- capture one from a live GOAT page.

GETapiKey2 credits/requestGOATgoat.collectionResponseDoc/goat/collection

Endpoint facts

Method: GET
API path: /goat/collection
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: GOAT
Response schema: #/definitions/goat.collectionResponseDoc

GOAT API Try GOAT Collection API in Playground GOAT API documentation

How this endpoint behaves

Query parameters:

slug (required) — GOAT collection slug, e.g. as seen in a curated rail on GOAT's own site (top-trending-uk, top-sneaker-collabs, back-to-school-2026, ...). Collection slugs are not enumerable by this API — capture one from a live GOAT page (a product page's related rails, or the homepage).
page (optional) — 1-indexed result page. Defaults to 1.
limit (optional) — results per page. Defaults to 12, maximum 100.
exclude_product_ids (optional) — omit specific products by id, comma-separated. Useful when showing a collection alongside a product you do not want repeated (the same thing GOAT's own product page does with its "you may also like" rails).

Notable response behavior:

total_results reflects the collection's full item count, not just len(products).
An unknown slug returns 404.

Sampled response

Request, 14 Oct 2026: GET /goat/collection?limit=12&slug=top-trending-uk
Items in products: 12
Fields filled in every checked item: 6
Fields empty in some or all items: 1

Field	Filled in, of 12 checked	Values in the sample
id	12
slug	12
title	12	“Air Jordan 4 Retro 'Rare Air - White Lettering'” and 11 other values
image_url	12	image.goat.com
category	12	shoes in all 12
release_year	10	2,023 to 2,025, median 2,025
source_url	12	goat.com

Request parameters

Parameter	Type	Required	Default	Description	Example
slug	string	Yes		GOAT collection slug, e.g. as seen in a curated rail on GOAT's own site	top-trending-uk
page	integer	No	1	1-indexed result page, defaults to 1	1
limit	integer	No	12	Results per page, defaults to 12, maximum 100	12
exclude_product_ids	string	No		Omit specific products by id, comma-separated	1481726
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/goat/collection?slug=top-trending-uk&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "slug": "top-trending-uk",
    "page": 1,
    "limit": 12,
    "total_results": 395,
    "products": [
      {
        "id": "1481726",
        "slug": "air-jordan-4-retro-rare-air-fv5029-003",
        "title": "Air Jordan 4 Retro 'Rare Air - White Lettering'",
        "image_url": "https://image.goat.com/attachments/product_template_pictures/images/110/905/352/original/1481726_00.png.png",
        "category": "shoes",
        "release_year": "2025",
        "source_url": "https://www.goat.com/sneakers/air-jordan-4-retro-rare-air-fv5029-003"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/goat.collectionResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	goat.CollectionResponse	No
data.limit	integer	No	12
data.page	integer	No	1
data.products	array	No
data.products[].category	string	No	shoes
data.products[].id	string	No	1481726
data.products[].image_url	string	No
data.products[].release_year	string	No	2025
data.products[].slug	string	No	air-jordan-4-retro-rare-air-fv5029-003
data.products[].source_url	string	No	https://www.goat.com/sneakers/air-jordan-4-retro-rare-air-fv5029-003
data.products[].title	string	No	Air Jordan 4 Retro 'Rare Air - White Lettering'
data.slug	string	No	top-trending-uk
data.total_results	integer	No	48
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
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/collection?slug=top-trending-uk&page=1&limit=10" \
  -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 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 Search GOAT products API documentation

Open in Playground Back to group

Docs menu

GOAT API endpoint

GOAT Collection API

GETapiKey2 credits/requestGOATgoat.collectionResponseDoc/goat/collection

Endpoint facts

Method: GET
API path: /goat/collection
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: GOAT
Response schema: #/definitions/goat.collectionResponseDoc

GOAT API Try GOAT Collection API in Playground GOAT API documentation

How this endpoint behaves

Query parameters:

slug (required) — GOAT collection slug, e.g. as seen in a curated rail on GOAT's own site (top-trending-uk, top-sneaker-collabs, back-to-school-2026, ...). Collection slugs are not enumerable by this API — capture one from a live GOAT page (a product page's related rails, or the homepage).
page (optional) — 1-indexed result page. Defaults to 1.
limit (optional) — results per page. Defaults to 12, maximum 100.
exclude_product_ids (optional) — omit specific products by id, comma-separated. Useful when showing a collection alongside a product you do not want repeated (the same thing GOAT's own product page does with its "you may also like" rails).

Notable response behavior:

total_results reflects the collection's full item count, not just len(products).
An unknown slug returns 404.

Sampled response

Request, 14 Oct 2026: GET /goat/collection?limit=12&slug=top-trending-uk
Items in products: 12
Fields filled in every checked item: 6
Fields empty in some or all items: 1

Field	Filled in, of 12 checked	Values in the sample
id	12
slug	12
title	12	“Air Jordan 4 Retro 'Rare Air - White Lettering'” and 11 other values
image_url	12	image.goat.com
category	12	shoes in all 12
release_year	10	2,023 to 2,025, median 2,025
source_url	12	goat.com

Request parameters

Parameter	Type	Required	Default	Description	Example
slug	string	Yes		GOAT collection slug, e.g. as seen in a curated rail on GOAT's own site	top-trending-uk
page	integer	No	1	1-indexed result page, defaults to 1	1
limit	integer	No	12	Results per page, defaults to 12, maximum 100	12
exclude_product_ids	string	No		Omit specific products by id, comma-separated	1481726
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/goat/collection?slug=top-trending-uk&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "slug": "top-trending-uk",
    "page": 1,
    "limit": 12,
    "total_results": 395,
    "products": [
      {
        "id": "1481726",
        "slug": "air-jordan-4-retro-rare-air-fv5029-003",
        "title": "Air Jordan 4 Retro 'Rare Air - White Lettering'",
        "image_url": "https://image.goat.com/attachments/product_template_pictures/images/110/905/352/original/1481726_00.png.png",
        "category": "shoes",
        "release_year": "2025",
        "source_url": "https://www.goat.com/sneakers/air-jordan-4-retro-rare-air-fv5029-003"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/goat.collectionResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	goat.CollectionResponse	No
data.limit	integer	No	12
data.page	integer	No	1
data.products	array	No
data.products[].category	string	No	shoes
data.products[].id	string	No	1481726
data.products[].image_url	string	No
data.products[].release_year	string	No	2025
data.products[].slug	string	No	air-jordan-4-retro-rare-air-fv5029-003
data.products[].source_url	string	No	https://www.goat.com/sneakers/air-jordan-4-retro-rare-air-fv5029-003
data.products[].title	string	No	Air Jordan 4 Retro 'Rare Air - White Lettering'
data.slug	string	No	top-trending-uk
data.total_results	integer	No	48
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
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/collection?slug=top-trending-uk&page=1&limit=10" \
  -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

GOAT Collection API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

GOAT Collection API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related