Loading / 加载中…
Loading / 加载中…
E-commerce & marketplace data
This API returns 1stDibs listings of furniture, lighting, art, jewellery, watches and fashion as JSON. You can search by keyword or category path with slug filters, discover which filter slugs and child categories exist for a scope, fetch the full record of one item or of a comma-separated batch of as many as 10, and page through a single dealer's storefront. Prices are the dealers' USD list prices.
Checking current availability and approved prices…
JSON in, a structured response out. Every public gateway endpoint uses POST.
Returns the full record for an item URL or for a comma-separated set of as many as 10 item ids, including condition, materials, shipping quotes and a price cross-check flag.
POST /api/v1/firstdibs/post-1stdibs-detailUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"item": "f_52078502"
}
}Returns the filter facets for a keyword or category scope, with option slugs and counts, plus the child categories of that level.
POST /api/v1/firstdibs/post-1stdibs-filtersUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"category": "furniture/seating/lounge-chairs"
}
}Returns paged listing rows for a keyword or category path, narrowed by slug filters, a USD price band, sale status and sort order.
POST /api/v1/firstdibs/post-1stdibs-searchUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"category": "furniture/seating/lounge-chairs",
"max_results": 10
}
}Returns one dealer's profile figures and a paged list of that dealer's listings, in the same row shape as listing search.
POST /api/v1/firstdibs/post-1stdibs-sellerUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"max_results": 10,
"seller": "morentz"
}
}POST /api/v1/<project>/<action> with x-api-key, Content-Type: application/json and a required Idempotency-Key.data is the result of the operation.Call the filters operation with the same keyword or category path you plan to search. It returns the facets for that scope with their option slugs and counts, and a facet name matches the search parameter it feeds where one exists.
A row whose seller withholds the figure comes back with a null price and a price status of upon request, never a zero. Treat it as unknown rather than free.
Yes. The item field of the detail operation takes as many as 10 item ids separated by commas, or a 1stdibs.com item URL. The response lists which requested ids were found and which are missing.
Origin is where the piece was made, while location is where the dealer ships it from. For an Italian-made chair sold by a dealer in New York, the first relates to the italian slug and the second to a New York slug such as new-york-usa.