anndemeulemeester.com APIanndemeulemeester.com ↗
Access Ann Demeulemeester's full product catalog, collections, and search via 4 endpoints. Retrieve variants, pricing, images, and tags for any item.
curl -X GET 'https://api.parse.bot/scraper/d985a3bc-0ef8-4cd1-a23e-e7a26895f6e1/search_products?limit=5&query=jacket&product_type=product' \ -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 anndemeulemeester-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.
"""Walkthrough: Ann Demeulemeester SDK — browse collections and search products."""
from parse_apis.anndemeulemeester_com_api import AnnDemeulemeester, ProductType, ProductNotFound
client = AnnDemeulemeester()
# List available collections with product counts.
for coll in client.collections.list(limit=5):
print(coll.title, coll.handle, coll.products_count)
# Search products by keyword using the typed ProductType enum.
for product in client.product_summaries.search(query="jacket", product_type=ProductType.PRODUCT, limit=3):
print(product.title, product.price, product.available)
# Drill into a specific collection's products via constructible resource.
women = client.collection(handle="new-in-women")
item = women.products.list(limit=1).first()
if item:
print(item.title, item.vendor, item.variants[0].price)
# Fetch full product details from a summary's handle.
if item:
try:
full = client.products.get(handle=item.handle)
print(full.title, full.body_html, len(full.images))
except ProductNotFound as exc:
print(f"Product gone: {exc}")
print("exercised: collections.list / product_summaries.search / collection.products.list / products.get")
Search products by keyword across the Ann Demeulemeester catalog. Returns up to 10 matching products with pricing, availability, tags, and image URLs. Results are server-ranked by relevance to the query.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to return. Capped at 10 by the upstream API. |
| queryrequired | string | Search query text to match against product titles and descriptions. |
| product_type | string | Resource type to search. Accepted values: product, collection, page. |
{
"type": "object",
"fields": {
"pages": "array of matching pages",
"query": "string",
"products": "array of product objects",
"collections": "array of matching collections"
},
"sample": {
"pages": [],
"query": "jacket",
"products": [
{
"id": 15310776828290,
"url": "/products/woman-ann-demeulemeester-clothing-jackets-b0014200fa728-215",
"body": "Til Marsina Jacket - Oyster - 100% Cotton",
"tags": [
"ADdept_CLOTHING",
"macro-category_JACKETS"
],
"image": "https://cdn.shopify.com/s/files/1/0785/9257/3713/files/B0014200-FA728-215_1.jpg?v=1775637187",
"price": "1590.00",
"title": "Til Marsina Jacket",
"handle": "woman-ann-demeulemeester-clothing-jackets-b0014200fa728-215",
"vendor": "ANN DEMEULEMEESTER",
"available": true,
"price_max": "1590.00",
"price_min": "1590.00",
"compare_at_price_max": "0.00",
"compare_at_price_min": "0.00"
}
],
"collections": []
}
}About the anndemeulemeester.com API
The Ann Demeulemeester API provides 4 endpoints to query the brand's full product catalog at anndemeulemeester.com. Use search_products to find items by keyword, list_collections to paginate the store's collection index, list_collection_products to pull products within a named collection, and get_product to retrieve a single item's complete variant tree, high-resolution images, HTML description, and tags.
Catalog Search and Discovery
The search_products endpoint accepts a query string and an optional product_type filter (accepted values: product, collection, or page). Results are ranked by relevance and return up to 10 items per call, each with pricing, availability, image URLs, and tags. The same call also surfaces matching collections and pages arrays, so a single request can orient a client across multiple resource types.
Browsing Collections
list_collections returns paginated collection metadata — title, handle, image, and product count — supporting up to 250 records per page via the limit param. The handle value from each collection object is the key input for list_collection_products, which pages through every product assigned to that collection. Products in that response include full variant arrays (size, price, availability) and image sets.
Full Product Detail
get_product takes a handle string (the URL slug, obtainable from search or collection results) and returns the complete product record: id, title, vendor, tags, body_html description, options array, variants array with per-variant pricing and availability, and an images array with high-resolution URLs. The created_at timestamp is also included. This endpoint is the right choice when you need the full option matrix — for example, all available sizes and their stock status — rather than the summary data returned by list endpoints.
The anndemeulemeester.com API is a managed, monitored endpoint for anndemeulemeester.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when anndemeulemeester.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 anndemeulemeester.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?+
- Build a size and price tracker for Ann Demeulemeester collections using variant data from get_product.
- Aggregate new arrivals by polling list_collection_products on a 'new-in' collection handle.
- Index the full catalog for a fashion search tool using search_products keyword matching.
- Monitor product availability changes across variants by diffing get_product responses over time.
- Generate structured product feeds (title, price, images, tags) for comparison or affiliate sites.
- Map the complete collection hierarchy by paginating list_collections and following each handle.
- Pull high-resolution product images programmatically for editorial or lookbook applications.
| 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 Ann Demeulemeester have an official public developer API?+
What does get_product return beyond basic pricing?+
variants array — each variant carries its own price, availability, and option values such as size — plus an options array describing dimension names, a body_html HTML description, tags as a string, a created_at timestamp, and an images array with multiple high-resolution URLs per product.How do I navigate between collections and their products?+
list_collections to retrieve collection metadata including the handle field. Pass that handle to list_collection_products as the required collection_handle parameter. Both endpoints support page and limit inputs for pagination, with a maximum of 250 records per page.Does the API expose customer reviews or ratings for products?+
Is there a way to retrieve products across all collections without knowing handles in advance?+
search_products endpoint can return products without a collection filter, but results are capped at 10 per call and ranked by query relevance rather than offering a full catalog dump. To enumerate all products, the current approach is to paginate list_collections first and then call list_collection_products per handle. A dedicated all-products endpoint is not currently available — you can fork the API on Parse and revise it to add one.