goat_search
Find sneakers, streetwear, and collectibles on GOAT by free-text query or facet filters, returning product summaries with pricing, stock status, and total match count.
Instructions
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 normalized 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. Credential-free public data from the same JSON API backing GOAT's own search page.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-indexed result page, defaults to 1 | |
| sort | No | Result sort order, defaults to relevance | |
| limit | No | Results per page, defaults to 12, maximum 100 | |
| query | No | Free-text search query, e.g. a model name, colorway, or style code. Optional -- omit to browse by facet filters alone | |
| years | No | Filter by season year(s), comma-separated, e.g. 2025,2026. See GET /goat/search/facets for the current live list | |
| brands | No | 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 | |
| colors | No | Filter by color, comma-separated for multiple values | |
| genders | No | Filter by gender, comma-separated for multiple values | |
| in_stock | No | Only include products currently in stock | |
| designers | No | Filter by one or more designers, comma-separated, matching GOAT's own naming (see a product's designer field) | |
| activities | No | Filter by activity (sneakers only), comma-separated for multiple values | |
| categories | No | Filter by category, comma-separated for multiple values. See GET /goat/search/facets for the current live list | |
| conditions | No | Filter by item condition, comma-separated for multiple values | |
| silhouettes | No | Filter by one or more silhouettes, comma-separated, matching GOAT's own naming (see a product's silhouette field) | |
| instant_ship | No | Only include products with GOAT Instant Ship availability | |
| under_retail | No | Only include products currently trading below original retail price | |
| product_types | No | Filter by footwear sub-type, comma-separated for multiple values | |
| released_after | No | Only include products released on or after this date (YYYY-MM-DD, UTC) | |
| collection_slug | No | Scope results to a GOAT curated collection (see GET /goat/collection), combinable with query, every other filter, and sort | |
| price_cents_max | No | Only include results priced at or below this amount, in cents | |
| price_cents_min | No | Only include results priced at or above this amount, in cents | |
| released_before | No | Only include products released on or before this date (YYYY-MM-DD, UTC) |