1stDibs
Search 1stDibs listings
Searches or browses 1stDibs handbags and purses with category, designer, price, sale, color, period, location, gender, origin, seller, and sort filters.
get/1stdibs/search
Request
- Base URL: https://api.crawlora.net/api/v1
- URL: https://api.crawlora.net/api/v1/1stdibs/search
- Auth: API key in header x-api-key
Query parameters
qstring
Free-text search
categorystring
Category slug from firstdibs-categories
designerstring
Designer slug from firstdibs-designers
colorstring
Color value
periodstring
Period value
locationstring
Item location
genderstring
Gender value
originstring
Place-of-origin value
price'all price' | '[* TO 999]' | '[* TO 1999]' | '[* TO 4999]' | '[5000 TO *]'
Price preset
price_minnumber
Minimum price
price_maxnumber
Maximum price
on_saleboolean
On-sale listings only
measurementsboolean
Listings with measurements
this_weekboolean
Listings added this week
returnableboolean
Returnable items only
recognized_sellerboolean
Recognized seller listings only
top_sellerboolean
Top seller listings only
sort'recommended' | 'newest' | 'price-high' | 'price-low' | 'popular'
Sort
pageinteger
1-based page
per_page60 | 120
Results per page
Headers
x-api-keystring required
API key required
Response
OK
Example response
{
"code": 200,
"msg": "OK"
}Changes
No recorded changes to this operation across all 2 revisions of this API.