About this API

Gymshark is a UK sportswear brand. This API reads product lists from collection pages on uk.gymshark.com and returns a record for each product: its name, image and product link.

Prices, colours and ratings are not returned. Use it to know which products a collection holds, then follow the link for the rest.

Typical uses

See which products are in a collection today.
Spot new products by comparing one run with the last.
Keep product names, images and links for a monitoring tool.

What you get

Field	Type	Sample value
`title`	string	Seamless Running Waistbelt
`url`	string	uk.gymshark.com/products/gymshark-seamles…
`image_url`	string	cdn.shopify.com/s/files/1/0098/8822/files…

Every field with its type, and the schemas, are in contract.json.

Sample records

2 saved records. This is a saved sample, not a live run.

`title`	`url`	`image_url`
Seamless Running Waistbelt	uk.gymshark.com/products/gymshark-seamles…	cdn.shopify.com/s/files/1/0098/8822/files…
Lifting Belt Keyring	uk.gymshark.com/products/gymshark-lifting…	cdn.shopify.com/s/files/1/0098/8822/files…

Inputs

collection choice

Optional. Chooses one of the site's collections. Leave it out for the default one.

Options: New Product Drops, All Accessories, All Socks, All Equipment.

Request

POST https://broker.cleanedweb.com/v1/catalog/public/apis/generated_21ac18f87ad65090f8480c76/endpoints/generated_21ac18f87ad65090f8480c76_search/run

curl -X POST https://broker.cleanedweb.com/v1/catalog/public/apis/generated_21ac18f87ad65090f8480c76/endpoints/generated_21ac18f87ad65090f8480c76_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "collection": "New Product Drops"
  },
  "max_items": 25
}'

Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.

Coverage

Category: Commerce
Countries: United Kingdom
Languages: English

Limitations

Prices, colours and ratings are not returned.
The collection input offers four collections.

Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.

CleanedWeb is not affiliated with Gymshark UK.

Gymshark Products API