1stdibs

Discover how items on 1stDibs are categorized. We have a taxonomy with furniture, art, jewelry, and fashion categories at the top level. This will return a list of next level categories as well as facets with their appropriate filters. You need to specify a category.

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Category to read taxonomy for",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "category"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Browse 1stDibs with the given category and optional page number and filters. Filters are in the format of a query string like category=furniture&location=usa-north-america. Read the taxonomy to discover facets and filters.

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Category to browse",
      "type": "string",
      "minLength": 1
    },
    "page": {
      "description": "Page number to browse",
      "type": "number"
    },
    "filters": {
      "description": "Filters to apply to the browse",
      "type": "string"
    }
  },
  "required": [
    "category"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search 1stDibs with the given query and optional page number and filters. Filters are in the format of a query string like category=furniture&location=usa-north-america. Read the taxonomy to discover categories, facets and filters.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search Query",
      "type": "string",
      "minLength": 1
    },
    "page": {
      "description": "Jump to a specific page number",
      "type": "number"
    },
    "filters": {
      "description": "Filters to apply to the search",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get details on a specific item on 1stDibs. You'll need to input the item ID. You can search for an item or browse for an item to find an item ID.

{
  "type": "object",
  "properties": {
    "itemId": {
      "description": "Item ID to get details for",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "itemId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}