GOAT

Search GOAT products

Searches or browses GOAT's sneaker/streetwear/collectibles catalog by free-text query and/or facet filters (category, footwear sub-type, activity, color, gender, condition, brand, release year, price range, release-date range, silhouette, designer, in-stock/under-retail/instant-ship, curated collection), returning product summaries (brand, silhouette, category, image, stock status, headline pricing across all sizes) plus the total matching count. Query is optional -- a facet filter alone browses the catalog the same way GOAT's own category/brand pages do.

get/goat/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/goat/search
  • Auth: API key in header x-api-key

Query parameters

querystring

Free-text search query, e.g. a model name, colorway, or style code. Optional -- omit to browse by facet filters alone

in_stockboolean

Only include products currently in stock

categories'footwear' | 'apparel' | 'accessories' | 'bags' | 'collectibles' | 'media' | 'sports' | 'jewelry' | 'home' | 'objects' | 'other' | 'art'

Filter by category, comma-separated for multiple values. See GET /goat/search/facets for the current live list

colors'black' | 'white' | 'blue' | 'grey' | 'red' | 'green' | 'pink' | 'cream' | 'brown' | 'purple' | 'multi-color' | 'orange' | 'tan' | 'yellow' | 'silver' | 'gold' | 'teal' | 'copper'

Filter by color, comma-separated for multiple values

genders'men' | 'youth' | 'infant' | 'women'

Filter by gender, comma-separated for multiple values

conditions'new_no_defects' | 'used' | 'new_with_defects' | 'goat_clean'

Filter by item condition, comma-separated for multiple values

product_types'sneakers' | 'sandals' | 'cleats' | 'boots' | 'slip-ons'

Filter by footwear sub-type, comma-separated for multiple values

activities'lifestyle' | 'basketball' | 'running' | 'skateboarding'

Filter by activity (sneakers only), comma-separated for multiple values

brandsstring

Filter by one or more brand slugs, comma-separated, e.g. air-jordan,nike. GET /goat/search/facets lists GOAT's top brands; long-tail brands are valid here even when absent from that list

silhouettesstring

Filter by one or more silhouettes, comma-separated, matching GOAT's own naming (see a product's silhouette field)

designersstring

Filter by one or more designers, comma-separated, matching GOAT's own naming (see a product's designer field)

yearsstring

Filter by season year(s), comma-separated, e.g. 2025,2026. See GET /goat/search/facets for the current live list

price_cents_mininteger

Only include results priced at or above this amount, in cents

price_cents_maxinteger

Only include results priced at or below this amount, in cents

under_retailboolean

Only include products currently trading below original retail price

instant_shipboolean

Only include products with GOAT Instant Ship availability

sort'relevance' | 'newest' | 'price_asc' | 'price_desc' | 'discount'

Result sort order, defaults to relevance

collection_slugstring

Scope results to a GOAT curated collection (see GET /goat/collection), combinable with query, every other filter, and sort

released_afterstring

Only include products released on or after this date (YYYY-MM-DD, UTC)

released_beforestring

Only include products released on or before this date (YYYY-MM-DD, UTC)

pageinteger

1-indexed result page, defaults to 1

limitinteger

Results per page, defaults to 12, maximum 100

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "limit": 12,
    "page": 1,
    "products": [
      {
        "brand_name": "Air Jordan",
        "category": "shoes",
        "gender": "men",
        "id": "1469452",
        "in_stock": true,
        "instant_lowest_price": {
          "amount_cents": 49100,
          "currency": "USD"
        },
        "lowest_price": {
          "amount_cents": 49100,
          "currency": "USD"
        },
        "product_type": "sneakers",
        "release_date": "2025-11-15",
        "retail_price": {
          "amount_cents": 49100,
          "currency": "USD"
        },
        "silhouette": "Air Jordan 1",
        "slug": "fragment-design-x-travis-scott-x-air-jordan-1-low-og-sp-sail-military-blue-dm7866-104",
        "source_url": "https://www.goat.com/sneakers/fragment-design-x-travis-scott-x-air-jordan-1-low-og-sp-sail-military-blue-dm7866-104",
        "title": "Fragment Design x Travis Scott x Air Jordan 1 Retro Low OG SP 'Sail Military Blue'"
      }
    ],
    "query": "jordan 1",
    "total_results": 5540
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.