Supreme New York APIsupremenewyork.com ↗
Access Supreme product previews, news articles, lookbooks, store locations, and live webstore status via 6 structured JSON endpoints.
What is the Supreme New York API?
The Supreme New York API exposes 6 endpoints covering seasonal product previews, editorial news, lookbooks, global store locations, and live webstore status. The get_season_preview endpoint returns full product objects with variants, images, and descriptions filterable by category and season slug. Together, the endpoints surface the core data layers of supremenewyork.com in structured JSON.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace supremenewyork-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Supreme API — browse previews, news, lookbooks, and check store status."""
from parse_apis.supreme_api import Supreme, PreviewCategory, LookbookId, ArticleNotFound
client = Supreme()
# Check shop status
shop = client.shopstatuses.get()
print(f"Shop: {shop.status}, URL: {shop.url}")
# List news articles
for article in client.articles.list(limit=3):
print(article.title, article.date)
# Fetch full article details with error handling
try:
detail = client.articles.get(slug="1025")
print(detail.title, detail.date, len(detail.images))
except ArticleNotFound as exc:
print(f"Article gone: {exc}")
# Browse season preview filtered by category
preview = client.seasonpreviews.get(season="springsummer2026", category=PreviewCategory.JACKETS)
print(preview.season, preview.category, len(preview.products))
if preview.products:
product = preview.products[0]
print(product.title, product.slug, len(product.variants))
# Browse a lookbook
book = client.lookbooks.get(lookbook_id=LookbookId._44)
print(book.slug, len(book.looks))
if book.looks:
look = book.looks[0]
print(len(look.images), len(look.links))
# List stores
for store in client.stores.list(limit=3):
print(store.title, store.region, store.phoneNumber)
print("exercised: shopstatuses.get / articles.list / articles.get / seasonpreviews.get / lookbooks.get / stores.list")
Fetch all news articles from Supreme. Returns the full list of article summaries in reverse chronological order. Each article carries its slug for drill-down via get_news_article.
No input parameters required.
{
"type": "object",
"fields": {
"articles": "array of article summary objects"
},
"sample": {
"data": {
"articles": [
{
"id": "900efa81-b0cc-4449-90c6-feba7555a1f3",
"date": "2026-06-08T10:30:00.000Z",
"slug": "1025",
"title": "Supreme®/La Martina",
"excerpt": ""
}
]
},
"status": "success"
}
}About the Supreme New York API
Products and Season Previews
The get_season_preview endpoint accepts a season slug (e.g. springsummer2026, fallwinter2025) and an optional category filter (jackets, shirts, tops-sweaters, pants, shorts, all, and more). It returns an array of product objects, each containing _id, title, slug, description, category, variants, and images. This is the primary endpoint for building product catalogs, drop trackers, or inventory monitors against Supreme's current and upcoming collections.
News and Lookbooks
get_news_list returns all article summaries in reverse chronological order, each carrying a slug you can pass to get_news_article to retrieve the full article — including body as Sanity portable text blocks, ISO 8601 date, title, and an images array with alt, asset, and caption fields. The get_lookbook endpoint takes a sequential integer lookbook_id (e.g. 43, 44, 45) and returns an array of look objects with high-resolution images and product links, plus a season object with slug and title.
Stores and Webstore Status
get_stores returns every global Supreme retail location with title, address, opening hours, phoneNumber, geographic location coordinates, region, mapLink, and emailLink. get_shop_status checks whether the webstore is currently open or closed, returns the final redirect URL indicating the regional store, and surfaces any active announcement text. These two endpoints together are sufficient for building store finders and drop-notification tools.
The Supreme New York API is a managed, monitored endpoint for supremenewyork.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when supremenewyork.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official supremenewyork.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track upcoming Supreme drops by polling get_season_preview with a specific season slug and category filter
- Build a Supreme store locator using coordinates, addresses, and opening hours from get_stores
- Send webstore open/closed alerts by monitoring the status field from get_shop_status
- Archive Supreme editorial content by iterating slugs from get_news_list and fetching full articles via get_news_article
- Display lookbook imagery and tag featured products using product links returned by get_lookbook
- Aggregate Supreme product variant data across seasons for resale market analysis
- Surface active Supreme announcements by reading the announcement field from get_shop_status
| 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 | 100 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 developer API?+
How do I filter get_season_preview to a specific product category?+
category parameter with values like jackets, shirts, tops-sweaters, pants, or shorts. Use all to return every product in the season. The season parameter accepts slugs like springsummer2026 or fallwinter2025. Both parameters are optional; omitting them returns default results.Does get_shop_status return region-specific status?+
status field (open or closed) and a url field representing the final redirect destination, which indicates the regional store. It does not return separate status values per region in a single call. You can fork this API on Parse and revise it to add region-specific polling endpoints.Does the API cover individual product pricing or inventory counts?+
variants data alongside titles, descriptions, and images, but real-time pricing and inventory stock levels are not currently returned as discrete fields. You can fork this API on Parse and revise it to add an endpoint targeting live product detail pages where that data may be available.