Ami Paris APIamiparis.com ↗
Access Ami Paris product data, collections, variants, images, and new arrivals via 8 structured endpoints. Covers pricing, inventory, and catalog browsing.
What is the Ami Paris API?
The Ami Paris API exposes 8 endpoints covering the full amiparis.com product catalog, including collections, variants, images, and search. The get_product endpoint returns a complete product object with variant-level pricing, SKUs, and availability. Developers can also browse the Ami De Coeur signature collection, retrieve new arrivals filtered by gender, and paginate through all store collections — each with product counts and descriptions.
curl -X GET 'https://api.parse.bot/scraper/05a27e1c-4a24-49c5-a584-2464a895ab5e/get_product?handle=white-wool-ami-de-coeur-crewneck-sweater-uks838018154' \ -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 amiparis-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.
from parse_apis.ami_paris_api import AmiParis, Gender, Product, ProductSummary, Collection
ami = AmiParis()
# Search for products by keyword and navigate to full details
for hit in ami.products.search(query="sweater"):
print(hit.title, hit.price, hit.available)
# Navigate from summary to full product details
full_product = hit.details()
print(full_product.title, full_product.vendor)
for variant in full_product.variants:
print(variant.title, variant.price, variant.sku, variant.available)
break
# Get full product details directly
product = ami.products.get(handle="black-wool-ami-de-coeur-crewneck-sweater-uks838018009")
print(product.title, product.vendor, product.body_html)
for img in product.images:
print(img.src, img.width, img.height)
# Browse new arrivals filtered by gender
for arrival in ami.newarrivals.list(gender=Gender.WOMEN):
print(arrival.title, arrival.handle)
# List collections
for coll in ami.collections.list():
print(coll.title, coll.handle, coll.products_count)
# Navigate into a collection's products
collection = ami.collection(handle="unisex-ami-de-coeur-collection")
for item in collection.products.list():
print(item.title, item.handle, item.vendor)
# Browse the Ami De Coeur signature collection
for item in ami.amidecoeurproducts.list():
print(item.title, item.handle)
Retrieve full product details including variants, pricing, images, and options by product handle. The handle is the URL slug for a product, obtainable from search_products or list_collection_products results. Returns the complete product object with all variant SKUs, barcodes, weights, images with dimensions, and option configurations.
| Param | Type | Description |
|---|---|---|
| handlerequired | string | Product handle (URL slug). |
{
"type": "object",
"fields": {
"product": "object containing id, title, handle, body_html, vendor, product_type, tags, variants (array with id/title/price/sku/barcode/weight/available/option1), options (array with name/values), images (array with id/src/width/height/alt/position), image (primary image object)"
},
"sample": {
"data": {
"product": {
"id": 15074033238401,
"tags": "PIM-MODEL::UKS838.018",
"image": {
"id": 81493729116545,
"src": "https://cdn.shopify.com/s/files/1/0774/7865/8352/files/UKS838.018_243bdb5d-6aac-4b70-a67e-a137117f5794.jpg?v=1778302317"
},
"title": "Black Wool Crewneck Sweater With Contrasted Ami De Coeur",
"handle": "black-wool-ami-de-coeur-crewneck-sweater-uks838018009",
"images": [
{
"id": 81493729116545,
"alt": "UKS838.018.009_H_1",
"src": "https://cdn.shopify.com/s/files/1/0774/7865/8352/files/UKS838.018_243bdb5d-6aac-4b70-a67e-a137117f5794.jpg?v=1778302317",
"width": 2280,
"height": 2850,
"position": 1
}
],
"vendor": "Ami Paris",
"options": [
{
"name": "Size",
"values": [
"XXS",
"XS",
"S"
]
}
],
"variants": [
{
"id": 54305078247809,
"sku": "UKS838.018.009",
"price": "550.00",
"title": "XXS",
"weight": 968,
"barcode": "3666598645428",
"option1": "XXS",
"available": true
}
],
"body_html": "Sweater in felted merino wool knit.",
"product_type": ""
}
},
"status": "success"
}
}About the Ami Paris API
Product and Variant Data
The get_product endpoint accepts a handle (the URL slug) and returns a single product object with fields including id, title, body_html, vendor, product_type, tags, options, and a variants array. Each variant carries price, sku, option1, available, and barcode. The dedicated get_product_variants endpoint surfaces the same variant data with explicit emphasis on size and color breakdown, while get_product_images isolates the images array, giving each image id, src, width, height, alt, and position alongside the primary image object.
Collections and Catalog Navigation
list_collections returns an array of collection objects — each with id, title, handle, description, published_at, updated_at, image, and products_count — and supports page and limit parameters (up to 250 per page). Once you have a collection_handle, pass it to list_collection_products to retrieve all products in that collection with the same pagination controls. The get_ami_de_coeur_collection endpoint is a convenience shortcut specifically for Ami's signature heart-logo line.
Search and Discovery
search_products accepts a query string and returns up to 10 matching products via predictive search. Each result includes id, title, handle, price, image, url, body, available, and vendor. The get_new_arrivals endpoint retrieves recently added products and accepts an optional gender parameter ('men' or 'women'); omitting it returns all new arrivals regardless of gender category.
Handle-Based Addressing
Most single-resource endpoints (get_product, get_product_variants, get_product_images) require a handle rather than a numeric ID. Handles are returned in the handle field of any product object from search_products, list_collection_products, or get_new_arrivals, so a typical workflow starts with a collection or search call to collect handles before fetching full product details.
The Ami Paris API is a managed, monitored endpoint for amiparis.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amiparis.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 amiparis.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 price-tracker for Ami Paris items by polling
get_productfor variant-levelpriceandavailablefields. - Sync the full Ami Paris catalog to an internal database using
list_collectionsfollowed bylist_collection_productswith pagination. - Power a gender-filtered new-arrivals feed using
get_new_arrivalswith thegenderparameter set to'men'or'women'. - Display size and color availability grids by fetching variant data via
get_product_variantsfor a given product handle. - Populate a lookbook or editorial page with high-resolution image metadata from
get_product_images, includingwidth,height, andaltfields. - Implement a site search autocomplete by querying
search_productswith a keyword and returning up to 10 product results with prices and images. - Scope a dataset to the Ami De Coeur line specifically using
get_ami_de_coeur_collectionwithout needing to know the collection handle.
| 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 Ami Paris have an official public developer API?+
What does `search_products` return, and how does it differ from `list_collection_products`?+
search_products accepts a free-text query and returns up to 10 results via predictive search. Each result includes price, url, available, and vendor fields but is limited to 10 items and does not support pagination. list_collection_products requires a collection_handle and supports paginated browsing of up to 250 items per page, making it more suitable for bulk catalog access.Does the API expose customer reviews or ratings for products?+
Are there any limitations on pagination across collection endpoints?+
list_collections and list_collection_products both accept page (integer) and limit (up to 250) parameters. search_products does not support pagination and caps results at 10. If you need full catalog coverage, use list_collection_products with incremented page values until a page returns fewer results than the requested limit.Does the API include sale pricing, discount codes, or promotional data?+
price field, but sale prices, compare-at prices, discount codes, and promotion details are not exposed as dedicated response fields. You can fork the API on Parse and revise it to surface compare_at_price from the variant object if that data is available in the source.