supremenewyork.com APIsupremenewyork.com ↗
Access Supreme seasonal previews, news articles, lookbooks, store locations, and live webstore status via a structured JSON API with 6 endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/143ab5f9-2161-4450-a78f-b770e0b416db/get_news_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch all news articles from Supreme. Returns an array of article summaries with title, slug, date, and excerpt.
No input parameters required.
{
"type": "object",
"fields": {
"articles": "array of article objects, each with id (string), title (string), slug (string), date (ISO 8601 string), and excerpt (string, may be empty)"
},
"sample": {
"data": {
"articles": [
{
"id": "25c9e971-b0f7-4484-a98d-665074cd9b25",
"date": "2026-04-28T10:30:00.000Z",
"slug": "1021",
"title": "Supreme®/Dr. Martens® Postal Supreme",
"excerpt": ""
},
{
"id": "2c3a4930-9acb-4b68-8fcf-e20513ec4621",
"date": "2026-04-14T10:30:00.000Z",
"slug": "1020",
"title": "Supreme/Mike Kelley",
"excerpt": ""
}
]
},
"status": "success"
}
}About the supremenewyork.com API
The Supreme New York API exposes 6 endpoints covering seasonal product collections, editorial news, lookbooks, store locations, and live webstore status. The get_season_preview endpoint returns full product objects including variants, images, and descriptions filtered by season slug and category. Whether you're tracking drop availability or archiving collection data, the API delivers structured JSON ready for downstream use.
Product & Collection Data
The get_season_preview endpoint accepts two optional parameters: season (e.g. springsummer2026, fallwinter2025) and category (e.g. jackets, hats, accessories, all). Each product object in the response includes _id, title, slug, description, category, variants, and images. This makes it possible to build season-specific product catalogs or monitor category-level changes across drops without any additional parsing.
The get_shop_status endpoint returns a status field of either open or closed, the final resolved url, and an announcement string — useful for polling webstore availability around scheduled drop times.
Editorial & Visual Content
get_news_list returns an array of article summaries — each with id, title, slug, date, and excerpt — with no required parameters. To retrieve full article content, pass the slug from any summary to get_news_article, which returns body as Sanity portable text blocks plus an images array with alt, asset, and caption fields.
get_lookbook accepts a sequential numeric lookbook_id (e.g. 43, 44, 45) and returns an array of look objects. Each look contains images with url and dimensions, and links referencing associated products.
Store Locations
get_stores requires no parameters and returns every global Supreme store as an object with title, address, opening hours, phoneNumber, location coordinates, region, slug, mapLink, and emailLink. This covers the full retail footprint in one call.
- Monitor Supreme webstore open/closed status around scheduled weekly drops using
get_shop_status. - Build a seasonal product archive by iterating
get_season_previewacross season slugs and storing variant data. - Filter collection previews by category (e.g.
jackets,hats) to power category-specific drop trackers. - Aggregate Supreme news content including article body and images via
get_news_listandget_news_article. - Map Supreme store locations globally using the
locationcoordinates andregionfields fromget_stores. - Link lookbook imagery to product data by combining
get_lookbookproduct references withget_season_previewresults. - Track editorial coverage across Supreme's seasonal campaigns by indexing news slugs and publication dates.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Supreme have an official public developer API?+
What does `get_season_preview` return and how do I filter it?+
get_season_preview returns a products array where each object includes _id, title, slug, description, category, variants, and images. Pass the season parameter (e.g. fallwinter2025) to target a specific collection, and the category parameter (e.g. shirts, accessories) to narrow results. Both parameters are optional; omitting them returns a default view.Does the API expose real-time inventory counts or in-stock/out-of-stock status per variant?+
get_season_preview response includes variants within each product object, but live inventory counts are not currently part of the response. The API covers product structure, variant definitions, images, and descriptions. You can fork it on Parse and revise it to add an endpoint targeting live inventory availability.Can I retrieve individual product pages by product slug or ID?+
get_season_preview filtered by season and category, with each product carrying a slug and _id. You can fork the API on Parse and revise it to add a single-product lookup endpoint using those identifiers.Are there any known limitations with lookbook or news pagination?+
get_news_list returns all available article summaries in a single response with no pagination parameters. get_lookbook uses sequential numeric IDs, so coverage depends on knowing the valid ID range — there is no discovery endpoint that lists all available lookbook IDs.