{
  "openapi": "3.1.0",
  "info": {
    "title": "Soldgraph API",
    "version": "1.0.0",
    "description": "Resale listings from eight marketplaces (eBay in 8 countries; Vinted in the US, UK and 24 European countries; Poshmark and Whatnot in the US and Canada; Depop in the US, UK, Australia and Canada; the rest US), plus TCGplayer product search and recent card sales.",
    "contact": {
      "url": "https://soldgraph.com/docs"
    }
  },
  "servers": [
    {
      "url": "https://api.soldgraph.com/v1"
    }
  ],
  "security": [
    {
      "bearer": []
    }
  ],
  "paths": {
    "/ebay/sold": {
      "get": {
        "operationId": "ebay_sold",
        "tags": [
          "eBay"
        ],
        "summary": "eBay sold listings",
        "description": "Search one page of eBay sold listings by keyword, on eBay US or seven other countries. A page holds up to 200 rows with count=200, or 40 without it. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/sold"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be ebay.",
            "schema": {
              "type": "string",
              "enum": [
                "ebay"
              ],
              "default": "ebay"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Which eBay site to search: us (ebay.com), uk (ebay.co.uk), ca (ebay.ca), au (ebay.com.au), de (ebay.de), fr (ebay.fr), it (ebay.it) or es (ebay.es). Results, prices, min_price and max_price use that site's currency. Optional.",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "uk",
                "ca",
                "au",
                "de",
                "fr",
                "it",
                "es"
              ],
              "default": "us"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "eBay's own condition groups. Send one or more, separated by commas, like new,open_box. new is Brand New, open_box is Open Box or New (Other), refurbished is every refurbished grade, used is Pre-Owned and for_parts is Parts Only. eBay applies the filter.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "new",
                  "open_box",
                  "refurbished",
                  "used",
                  "for_parts"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Result order. Leave it out for eBay's best match. recently_sold is newest sale first. price_asc and price_desc sort by price plus shipping.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "recently_sold",
                "price_asc",
                "price_desc"
              ]
            }
          },
          {
            "name": "item_location",
            "in": "query",
            "required": false,
            "description": "Where sellers are. domestic keeps sellers in the country you search; worldwide includes every country. Leave it out for the eBay site's own default. On fr the default is narrow: send worldwide for far more results.",
            "schema": {
              "type": "string",
              "enum": [
                "domestic",
                "worldwide"
              ]
            }
          },
          {
            "name": "buying_format",
            "in": "query",
            "required": false,
            "description": "Only one kind of listing: auction, buy_it_now (fixed price, including listings that also take offers) or best_offer (listings that take offers). eBay applies the filter.",
            "schema": {
              "type": "string",
              "enum": [
                "auction",
                "buy_it_now",
                "best_offer"
              ]
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "description": "Rows per page: 200, 120, 60 or 40. Send 200 for the most eBay gives; leaving it out means 40. A search costs one request at any size. Optional.",
            "schema": {
              "type": "integer",
              "enum": [
                40,
                60,
                120,
                200
              ]
            }
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "description": "eBay numeric category ID, such as 27386 for graphics cards. Keeps only listings in that category. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EbaySoldJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "ebay",
                    "country": "us",
                    "query": "sony wh-1000xm5",
                    "page": 1,
                    "page_size": 200,
                    "count": 1,
                    "reported_total": 1,
                    "next_page": null,
                    "next_cursor": null,
                    "collected_at": "2026-09-23T14:02:11Z",
                    "schema_version": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 1,
                      "currency": "USD",
                      "median": 189,
                      "low": 189,
                      "high": 189,
                      "p25": 189,
                      "p75": 189,
                      "earliest_sold_date": "2026-09-21",
                      "latest_sold_date": "2026-09-21",
                      "best_offer_accepted_count": 0,
                      "median_excluding_best_offer": 189
                    },
                    "data": [
                      {
                        "id": "123456789012",
                        "title": "Example eBay listing",
                        "link": "https://www.ebay.com/itm/123456789012",
                        "format": "fixed_price",
                        "displayed_price": {
                          "amount": 189,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$189.00",
                        "displayed_price_range": null,
                        "best_offer_accepted": false,
                        "displayed_shipping": {
                          "amount": 9.99,
                          "currency": "USD"
                        },
                        "shipping_text": "+$9.99 delivery",
                        "sold_date": "2026-09-21",
                        "sold_date_text": "Sep-21 14:35",
                        "condition": "Pre-Owned",
                        "bid_count": null,
                        "seller_text": "sonyfan_outlet (2,418) 99.6%",
                        "location_text": "Located in United States",
                        "image": "https://i.ebayimg.com/images/g/example/s-l500.jpg"
                      }
                    ],
                    "field_notes": "Fields that could not be read are null. Displayed prices are not verified accepted-offer prices."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EbaySoldJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbaySoldJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbaySoldJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbaySoldJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/ebay/listings": {
      "get": {
        "operationId": "ebay_listings",
        "tags": [
          "eBay"
        ],
        "summary": "eBay active listings",
        "description": "Search one page of eBay active listings by keyword, on eBay US or seven other countries, in the sort order you pick. A page holds up to 200 rows with count=200, or 40 without it. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/listings"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be ebay.",
            "schema": {
              "type": "string",
              "enum": [
                "ebay"
              ],
              "default": "ebay"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Which eBay site to search: us (ebay.com), uk (ebay.co.uk), ca (ebay.ca), au (ebay.com.au), de (ebay.de), fr (ebay.fr), it (ebay.it) or es (ebay.es). Results, prices, min_price and max_price use that site's currency. Optional.",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "uk",
                "ca",
                "au",
                "de",
                "fr",
                "it",
                "es"
              ],
              "default": "us"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "eBay's listing order. Promoted listings are included and flagged.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "newest",
                "price_asc",
                "ending_soon"
              ],
              "default": "best_match"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "eBay's own condition groups. Send one or more, separated by commas, like new,open_box. new is Brand New, open_box is Open Box or New (Other), refurbished is every refurbished grade, used is Pre-Owned and for_parts is Parts Only. eBay applies the filter.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "new",
                  "open_box",
                  "refurbished",
                  "used",
                  "for_parts"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "item_location",
            "in": "query",
            "required": false,
            "description": "Where sellers are. domestic keeps sellers in the country you search; worldwide includes every country. Leave it out for the eBay site's own default. On fr the default is narrow: send worldwide for far more results.",
            "schema": {
              "type": "string",
              "enum": [
                "domestic",
                "worldwide"
              ]
            }
          },
          {
            "name": "buying_format",
            "in": "query",
            "required": false,
            "description": "Only one kind of listing: auction, buy_it_now (fixed price, including listings that also take offers) or best_offer (listings that take offers). eBay applies the filter.",
            "schema": {
              "type": "string",
              "enum": [
                "auction",
                "buy_it_now",
                "best_offer"
              ]
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "description": "Rows per page: 200, 120, 60 or 40. Send 200 for the most eBay gives; leaving it out means 40. A search costs one request at any size. Optional.",
            "schema": {
              "type": "integer",
              "enum": [
                40,
                60,
                120,
                200
              ]
            }
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "description": "eBay numeric category ID, such as 27386 for graphics cards. Keeps only listings in that category. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EbayListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "ebay",
                    "country": "us",
                    "query": "canon ae-1 program",
                    "page": 1,
                    "page_size": 200,
                    "count": 1,
                    "reported_total": 1,
                    "next_page": null,
                    "next_cursor": null,
                    "collected_at": "2026-09-23T14:02:11Z",
                    "schema_version": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 1,
                      "currency": "USD",
                      "median": 189,
                      "low": 189,
                      "high": 189,
                      "p25": 189,
                      "p75": 189
                    },
                    "data": [
                      {
                        "id": "123456789012",
                        "title": "Example eBay listing",
                        "link": "https://www.ebay.com/itm/123456789012",
                        "promoted": false,
                        "format": "fixed_price",
                        "displayed_price": {
                          "amount": 189,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$189.00",
                        "displayed_price_range": null,
                        "displayed_shipping": {
                          "amount": 0,
                          "currency": "USD"
                        },
                        "shipping_text": "Free delivery",
                        "condition": "Pre-Owned",
                        "bid_count": null,
                        "ends_at": null,
                        "best_offer": false,
                        "seller_text": "filmcamerashop (1,204) 100%",
                        "location_text": null,
                        "image": "https://i.ebayimg.com/images/g/example/s-l500.jpg"
                      }
                    ],
                    "field_notes": "Listings are in the marketplace's order; promoted listings are included and flagged. Fields that could not be read are null."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EbayListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbayListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbayListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbayListingsJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/poshmark/sold": {
      "get": {
        "operationId": "poshmark_sold",
        "tags": [
          "Poshmark"
        ],
        "summary": "Poshmark sold listings",
        "description": "Search one page of Poshmark sold listings by keyword, on Poshmark US or Canada. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/poshmark-sold"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be poshmark.",
            "schema": {
              "type": "string",
              "enum": [
                "poshmark"
              ],
              "default": "poshmark"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Which Poshmark site to search: us (poshmark.com, US dollars) or ca (poshmark.ca, Canadian dollars). Results, prices, min_price and max_price use that site's currency. Optional.",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "ca"
              ],
              "default": "us"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "One of Poshmark's own condition codes: nwt (new with tags), uln (like new), ug (good) or uf (fair). Rows use the same codes. Poshmark filters one condition at a time, so more than one returns 422.",
            "schema": {
              "type": "string",
              "enum": [
                "nwt",
                "uln",
                "ug",
                "uf"
              ]
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "The previous page's next_cursor. Leave it out on page 1. Required on every later page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PoshmarkSoldJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "poshmark",
                    "country": "us",
                    "query": "Levis 501",
                    "page": 1,
                    "page_size": 48,
                    "count": 1,
                    "reported_total": 1,
                    "next_page": null,
                    "collected_at": "2026-09-23T14:02:11Z",
                    "schema_version": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 1,
                      "currency": "USD",
                      "median": 35,
                      "low": 35,
                      "high": 35,
                      "p25": 35,
                      "p75": 35,
                      "earliest_sold_date": "2026-09-28",
                      "latest_sold_date": "2026-09-28"
                    },
                    "data": [
                      {
                        "id": "000000000000000000000001",
                        "title": "Example Levi’s 501 jeans",
                        "link": "https://poshmark.com/listing/000000000000000000000001",
                        "displayed_price": {
                          "amount": 35,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$35.00",
                        "sold_date": "2026-09-28",
                        "sold_date_text": "2026-09-28T22:16:54-07:00",
                        "condition": "ug",
                        "seller_text": "closetofkate",
                        "brand": "Levi's",
                        "size": "32",
                        "image": "https://di2ponv0v5otw.cloudfront.net/posts/example.jpg"
                      }
                    ],
                    "field_notes": "Displayed prices are listing asks, not verified transaction or accepted-offer amounts. sold_date_text is the inventory sold_out status change time. Only listings with sold_out inventory are included.",
                    "next_cursor": null
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PoshmarkSoldJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/PoshmarkSoldJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/PoshmarkSoldJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/PoshmarkSoldJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/poshmark/listings": {
      "get": {
        "operationId": "poshmark_listings",
        "tags": [
          "Poshmark"
        ],
        "summary": "Poshmark active listings",
        "description": "Search one page of Poshmark active listings by keyword, on Poshmark US or Canada, in the sort order you pick. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/poshmark-listings"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be poshmark.",
            "schema": {
              "type": "string",
              "enum": [
                "poshmark"
              ],
              "default": "poshmark"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Which Poshmark site to search: us (poshmark.com, US dollars) or ca (poshmark.ca, Canadian dollars). Results, prices, min_price and max_price use that site's currency. Optional.",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "ca"
              ],
              "default": "us"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Poshmark's listing order. ending_soon isn't available on Poshmark and returns 422.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "newest",
                "price_asc"
              ],
              "default": "best_match"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "One of Poshmark's own condition codes: nwt (new with tags), uln (like new), ug (good) or uf (fair). Rows use the same codes. Poshmark filters one condition at a time, so more than one returns 422.",
            "schema": {
              "type": "string",
              "enum": [
                "nwt",
                "uln",
                "ug",
                "uf"
              ]
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "The previous page's next_cursor. Leave it out on page 1. Required on every later page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PoshmarkListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "poshmark",
                    "country": "us",
                    "query": "Levis 501",
                    "page": 1,
                    "page_size": 48,
                    "count": 1,
                    "reported_total": 1,
                    "next_page": null,
                    "collected_at": "2026-09-23T14:02:11Z",
                    "schema_version": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 1,
                      "currency": "USD",
                      "median": 42,
                      "low": 42,
                      "high": 42,
                      "p25": 42,
                      "p75": 42
                    },
                    "data": [
                      {
                        "id": "000000000000000000000002",
                        "title": "Example Levi’s 501 jeans",
                        "link": "https://poshmark.com/listing/000000000000000000000002",
                        "displayed_price": {
                          "amount": 42,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$42.00",
                        "condition": "uln",
                        "brand": "Levi's",
                        "size": "30",
                        "listed_at": "2026-09-27T10:04:12-07:00",
                        "seller_text": "example_closet",
                        "image": "https://di2ponv0v5otw.cloudfront.net/posts/example.jpg"
                      }
                    ],
                    "field_notes": "Listings are in the marketplace's order and priced at the seller's current ask. Only available inventory is included.",
                    "next_cursor": null
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PoshmarkListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/PoshmarkListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/PoshmarkListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/PoshmarkListingsJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/mercari/sold": {
      "get": {
        "operationId": "mercari_sold",
        "tags": [
          "Mercari"
        ],
        "summary": "Mercari sold listings",
        "description": "Search one page of Mercari US sold listings by keyword, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/mercari-sold"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be mercari.",
            "schema": {
              "type": "string",
              "enum": [
                "mercari"
              ],
              "default": "mercari"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Only us is supported here. eBay, Vinted, Poshmark, Depop and Whatnot endpoints also take other countries. Mercari, OfferUp, Facebook Marketplace and TCGplayer are US only.",
            "schema": {
              "type": "string",
              "enum": [
                "us"
              ],
              "default": "us"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "One Mercari condition: new, like_new, good, fair or poor. Rows return Mercari's label and condition_id.",
            "schema": {
              "type": "string",
              "enum": [
                "new",
                "like_new",
                "good",
                "fair",
                "poor"
              ]
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "The previous page's next_cursor. Leave it out on page 1. Keep every other parameter the same.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "description": "Most rows per page. Mercari can return fewer.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Mercari's result order. newest sorts by when the listing was created. recently_sold sorts by Mercari's sold time.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "newest",
                "price_asc",
                "price_desc",
                "most_popular",
                "recently_sold"
              ],
              "default": "recently_sold"
            }
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "description": "Mercari numeric category ID. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "brand_id",
            "in": "query",
            "required": false,
            "description": "Mercari numeric brand ID. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MercariSoldJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "mercari",
                    "country": "us",
                    "query": "sony headphones",
                    "page": 1,
                    "page_size": 1,
                    "count": 1,
                    "reported_total": 1,
                    "next_page": null,
                    "collected_at": "2026-09-23T14:02:11Z",
                    "schema_version": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 1,
                      "currency": "USD",
                      "median": 35,
                      "low": 35,
                      "high": 35,
                      "p25": 35,
                      "p75": 35,
                      "earliest_sold_date": "2026-09-28",
                      "latest_sold_date": "2026-09-28"
                    },
                    "data": [
                      {
                        "id": "m00000000001",
                        "title": "Illustrative Sony headphones listing",
                        "link": "https://www.mercari.com/us/item/m00000000001/",
                        "displayed_price": {
                          "amount": 35,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$35.00",
                        "sold_date": "2026-09-28",
                        "sold_date_text": "2026-09-28T12:00:00+00:00",
                        "condition": "Good",
                        "seller_text": "123456789",
                        "image": null,
                        "condition_id": 3,
                        "brand_id": 1,
                        "category_id": 1594
                      }
                    ],
                    "field_notes": "Displayed prices are marketplace listing amounts, not independently verified transaction or accepted-offer amounts. Sold timestamps are source-reported and may be absent. Trading items are excluded. Brand/category IDs are source IDs, without labels. Reported totals may be capped. Results cover one source page only.",
                    "next_cursor": null
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MercariSoldJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/MercariSoldJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/MercariSoldJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/MercariSoldJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/mercari/listings": {
      "get": {
        "operationId": "mercari_listings",
        "tags": [
          "Mercari"
        ],
        "summary": "Mercari active listings",
        "description": "Search one page of Mercari US active listings by keyword, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/mercari-listings"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be mercari.",
            "schema": {
              "type": "string",
              "enum": [
                "mercari"
              ],
              "default": "mercari"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Only us is supported here. eBay, Vinted, Poshmark, Depop and Whatnot endpoints also take other countries. Mercari, OfferUp, Facebook Marketplace and TCGplayer are US only.",
            "schema": {
              "type": "string",
              "enum": [
                "us"
              ],
              "default": "us"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "One Mercari condition: new, like_new, good, fair or poor. Rows return Mercari's label and condition_id.",
            "schema": {
              "type": "string",
              "enum": [
                "new",
                "like_new",
                "good",
                "fair",
                "poor"
              ]
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "The previous page's next_cursor. Leave it out on page 1. Keep every other parameter the same.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "description": "Most rows per page. Mercari can return fewer.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Mercari's result order. newest sorts by when the listing was created.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "newest",
                "price_asc",
                "price_desc",
                "most_popular"
              ],
              "default": "best_match"
            }
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "description": "Mercari numeric category ID. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "brand_id",
            "in": "query",
            "required": false,
            "description": "Mercari numeric brand ID. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MercariListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "mercari",
                    "country": "us",
                    "query": "sony headphones",
                    "page": 1,
                    "page_size": 1,
                    "count": 1,
                    "reported_total": 1,
                    "next_page": null,
                    "collected_at": "2026-09-23T14:02:11Z",
                    "schema_version": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 1,
                      "currency": "USD",
                      "median": 42,
                      "low": 42,
                      "high": 42,
                      "p25": 42,
                      "p75": 42
                    },
                    "data": [
                      {
                        "id": "m00000000001",
                        "title": "Illustrative Sony headphones listing",
                        "link": "https://www.mercari.com/us/item/m00000000001/",
                        "displayed_price": {
                          "amount": 42,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$42.00",
                        "condition": "Good",
                        "listed_at": "2026-09-27T10:04:12-07:00",
                        "seller_text": "123456789",
                        "image": null,
                        "condition_id": 3,
                        "brand_id": 1,
                        "category_id": 1594
                      }
                    ],
                    "field_notes": "Displayed prices are marketplace listing amounts, not independently verified transaction or accepted-offer amounts. Sold timestamps are source-reported and may be absent. Trading items are excluded. Brand/category IDs are source IDs, without labels. Reported totals may be capped. Results cover one source page only.",
                    "next_cursor": null
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MercariListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/MercariListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/MercariListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/MercariListingsJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/depop/listings": {
      "get": {
        "operationId": "depop_listings",
        "tags": [
          "Depop"
        ],
        "summary": "Depop active listings",
        "description": "Search one page of Depop active listings by keyword, from sellers in the US, UK, Australia or Canada, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/depop-listings"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be depop.",
            "schema": {
              "type": "string",
              "enum": [
                "depop"
              ],
              "default": "depop"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Which country's sellers to search: us (US dollars), uk (pounds), au (Australian dollars) or ca (Canadian dollars). Results, prices, min_price and max_price use that country's currency. Optional.",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "uk",
                "au",
                "ca"
              ],
              "default": "us"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "One Depop condition: brand_new, used_like_new, used_excellent, used_good or used_fair. Rows return the same codes.",
            "schema": {
              "type": "string",
              "enum": [
                "brand_new",
                "used_like_new",
                "used_excellent",
                "used_good",
                "used_fair"
              ]
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "description": "Most rows per page. Depop can return fewer.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 24
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "The previous page's next_cursor. Leave it out on page 1. Keep the query, filters and count the same.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DepopListingsJob"
                },
                "example": {
                  "request_id": "example-depop-search",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "depop",
                    "country": "us",
                    "query": "nike",
                    "page": 1,
                    "page_size": 5,
                    "count": 5,
                    "reported_total": 2863606,
                    "next_page": 2,
                    "next_cursor": "WyJNbncxZkRFM09UQTNNRGswTlRBLkJPT1NURURfRVhIQVVTVEVELjAiLCAiNzIyMGVhY2U5NDgxZWU5Y2E5ZDllNjRhNzE3YmE5ZTk2MWRmZmM2ZDg3OTRmNDU4ODNkY2E2ZDdiMjQ3NjRlZiIsIDJd",
                    "collected_at": "2026-09-29T19:17:31.799685+00:00",
                    "schema_version": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 5,
                      "currency": "USD",
                      "median": 5.95,
                      "low": 5.95,
                      "high": 19.6,
                      "p25": 5.95,
                      "p75": 7
                    },
                    "data": [
                      {
                        "id": "929885807",
                        "title": "Nike Bra in solid light green Size: M 💚 #activewear #sports #nike #sportbra Brand new",
                        "link": "https://www.depop.com/products/lovexzat-nike-bra-in-solid-light-4c6d/",
                        "displayed_price": {
                          "amount": 5.95,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$5.95",
                        "price_includes": [
                          "buyer_fee"
                        ],
                        "condition": "brand_new",
                        "brand": "Nike",
                        "size": "M",
                        "image": "https://media-photos.depop.com/r1/7548776/4806392865_e376f6e8a5e14144b78062921e1cd94e/P0.jpg",
                        "promoted": false,
                        "location_text": "Los Angeles, United States",
                        "like_count": 4
                      },
                      {
                        "id": "930772677",
                        "title": "Nike SB hoodie with white and yellow 'NIKE SB' logo, size L #skateboarding #sb",
                        "link": "https://www.depop.com/products/abbimjelsema-nike-sb-hoodie-with-white-7e9d/",
                        "displayed_price": {
                          "amount": 5.95,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$5.95",
                        "price_includes": [
                          "buyer_fee"
                        ],
                        "condition": "used_fair",
                        "brand": "Nike",
                        "size": "L",
                        "image": "https://media-photos.depop.com/r1/218735601/4811656506_4d0e4793b3b24c6686684127e03e96ed/P0.jpg",
                        "promoted": false,
                        "location_text": "Byron Center, United States",
                        "like_count": 10
                      },
                      {
                        "id": "930226367",
                        "title": "Nike Tech Fleece black sweatpants size XS #techfleece #nike#black#tech#pants",
                        "link": "https://www.depop.com/products/kanuc2i-nike-tech-fleece-black-sweatpants-b7e1/",
                        "displayed_price": {
                          "amount": 19.6,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$19.60",
                        "price_includes": [
                          "buyer_fee"
                        ],
                        "condition": "used_good",
                        "brand": "Nike",
                        "size": "XS",
                        "image": "https://media-photos.depop.com/b1/47345678/4808288131_3f9d82598a9f4450b808552d9e1e3283/P0.jpg",
                        "promoted": false,
                        "location_text": "Portland, United States",
                        "like_count": 3
                      },
                      {
                        "id": "929853097",
                        "title": "grey nike pros size small worn a few times!! #nike #nikepros #grey",
                        "link": "https://www.depop.com/products/mollygraceaver5-grey-nike-pros-size-small-448f/",
                        "displayed_price": {
                          "amount": 5.95,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$5.95",
                        "price_includes": [
                          "buyer_fee"
                        ],
                        "condition": "used_excellent",
                        "brand": "Nike",
                        "size": "One size",
                        "image": "https://media-photos.depop.com/r1/370197255/4806213953_fcdec04586e846df916b12f133ba429d/P0.jpg",
                        "promoted": false,
                        "location_text": "Ona, United States",
                        "like_count": 7
                      },
                      {
                        "id": "930263070",
                        "title": "Nike black hoodie Size XL men’s used #athleisure #nike #hoodie #sweatshirt",
                        "link": "https://www.depop.com/products/throwbakkkingz-nike-black-hoodie-size-xl-aef6/",
                        "displayed_price": {
                          "amount": 7,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$7.00",
                        "price_includes": [
                          "buyer_fee"
                        ],
                        "condition": "used_fair",
                        "brand": "Nike",
                        "size": "XL",
                        "image": "https://media-photos.depop.com/b1/37215522/4808493787_8d99ee61ab824899a0f459149b19efc3/P0.jpg",
                        "promoted": false,
                        "location_text": "Olympia, United States",
                        "like_count": 2
                      }
                    ],
                    "field_notes": "Active US listings with USD prices only; non-USD source rows are excluded. displayed_price is Depop's USD headline amount; price_includes identifies fees included by the source. Price bounds apply to source search prices, which may differ from the headline. Shipping, seller identity and listing timestamps are not provided. Source order is preserved. Totals may be absent on later pages. No transaction price or sold-search capability is provided."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DepopListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/DepopListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/DepopListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/DepopListingsJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/whatnot/listings": {
      "get": {
        "operationId": "whatnot_listings",
        "tags": [
          "Whatnot"
        ],
        "summary": "Whatnot active listings",
        "description": "Search one page of Whatnot Buy It Now active listings from sellers in the US or Canada, up to 24 rows. Prices are seller asks. No sold search. Results are cached for 15 minutes; a cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/whatnot-listings"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be whatnot.",
            "schema": {
              "type": "string",
              "enum": [
                "whatnot"
              ],
              "default": "whatnot"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Which country's sellers to search: us (US dollars) or ca (Canadian dollars). Results, prices, min_price and max_price use that country's currency. Optional.",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "ca"
              ],
              "default": "us"
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "description": "Most source rows per page. Whatnot can return fewer.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 24
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Source ranking, creation time descending, or asking price ascending/descending.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "newest",
                "price_asc",
                "price_desc"
              ],
              "default": "best_match"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "Exact case-sensitive seller attribute, such as Near Mint or Graded. Values vary by category.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Whatnot category slug using lowercase letters, digits and underscores, such as pokemon_cards.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            }
          },
          {
            "name": "grading_service",
            "in": "query",
            "required": false,
            "description": "Exact case-sensitive seller-supplied grading service, such as PSA.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            }
          },
          {
            "name": "grade",
            "in": "query",
            "required": false,
            "description": "Exact seller-supplied grade, such as 10. This is not certificate verification.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 40
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Previous page's next_cursor. Omit on page 1. Keep query, filters, sort and count unchanged.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WhatnotListingsJob"
                },
                "example": {
                  "request_id": "example-whatnot-search",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "whatnot",
                    "country": "us",
                    "query": "pokemon",
                    "page": 1,
                    "page_size": 5,
                    "count": 5,
                    "reported_total": null,
                    "next_page": 2,
                    "next_cursor": "WyJZWEp5WVhsamIyNXVaV04wYVc5dU9qUT0iLCAiNzhjYWUyNDhkM2FiZDVlOGFhY2UxZWNlMjg1ZjljZDZmY2I0YTBjZjkzNmYzMjgwZGU0ZmUwMTU5OGMzODc0OSIsIDJd",
                    "collected_at": "2026-10-01T03:22:12.992189+00:00",
                    "schema_version": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 5,
                      "currency": "USD",
                      "median": 50,
                      "low": 30,
                      "high": 160,
                      "p25": 39,
                      "p75": 65
                    },
                    "data": [
                      {
                        "id": "TGlzdGluZ05vZGU6MjM2MDA2ODU0Mg==",
                        "title": "Pokemon TCG: Scarlet & Violet-Surging Sparks Pokemon Center Elite Trainer Box",
                        "link": "https://www.whatnot.com/listing/TGlzdGluZ05vZGU6MjM2MDA2ODU0Mg==",
                        "displayed_price": {
                          "amount": 160,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$160.00",
                        "condition": "New",
                        "image": "https://images.whatnot.com/eyJidWNrZXQiOiAid2hhdG5vdC1pbWFnZXMiLCAia2V5IjogImxpc3RpbmdzLzAtZDU4MDhkZWEtZDA5OS00MzFkLWI0YWMtNDQyNWU5MGE4NDJlLWIxMGJhM2FmLTU3NWQtNGJiZC04NWJkLTkxZjFlODgzMjI1MC5qcGVnIiwgImVkaXRzIjogeyJyZXNpemUiOiB7IndpZHRoIjogbnVsbCwgImhlaWdodCI6IG51bGwsICJmaXQiOiAiY29udGFpbiIsICJiYWNrZ3JvdW5kIjogeyJyIjogMjU1LCAiZyI6IDI1NSwgImIiOiAyNTUsICJhbHBoYSI6IDF9fX19?signature=2e96ba9b90cffd216782b8ff8036bcce4db5a910e06b008e834a055d91f7bb58",
                        "quantity": 1,
                        "listed_at": "2026-09-27T23:08:08+00:00",
                        "seller_text": "aws20",
                        "grading_service": null,
                        "grade": null,
                        "card_set": "Surging Sparks",
                        "card_number": null,
                        "language": "English"
                      },
                      {
                        "id": "TGlzdGluZ05vZGU6MjM3MTYyMzgzNA==",
                        "title": "Pokemon Zorua Plush",
                        "link": "https://www.whatnot.com/listing/TGlzdGluZ05vZGU6MjM3MTYyMzgzNA==",
                        "displayed_price": {
                          "amount": 30,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$30.00",
                        "condition": "New",
                        "image": "https://images.whatnot.com/eyJidWNrZXQiOiAid2hhdG5vdC1pbWFnZXMiLCAia2V5IjogImxpc3RpbmdzLzAtYjMyNjExNDAtODAzNy00ZTA1LTgyZGEtYmNlOTliZWVjNTEyLWVmZTc4MDI5LTg5YmItNGViMy04OTZmLWU1MWMyNTdiNGU1ZS5qcGVnIiwgImVkaXRzIjogeyJyZXNpemUiOiB7IndpZHRoIjogbnVsbCwgImhlaWdodCI6IG51bGwsICJmaXQiOiAiY29udGFpbiIsICJiYWNrZ3JvdW5kIjogeyJyIjogMjU1LCAiZyI6IDI1NSwgImIiOiAyNTUsICJhbHBoYSI6IDF9fX19?signature=75a21ade4834c9a03f58eed943bce7b7ee6c37c2be04bfcf87669427beaa9346",
                        "quantity": 1,
                        "listed_at": "2026-09-29T21:59:36+00:00",
                        "seller_text": "mandobrix1",
                        "grading_service": null,
                        "grade": null,
                        "card_set": null,
                        "card_number": null,
                        "language": null
                      },
                      {
                        "id": "TGlzdGluZ05vZGU6MjM2MjY1MjAxOQ==",
                        "title": "Gameboy Pokemon Red",
                        "link": "https://www.whatnot.com/listing/TGlzdGluZ05vZGU6MjM2MjY1MjAxOQ==",
                        "displayed_price": {
                          "amount": 65,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$65.00",
                        "condition": null,
                        "image": "https://images.whatnot.com/eyJidWNrZXQiOiAid2hhdG5vdC1pbWFnZXMiLCAia2V5IjogImxpc3RpbmdzLzAtYTExNGVlMzktZWQ1Ny00ZDZlLWI5OTYtNjhhNTc4NDMxNDZiLTU2MzUxZTkyLTMxZGUtNGI5My1iZDUwLTFmZjc2M2ZhOWMyZC5qcGVnIiwgImVkaXRzIjogeyJyZXNpemUiOiB7IndpZHRoIjogbnVsbCwgImhlaWdodCI6IG51bGwsICJmaXQiOiAiY29udGFpbiIsICJiYWNrZ3JvdW5kIjogeyJyIjogMjU1LCAiZyI6IDI1NSwgImIiOiAyNTUsICJhbHBoYSI6IDF9fX19?signature=6081840124ba0c0a6befaf15c67bc32e11c6fb76b7be83ed73a552f6376f2f4b",
                        "quantity": 1,
                        "listed_at": "2026-09-28T18:05:46+00:00",
                        "seller_text": "retrokart89",
                        "grading_service": null,
                        "grade": null,
                        "card_set": null,
                        "card_number": null,
                        "language": null
                      },
                      {
                        "id": "TGlzdGluZ05vZGU6MjMxNDQyNTI2Nw==",
                        "title": "Nintendo 3DS Pokemon Ultra Moon",
                        "link": "https://www.whatnot.com/listing/TGlzdGluZ05vZGU6MjMxNDQyNTI2Nw==",
                        "displayed_price": {
                          "amount": 50,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$50.00",
                        "condition": null,
                        "image": "https://images.whatnot.com/eyJidWNrZXQiOiAid2hhdG5vdC1pbWFnZXMiLCAia2V5IjogImxpc3RpbmdzLzAtNDMwNGFkYmQtZjkxNi00ZmU4LTg1ZGItNTAzZjU5Y2VjNjY3LTdlNzYyNmVmLWI4NWYtNDMyMC05ODZmLTg1NDA5MDhmNzE5MS5qcGVnIiwgImVkaXRzIjogeyJyZXNpemUiOiB7IndpZHRoIjogbnVsbCwgImhlaWdodCI6IG51bGwsICJmaXQiOiAiY29udGFpbiIsICJiYWNrZ3JvdW5kIjogeyJyIjogMjU1LCAiZyI6IDI1NSwgImIiOiAyNTUsICJhbHBoYSI6IDF9fX19?signature=5fecd8c810e8d929390dbda929dc877d134686b3a5e168983f6951d3127e1991",
                        "quantity": 1,
                        "listed_at": "2026-09-16T22:43:38+00:00",
                        "seller_text": "retrokart89",
                        "grading_service": null,
                        "grade": null,
                        "card_set": null,
                        "card_number": null,
                        "language": null
                      },
                      {
                        "id": "TGlzdGluZ05vZGU6MjMzMzA1MTI2MQ==",
                        "title": "Bigpapa's Pokemon RGB Lamp ( w/Remote and charging cord )",
                        "link": "https://www.whatnot.com/listing/TGlzdGluZ05vZGU6MjMzMzA1MTI2MQ==",
                        "displayed_price": {
                          "amount": 39,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$39.00",
                        "condition": null,
                        "image": "https://images.whatnot.com/eyJidWNrZXQiOiAid2hhdG5vdC1pbWFnZXMiLCAia2V5IjogImxpc3RpbmdzLzAtMzAzZTg5NjctODljZS00OWZlLTk2M2UtOWY0NTNmZGZmNDlmLTYyZTgzOGY2LTVkNmEtNGJiMC05YmJkLTE1ZDJkZGY1MmRkNy5qcGVnIiwgImVkaXRzIjogeyJyZXNpemUiOiB7IndpZHRoIjogbnVsbCwgImhlaWdodCI6IG51bGwsICJmaXQiOiAiY29udGFpbiIsICJiYWNrZ3JvdW5kIjogeyJyIjogMjU1LCAiZyI6IDI1NSwgImIiOiAyNTUsICJhbHBoYSI6IDF9fX19?signature=8d98d8e780f4bdebe74eda82f0616c7182c29162501dd4dd96648869511cdf20",
                        "quantity": 1,
                        "listed_at": "2026-09-21T03:29:04+00:00",
                        "seller_text": "big_papa_308",
                        "grading_service": null,
                        "grade": null,
                        "card_set": null,
                        "card_number": null,
                        "language": null
                      }
                    ],
                    "field_notes": "Active US Buy It Now listings priced in USD. Displayed prices are seller asks, excluding shipping and checkout charges; they are not transaction prices. Unequal variant ranges have no single displayed_price. Attributes and grades are seller supplied, not independently verified. One source page, not complete coverage; ranking can repeat listings between pages or broaden keyword matches. No public sold search or final sale prices are provided."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WhatnotListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/WhatnotListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/WhatnotListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/WhatnotListingsJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/tcgplayer/search": {
      "get": {
        "operationId": "tcgplayer_search",
        "tags": [
          "TCGplayer"
        ],
        "summary": "TCGplayer product search",
        "description": "Search TCGplayer products by keyword; returns catalog identity, source market-price estimate and a few active seller asks. Cached 15 minutes; a cache miss returns 202 to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/tcgplayer-search"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Only us is supported here. eBay, Vinted, Poshmark, Depop and Whatnot endpoints also take other countries. Mercari, OfferUp, Facebook Marketplace and TCGplayer are US only.",
            "schema": {
              "type": "string",
              "enum": [
                "us"
              ],
              "default": "us"
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional; must match the path.",
            "schema": {
              "type": "string",
              "enum": [
                "tcgplayer"
              ],
              "default": "tcgplayer"
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "description": "Products per source page.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 24
            }
          },
          {
            "name": "product_line",
            "in": "query",
            "required": false,
            "description": "Keep one product line, named as TCGplayer does: Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana and so on. Case doesn't matter. Leave it out to search every line.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgplayerSearchJob"
                },
                "example": {
                  "request_id": "example-tcgplayer-search",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "tcgplayer",
                    "country": "us",
                    "page": 1,
                    "next_cursor": null,
                    "collected_at": "2026-10-01T12:00:00+00:00",
                    "schema_version": 2,
                    "query": "lugia vstar",
                    "page_size": 1,
                    "count": 1,
                    "reported_total": 13,
                    "next_page": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 1,
                      "currency": "USD",
                      "median": 6.96,
                      "low": 6.96,
                      "high": 6.96,
                      "p25": 6.96,
                      "p75": 6.96
                    },
                    "data": [
                      {
                        "product_id": 451396,
                        "name": "Lugia VSTAR",
                        "link": "https://www.tcgplayer.com/product/451396",
                        "product_line": "Pokemon",
                        "set_name": "SWSH12: Silver Tempest",
                        "set_code": "SWSH12",
                        "card_number": "139/195",
                        "rarity": "Ultra Rare",
                        "market_price": {
                          "amount": 6.96,
                          "currency": "USD"
                        },
                        "lowest_ask": {
                          "amount": 3.19,
                          "currency": "USD"
                        },
                        "lowest_ask_with_shipping": {
                          "amount": 3.19,
                          "currency": "USD"
                        },
                        "listed_median": null,
                        "active_listing_count": 215,
                        "offers": [
                          {
                            "listing_id": 354256735,
                            "seller": "CardNAll Gaming",
                            "condition": "Near Mint",
                            "variant": "Holofoil",
                            "language": "English",
                            "asking_price": {
                              "amount": 7,
                              "currency": "USD"
                            },
                            "shipping_price": {
                              "amount": 3.99,
                              "currency": "USD"
                            }
                          }
                        ]
                      }
                    ],
                    "field_notes": "Catalog prices and seller asks are distinct from actual sales."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgplayerSearchJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/TcgplayerSearchJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/TcgplayerSearchJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/TcgplayerSearchJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/tcgplayer/sales": {
      "get": {
        "operationId": "tcgplayer_sales",
        "tags": [
          "TCGplayer"
        ],
        "summary": "TCGplayer recent sales",
        "description": "Fetch an exact product’s recent individual sales. Anonymous source access has shown at most five rows; this is not a complete sales history. Cached 15 minutes; a cache miss returns 202 to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/tcgplayer-sales"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Exact numeric TCGplayer product ID, such as 451396.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 12
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Only us is supported here. eBay, Vinted, Poshmark, Depop and Whatnot endpoints also take other countries. Mercari, OfferUp, Facebook Marketplace and TCGplayer are US only.",
            "schema": {
              "type": "string",
              "enum": [
                "us"
              ],
              "default": "us"
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional; must match the path.",
            "schema": {
              "type": "string",
              "enum": [
                "tcgplayer"
              ],
              "default": "tcgplayer"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgplayerSalesJob"
                },
                "example": {
                  "request_id": "example-tcgplayer-sales",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "tcgplayer",
                    "country": "us",
                    "page": 1,
                    "next_cursor": null,
                    "collected_at": "2026-10-01T12:00:00+00:00",
                    "schema_version": 2,
                    "query": "451396",
                    "page_size": 5,
                    "count": 5,
                    "reported_total": 5,
                    "next_page": null,
                    "completeness": "recent_sample_only",
                    "summary": {
                      "priced_count": 5,
                      "currency": "USD",
                      "median": 6.8,
                      "low": 3.32,
                      "high": 6.98,
                      "p25": null,
                      "p75": null,
                      "earliest_sold_date": "2026-09-30",
                      "latest_sold_date": "2026-10-01"
                    },
                    "data": [
                      {
                        "product_id": 451396,
                        "title": "Lugia VSTAR",
                        "condition": "Near Mint",
                        "variant": "Holofoil",
                        "language": "English",
                        "quantity": 1,
                        "purchase_price": {
                          "amount": 6.98,
                          "currency": "USD"
                        },
                        "shipping_price": {
                          "amount": 1,
                          "currency": "USD"
                        },
                        "total_price": {
                          "amount": 7.98,
                          "currency": "USD"
                        },
                        "sold_at": "2026-10-01T08:37:16.863000+00:00"
                      },
                      {
                        "product_id": 451396,
                        "title": "Lugia VSTAR",
                        "condition": "Near Mint",
                        "variant": "Holofoil",
                        "language": "English",
                        "quantity": 1,
                        "purchase_price": {
                          "amount": 5.25,
                          "currency": "USD"
                        },
                        "shipping_price": {
                          "amount": 1,
                          "currency": "USD"
                        },
                        "total_price": {
                          "amount": 6.25,
                          "currency": "USD"
                        },
                        "sold_at": "2026-10-01T05:40:09.050000+00:00"
                      },
                      {
                        "product_id": 451396,
                        "title": "Lugia VSTAR",
                        "condition": "Damaged",
                        "variant": "Holofoil",
                        "language": "English",
                        "quantity": 1,
                        "purchase_price": {
                          "amount": 3.32,
                          "currency": "USD"
                        },
                        "shipping_price": {
                          "amount": 1.49,
                          "currency": "USD"
                        },
                        "total_price": {
                          "amount": 4.81,
                          "currency": "USD"
                        },
                        "sold_at": "2026-10-01T00:48:37.747000+00:00"
                      },
                      {
                        "product_id": 451396,
                        "title": "Lugia VSTAR",
                        "condition": "Near Mint",
                        "variant": "Holofoil",
                        "language": "English",
                        "quantity": 1,
                        "purchase_price": {
                          "amount": 6.98,
                          "currency": "USD"
                        },
                        "shipping_price": {
                          "amount": 0,
                          "currency": "USD"
                        },
                        "total_price": {
                          "amount": 6.98,
                          "currency": "USD"
                        },
                        "sold_at": "2026-09-30T22:50:56.593000+00:00"
                      },
                      {
                        "product_id": 451396,
                        "title": "Lugia VSTAR",
                        "condition": "Near Mint",
                        "variant": "Holofoil",
                        "language": "English",
                        "quantity": 1,
                        "purchase_price": {
                          "amount": 6.8,
                          "currency": "USD"
                        },
                        "shipping_price": {
                          "amount": 0,
                          "currency": "USD"
                        },
                        "total_price": {
                          "amount": 6.8,
                          "currency": "USD"
                        },
                        "sold_at": "2026-09-30T22:13:35.927000+00:00"
                      }
                    ],
                    "field_notes": "Recent sample only, not complete history; purchase price excludes separately reported shipping.",
                    "product_id": 451396
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgplayerSalesJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/TcgplayerSalesJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/TcgplayerSalesJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/TcgplayerSalesJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/offerup/listings": {
      "get": {
        "operationId": "offerup_listings",
        "tags": [
          "OfferUp"
        ],
        "summary": "OfferUp local listings",
        "description": "Search one page of OfferUp US active listings near a ZIP code or point, about 50 rows. Prices are seller asks. No sold search. Results are cached for 15 minutes; a cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/offerup-listings"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be offerup.",
            "schema": {
              "type": "string",
              "enum": [
                "offerup"
              ],
              "default": "offerup"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Only us is supported here. eBay, Vinted, Poshmark, Depop and Whatnot endpoints also take other countries. Mercari, OfferUp, Facebook Marketplace and TCGplayer are US only.",
            "schema": {
              "type": "string",
              "enum": [
                "us"
              ],
              "default": "us"
            }
          },
          {
            "name": "zip",
            "in": "query",
            "required": false,
            "description": "Five-digit US ZIP code to search around. Send zip, or both lat and lon. Unknown ZIP codes return 422.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "description": "Latitude of the search center in decimal degrees. Use with lon instead of zip for an exact point. Rounded to 4 decimals (about 11 m).",
            "schema": {
              "type": "number",
              "minimum": 17,
              "maximum": 72
            }
          },
          {
            "name": "lon",
            "in": "query",
            "required": false,
            "description": "Longitude of the search center in decimal degrees. Use with lat.",
            "schema": {
              "type": "number",
              "minimum": -180,
              "maximum": -64
            }
          },
          {
            "name": "radius",
            "in": "query",
            "required": false,
            "description": "Search radius in miles. Most searches offer 5, 10, 20, 30 or 50. Vehicle searches offer 25, 80, 100, 200 or 5000 (nationwide). If this kind of search doesn't offer your value, we use the widest offered radius below it, or else the smallest offered. result.location.radius_miles shows what was applied. Omit it for the source default: 30, or 80 for vehicles.",
            "schema": {
              "type": "integer",
              "enum": [
                5,
                10,
                20,
                25,
                30,
                50,
                80,
                100,
                200,
                5000
              ]
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "OfferUp category ID, such as 5 (Vehicles), 5.1 (Cars & Trucks) or 1.2 (Cell phones). The endpoint page lists the top-level IDs.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "One condition, or several separated by commas, such as new,open_box. OfferUp labels these differently for vehicles; see the endpoint page.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "new",
                  "open_box",
                  "refurbished",
                  "used",
                  "for_parts",
                  "other"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Source ranking, newest posted, nearest, or asking price low to high or high to low. newest_model and lowest_mileage work only on vehicle searches.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "newest",
                "nearest",
                "price_asc",
                "price_desc",
                "newest_model",
                "lowest_mileage"
              ],
              "default": "best_match"
            }
          },
          {
            "name": "vehicle_make",
            "in": "query",
            "required": false,
            "description": "Vehicle searches only. One make, or several separated by commas, such as honda,toyota.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "abarth",
                  "acura",
                  "alfa_romeo",
                  "am_general",
                  "aston_martin",
                  "audi",
                  "bentley",
                  "bmw",
                  "bugatti",
                  "buick",
                  "cadillac",
                  "chevrolet",
                  "chrysler",
                  "daewoo",
                  "daihatsu",
                  "datsun",
                  "dodge",
                  "eagle",
                  "ferrari",
                  "fiat",
                  "fisker",
                  "ford",
                  "genesis",
                  "gmc",
                  "honda",
                  "hummer",
                  "hyundai",
                  "infiniti",
                  "isuzu",
                  "jaguar",
                  "jeep",
                  "kia",
                  "lamborghini",
                  "land_rover",
                  "lexus",
                  "lincoln",
                  "lotus",
                  "maserati",
                  "mazda",
                  "mclaren",
                  "mercedes_benz",
                  "mercury",
                  "mini",
                  "mitsubishi",
                  "nissan",
                  "oldsmobile",
                  "plymouth",
                  "pontiac",
                  "porsche",
                  "ram",
                  "rolls_royce",
                  "saab",
                  "saturn",
                  "scion",
                  "smart",
                  "subaru",
                  "suzuki",
                  "tesla",
                  "toyota",
                  "volkswagen",
                  "volvo"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "vehicle_max_mileage",
            "in": "query",
            "required": false,
            "description": "Vehicle searches only. Highest odometer reading.",
            "schema": {
              "type": "integer",
              "enum": [
                0,
                25000,
                50000,
                75000,
                100000,
                125000,
                150000,
                175000,
                200000
              ]
            }
          },
          {
            "name": "vehicle_style",
            "in": "query",
            "required": false,
            "description": "Vehicle searches only. One body style, or several separated by commas.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "car",
                  "suv",
                  "truck",
                  "van"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "vehicle_transmission",
            "in": "query",
            "required": false,
            "description": "Vehicle searches only.",
            "schema": {
              "type": "string",
              "enum": [
                "automatic",
                "manual"
              ]
            }
          },
          {
            "name": "vehicle_drivetrain",
            "in": "query",
            "required": false,
            "description": "Vehicle searches only. One drivetrain, or several separated by commas.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "awd",
                  "fwd",
                  "rwd"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Previous page's next_cursor. Omit it on page 1. Keep every other parameter unchanged.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OfferupListingsJob"
                },
                "example": {
                  "request_id": "example-offerup-search",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "offerup",
                    "country": "us",
                    "query": "mountain bike",
                    "page": 1,
                    "page_size": 3,
                    "count": 3,
                    "reported_total": null,
                    "next_page": 2,
                    "next_cursor": "eNoti8tygjAAAP8lV2EMISniTVCBQW0JiErtIYQg1gdPW8Dx38uhx53d_XyCWrCKZ76o63N-dxIwBfXAcIKwrkyYLHisyZiQNzlGKJVZikSCFExiiID0Py-FSMxHVefVcD-PIE_TWjRHMMX6a4jSQfsNqxowJfAlAazERGUJwTHXWMJ1ICFJgRIwhOoakyIxuYnNPPTn7owvbn5vlb1ul23ouFbkUHT4yMrAM9a6t6MOfRBGUXj1i5oEsc23lM92y_56MMdZ5Owv0a6popGqsTK4icLoTosKfo_0_dXU3nOKosKgUWlpYenP1apbnRpoKD9ktPntrHXrbN2WbKLOaPQubWH3OIT9ylIhHnvK_RIg2z6rSnwjPm01grJxAB3w9QeCVWr5",
                    "collected_at": "2026-10-01T15:19:15.793154+00:00",
                    "schema_version": 1,
                    "completeness": "provider_page_only",
                    "location": {
                      "zip": "94103",
                      "latitude": 37.773,
                      "longitude": -122.4113,
                      "radius_miles": 10,
                      "requested_radius_miles": 10,
                      "widened_radius_miles": null
                    },
                    "category_id": null,
                    "vehicle_search": false,
                    "field_notes": "Active local listings around the requested point. Prices are seller asks in USD, not sale prices; vehicle listings may say call for price. location_text is the seller-chosen area, not an address. Promoted rows are paid placements that OfferUp mixes into results. One source page, not complete coverage; ranking can repeat a listing across pages. Use the item endpoint for posted date, coordinates, seller and shipping details. No sold search or final sale prices are provided.",
                    "summary": {
                      "priced_count": 3,
                      "currency": "USD",
                      "median": 200,
                      "low": 55,
                      "high": 750,
                      "p25": 55,
                      "p75": 750
                    },
                    "data": [
                      {
                        "id": "0f979dba-51bf-355c-851f-bfce6924a6e2",
                        "title": "Red Mountain Bike with Rear Derailleur",
                        "link": "https://offerup.com/item/detail/0f979dba-51bf-355c-851f-bfce6924a6e2",
                        "displayed_price": {
                          "amount": 55,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$55.00",
                        "call_for_price": false,
                        "firm_price": null,
                        "condition": null,
                        "location_text": "Colma, CA",
                        "city": "Colma",
                        "state": "CA",
                        "image": "https://images.offerup.com/6rToWFKBLNOWCjZi6vygVhr5RhY=/250x333/2bb8/2bb8802d7a6a40239227dcecc7dc00f8.jpg",
                        "vehicle_miles": null,
                        "promoted": false,
                        "flags": [
                          "LOCAL_PICKUP"
                        ]
                      },
                      {
                        "id": "576dd673-e4e8-32a4-be4d-ed3082be7dc0",
                        "title": "29” rims and tires",
                        "link": "https://offerup.com/item/detail/576dd673-e4e8-32a4-be4d-ed3082be7dc0",
                        "displayed_price": {
                          "amount": 200,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$200.00",
                        "call_for_price": false,
                        "firm_price": null,
                        "condition": null,
                        "location_text": "San Francisco, CA",
                        "city": "San Francisco",
                        "state": "CA",
                        "image": "https://images.offerup.com/aw7JbLs49mAW48NiCdjwWTVdEos=/250x333/92d5/92d5cb78f2684da4928f6ab1acfae32b.jpg",
                        "vehicle_miles": null,
                        "promoted": false,
                        "flags": [
                          "LOCAL_PICKUP"
                        ]
                      },
                      {
                        "id": "c3fa0772-44bf-3e75-82d4-6b2e485fed34",
                        "title": "Bicicleta  Specialized",
                        "link": "https://offerup.com/item/detail/c3fa0772-44bf-3e75-82d4-6b2e485fed34",
                        "displayed_price": {
                          "amount": 750,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$750.00",
                        "call_for_price": false,
                        "firm_price": null,
                        "condition": null,
                        "location_text": "San Francisco, CA",
                        "city": "San Francisco",
                        "state": "CA",
                        "image": "https://images.offerup.com/TKsyB4L-9DolRgxZgDrj0cd1Hg0=/250x444/50a7/50a795009b2b42dfa83eeec180748dc0.jpg",
                        "vehicle_miles": null,
                        "promoted": false,
                        "flags": [
                          "LOCAL_PICKUP"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OfferupListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/OfferupListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/OfferupListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/OfferupListingsJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/offerup/item": {
      "get": {
        "operationId": "offerup_item",
        "tags": [
          "OfferUp"
        ],
        "summary": "OfferUp listing details",
        "description": "Fetch one OfferUp listing by ID or URL: description, posted date, condition, coordinates, shipping, photos, seller and vehicle details. Status is the seller-set state, not a verified sale. Cached 15 minutes; a cache miss returns 202 to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/offerup-item"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "OfferUp listing ID from search results, the numeric item number, or an offerup.com/item/detail/... URL.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 300
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Only us is supported here. eBay, Vinted, Poshmark, Depop and Whatnot endpoints also take other countries. Mercari, OfferUp, Facebook Marketplace and TCGplayer are US only.",
            "schema": {
              "type": "string",
              "enum": [
                "us"
              ],
              "default": "us"
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional; must match the path.",
            "schema": {
              "type": "string",
              "enum": [
                "offerup"
              ],
              "default": "offerup"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OfferupItemJob"
                },
                "example": {
                  "request_id": "example-offerup-item",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "offerup",
                    "country": "us",
                    "query": "0f979dba-51bf-355c-851f-bfce6924a6e2",
                    "collected_at": "2026-10-01T15:19:16.137068+00:00",
                    "schema_version": 1,
                    "count": 1,
                    "data": {
                      "id": "0f979dba-51bf-355c-851f-bfce6924a6e2",
                      "item_number": "1861069628",
                      "title": "Red Mountain Bike with Rear Derailleur",
                      "description": "Red frame mountain bike with knobby tires, black saddle, flat handlebars with brake levers, platform pedals, and a multi-speed rear cassette with derailleur.",
                      "link": "https://offerup.com/item/detail/0f979dba-51bf-355c-851f-bfce6924a6e2",
                      "status": "active",
                      "displayed_price": {
                        "amount": 55,
                        "currency": "USD"
                      },
                      "original_price": null,
                      "condition": "used",
                      "condition_code": 40,
                      "posted_at": "2026-10-01T02:03:25.109000+00:00",
                      "edited_at": null,
                      "quantity": 1,
                      "firm_price": false,
                      "location": {
                        "name": "Colma, CA",
                        "latitude": 37.72,
                        "longitude": -122.413
                      },
                      "local_pickup": true,
                      "shipping": {
                        "available": false,
                        "price": null,
                        "seller_pays": false,
                        "buy_now": false
                      },
                      "category": {
                        "id": "7.4",
                        "path": [
                          "Sports & Outdoors",
                          "Bikes & Cycling"
                        ]
                      },
                      "photos": [
                        "https://images.offerup.com/ETYpyjYCzGQ0-cWAGqhHTDIPTZ0=/960x1280/2bb8/2bb8802d7a6a40239227dcecc7dc00f8.jpg",
                        "https://images.offerup.com/0Qx4ZcvnVPhg8wNp-oYZH41N0M0=/960x1280/a922/a922af461d7a4d21a8005bce8c1dfe08.jpg",
                        "https://images.offerup.com/r3sYQgBXDczfOb816FWdzqIa4cY=/960x1280/770d/770d58a6a9df4108bcb4d21ab267a28f.jpg",
                        "https://images.offerup.com/zvqOETGwRUHqhpEDF3ws9l6JWf0=/960x1280/ac68/ac68900a44824052af52d824cdfe986d.jpg",
                        "https://images.offerup.com/SmjTrgnkif38G9AR162TBzmXcuc=/960x1280/f68d/f68d20bc8d1e4e1b87b3581b866eacec.jpg",
                        "https://images.offerup.com/8do4_zz8BWvvGfjisciBSYe6AiU=/1280x960/3a6b/3a6b08041ef843a4a79f0689696a846f.jpg",
                        "https://images.offerup.com/SnodxgySW1lymtmEtX4M678Z9UI=/960x1280/df54/df54e47ed50641e19ed50faa07ec9de2.jpg"
                      ],
                      "seller": {
                        "id": "12345678",
                        "name": "Example Seller",
                        "joined_at": "2016-09-13T19:58:56+00:00",
                        "items_sold": 102,
                        "rating_average": 5,
                        "rating_count": 14,
                        "business": false,
                        "auto_dealer": false,
                        "truyou_verified": null
                      },
                      "vehicle": null
                    },
                    "field_notes": "One OfferUp listing as shown publicly. Prices are seller asks in USD. status is the seller-set listing state; a sold status is not a verified sale record and its price is not a transaction price. Coordinates are the approximate public listing location, not an address."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OfferupItemJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/OfferupItemJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/OfferupItemJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/OfferupItemJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/facebook/listings": {
      "get": {
        "operationId": "facebook_listings",
        "tags": [
          "Facebook Marketplace"
        ],
        "summary": "Facebook local listings",
        "description": "Search Facebook Marketplace US active listings near a ZIP code or point, up to about 24 rows. Prices are seller asks. No sold search. Results are cached for 15 minutes; a cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/facebook-listings"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Always 1. Facebook serves one page per search, so there is no page 2. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be facebook.",
            "schema": {
              "type": "string",
              "enum": [
                "facebook"
              ],
              "default": "facebook"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Only us is supported here. eBay, Vinted, Poshmark, Depop and Whatnot endpoints also take other countries. Mercari, OfferUp, Facebook Marketplace and TCGplayer are US only.",
            "schema": {
              "type": "string",
              "enum": [
                "us"
              ],
              "default": "us"
            }
          },
          {
            "name": "zip",
            "in": "query",
            "required": false,
            "description": "Five-digit US ZIP code to search around. Send zip, or both lat and lon. Unknown ZIP codes, and places more than 75 miles from any Facebook Marketplace city, return 422.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "description": "Latitude of the search center in decimal degrees. Use with lon instead of zip. Rounded to 4 decimals (about 11 m).",
            "schema": {
              "type": "number",
              "minimum": 17,
              "maximum": 72
            }
          },
          {
            "name": "lon",
            "in": "query",
            "required": false,
            "description": "Longitude of the search center in decimal degrees. Use with lat.",
            "schema": {
              "type": "number",
              "minimum": -180,
              "maximum": -64
            }
          },
          {
            "name": "radius",
            "in": "query",
            "required": false,
            "description": "Search radius in miles, 1 to 100. Default is Facebook's own, about 40 miles. Rows whose city is farther than the radius plus 10 miles are dropped.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Facebook ranking, newest listed first, or asking price low to high or high to low. Sorted searches return up to 24 rows; best match often returns about 15.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "newest",
                "price_asc",
                "price_desc"
              ],
              "default": "best_match"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "One condition, or several separated by commas, such as used_like_new,used_good.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "new",
                  "used_like_new",
                  "used_good",
                  "used_fair"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "delivery",
            "in": "query",
            "required": false,
            "description": "Only listings offering local pickup, or only listings that ship.",
            "schema": {
              "type": "string",
              "enum": [
                "local_pickup",
                "shipping"
              ]
            }
          },
          {
            "name": "days_since_listed",
            "in": "query",
            "required": false,
            "description": "Only listings posted in the last 1, 7 or 30 days.",
            "schema": {
              "type": "integer",
              "enum": [
                1,
                7,
                30
              ]
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacebookListingsJob"
                },
                "example": {
                  "request_id": "example-facebook-listings",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "facebook",
                    "country": "us",
                    "query": "mountain bike",
                    "page": 1,
                    "page_size": 14,
                    "count": 14,
                    "reported_total": null,
                    "next_page": null,
                    "next_cursor": null,
                    "collected_at": "2026-10-01T20:47:19.890286+00:00",
                    "schema_version": 1,
                    "completeness": "provider_page_only",
                    "location": {
                      "zip": "28202",
                      "latitude": 35.2273,
                      "longitude": -80.8442,
                      "radius_miles": 25,
                      "source_city": {
                        "id": "105715936129053",
                        "name": "Charlotte",
                        "state": "NC",
                        "latitude": 35.2269,
                        "longitude": -80.8433,
                        "distance_miles": 0.1
                      },
                      "source_radius_km": 41
                    },
                    "summary": {
                      "priced_count": 2,
                      "currency": "USD",
                      "median": 47.5,
                      "low": 25,
                      "high": 70,
                      "p25": 25,
                      "p75": 70
                    },
                    "data": [
                      {
                        "id": "2796090964120499",
                        "title": "Mountain bike",
                        "link": "https://www.facebook.com/marketplace/item/2796090964120499/",
                        "pending": false,
                        "displayed_price": {
                          "amount": 25,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$25.00",
                        "original_price": null,
                        "condition": null,
                        "city": "Belmont",
                        "state": "NC",
                        "city_id": "106100896087214",
                        "approx_distance_miles": 11.3,
                        "listed_at": "2026-09-27T12:26:17+00:00",
                        "delivery": {
                          "local_pickup": true,
                          "shipping": false
                        },
                        "category_id": "1658310421102081",
                        "image": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.84726-6/825268359_3678580222299961_2039901778140218879_n.jpg?stp=c0.87.526.526a_dst-jpg_p526x395_tt6&_nc_cat=110&ccb=1-7&_nc_sid=92e707&_nc_ohc=joVdZ7b0uZ4Q7kNvwEyWUUA&_nc_oc=AdqPTGtXbSvNGMNgFG96X88jHAsPYDrRArzo8hogkbQatErRWDmcGqzbxtKmRAwDNa0&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=kRjS6reyBV6qgDtQ1jeR3Q&_nc_ss=7b289&oh=00_AQPON8uJttwDPhZ58RwJJmfkQMz0PbiJ6mUde-RsizTBCg&oe=6AC487BD"
                      },
                      {
                        "id": "2104457877105943",
                        "title": "Mountain Bike For SALE!!🔥📲🌟✅",
                        "link": "https://www.facebook.com/marketplace/item/2104457877105943/",
                        "pending": false,
                        "displayed_price": {
                          "amount": 70,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$70.00",
                        "original_price": null,
                        "condition": null,
                        "city": "Charlotte",
                        "state": "NC",
                        "city_id": "105715936129053",
                        "approx_distance_miles": 0.1,
                        "listed_at": "2026-09-30T01:10:57+00:00",
                        "delivery": {
                          "local_pickup": true,
                          "shipping": false
                        },
                        "category_id": "1658310421102081",
                        "image": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.84726-6/825266442_1141005175266806_3972953768091373864_n.jpg?stp=c29.0.540.540a_dst-jpg_p180x540_tt6&_nc_cat=109&ccb=1-7&_nc_sid=92e707&_nc_ohc=wgRLiMrF__YQ7kNvwHsnEnm&_nc_oc=AdqGggELeIUc_xd13ChmfJiWbh9pg5zNnZ1EPZTqXdvCUb_Nu5HjrfVGlyf6yC948RY&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=kRjS6reyBV6qgDtQ1jeR3Q&_nc_ss=7b289&oh=00_AQO_F7vt91i1R7-kxeIjnCjkSUrNDCS2uQW0Cy4O9tM_Ow&oe=6AC49ED3"
                      }
                    ],
                    "field_notes": "Active local listings around the requested point, from the nearest Facebook Marketplace city. Prices are seller asks, not sale prices. city and state are the seller-chosen area; approx_distance_miles is measured to that city, not to the item. One source page, not complete coverage: narrow with sort, price or days_since_listed to reach more listings. Image links are signed by Facebook and expire. No sold search or final sale prices are provided."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacebookListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/FacebookListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/FacebookListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/FacebookListingsJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/facebook/item": {
      "get": {
        "operationId": "facebook_item",
        "tags": [
          "Facebook Marketplace"
        ],
        "summary": "Facebook listing details",
        "description": "Fetch one Facebook Marketplace listing by ID or URL: description, condition, posted date, approximate coordinates, delivery and photos. Status is the seller-set state, not a verified sale. Cached 15 minutes; a cache miss returns 202 to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/facebook-item"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Facebook Marketplace item ID from search results, or a facebook.com/marketplace/item/... URL.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 300
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Only us is supported here. eBay, Vinted, Poshmark, Depop and Whatnot endpoints also take other countries. Mercari, OfferUp, Facebook Marketplace and TCGplayer are US only.",
            "schema": {
              "type": "string",
              "enum": [
                "us"
              ],
              "default": "us"
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional; must match the path.",
            "schema": {
              "type": "string",
              "enum": [
                "facebook"
              ],
              "default": "facebook"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacebookItemJob"
                },
                "example": {
                  "request_id": "example-facebook-item",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "facebook",
                    "country": "us",
                    "query": "2796090964120499",
                    "collected_at": "2026-10-01T20:47:25.830554+00:00",
                    "schema_version": 1,
                    "count": 1,
                    "data": {
                      "id": "2796090964120499",
                      "title": "Mountain bike",
                      "description": "Needs TLC, haven’t rode in a couple years. Tires need air and put back on the rim. ",
                      "link": "https://www.facebook.com/marketplace/item/2796090964120499/",
                      "status": "active",
                      "displayed_price": {
                        "amount": 25,
                        "currency": "USD"
                      },
                      "original_price": null,
                      "condition": "used_fair",
                      "listed_at": "2026-09-27T12:26:17+00:00",
                      "location": {
                        "name": "Belmont, NC",
                        "latitude": 35.241394042969,
                        "longitude": -81.051635742188,
                        "city_id": "106100896087214"
                      },
                      "delivery": {
                        "local_pickup": true,
                        "shipping": false,
                        "shipping_offered": false,
                        "shipping_price_text": null
                      },
                      "category": {
                        "id": "1658310421102081",
                        "slug": "bicycles"
                      },
                      "photos": [
                        "https://scontent-atl3-1.xx.fbcdn.net/v/t39.84726-6/825268359_3678580222299961_2039901778140218879_n.jpg?stp=dst-jpg_p720x720_tt6&_nc_cat=110&ccb=1-7&_nc_sid=92e707&_nc_ohc=joVdZ7b0uZ4Q7kNvwEyWUUA&_nc_oc=AdqPTGtXbSvNGMNgFG96X88jHAsPYDrRArzo8hogkbQatErRWDmcGqzbxtKmRAwDNa0&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=MoiWi6kD-AcCrnTLT40mpA&_nc_ss=7b289&oh=00_AQOP5tubua2p0SbrZfrBUIhNMVDijVdoohG9cgLR1Ldf5w&oe=6AC487BD",
                        "https://scontent-atl3-2.xx.fbcdn.net/v/t45.5328-4/825291368_1598891671731725_6510958594325876185_n.jpg?stp=dst-jpg_p720x720_tt6&_nc_cat=102&ccb=1-7&_nc_sid=247b10&_nc_ohc=e-xe9w0EWDAQ7kNvwETgbfn&_nc_oc=Adrd3TaPnGcbb9u95lzdq_XLsNqkqBj9m7s4U25hYpUCpoOpaGzhfzEFzhP7zuI_kmQ&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=MoiWi6kD-AcCrnTLT40mpA&_nc_ss=7b289&oh=00_AQP3KFkt-qHwKBL8PbjPvjnRKgFRgFQX-KQ4Wuy2Gw2BNQ&oe=6AC48A6B",
                        "https://scontent-atl3-1.xx.fbcdn.net/v/t45.5328-4/825291720_953292804524687_6403957870263446208_n.jpg?stp=dst-jpg_p720x720_tt6&_nc_cat=108&ccb=1-7&_nc_sid=247b10&_nc_ohc=tOmsjfJtfCoQ7kNvwEB-aUE&_nc_oc=AdpNkB4ZgkWycKMgdweadE6peR3ZnWWpJVe-ukg4SaTw7kzkV4JI_SecXo9vCwErka4&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=MoiWi6kD-AcCrnTLT40mpA&_nc_ss=7b289&oh=00_AQONjALKRbn8Im3LrQ7Mh_6fRj_u-Af5gYAuBLHBncgMxg&oe=6AC484C6"
                      ]
                    },
                    "field_notes": "One Facebook Marketplace listing as shown publicly to logged-out visitors. Prices are seller asks; a sold status is not a verified sale record and its price is not a transaction price. Coordinates are the approximate public listing location, not an address. Seller details are not public to logged-out visitors. Image links are signed by Facebook and expire."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacebookItemJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/FacebookItemJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/FacebookItemJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/FacebookItemJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/vinted/listings": {
      "get": {
        "operationId": "vinted_listings",
        "tags": [
          "Vinted"
        ],
        "summary": "Vinted active listings",
        "description": "Search one page of Vinted active listings by keyword, on Vinted US, UK or 24 European sites, 96 rows a page. Prices are seller asks. No sold search. Results are cached for 15 minutes; a cache miss returns 202 and a job to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/vinted-listings"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Page to fetch, 1 to 10. Vinted serves 96 rows a page and stops at 960 results. Follow next_page until it is null. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be vinted.",
            "schema": {
              "type": "string",
              "enum": [
                "vinted"
              ],
              "default": "vinted"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Which Vinted site to search: us (vinted.com), uk (vinted.co.uk) or a European site such as fr, de, it, es, nl or pl. Results, prices, min_price and max_price use that site's currency. Optional.",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "uk",
                "fr",
                "de",
                "it",
                "es",
                "nl",
                "be",
                "pt",
                "at",
                "lu",
                "ie",
                "pl",
                "se",
                "cz",
                "dk",
                "fi",
                "lt",
                "hu",
                "ro",
                "sk",
                "hr",
                "gr",
                "si",
                "lv",
                "ee"
              ],
              "default": "us"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Vinted's own ranking, newest listed first, or item price low to high or high to low. best_match mixes in promoted listings, flagged with promoted.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "newest",
                "price_asc",
                "price_desc"
              ],
              "default": "best_match"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "Vinted's own conditions. Send one or more, separated by commas, like new_with_tags,very_good. Vinted applies the filter.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "new_with_tags",
                  "new_without_tags",
                  "very_good",
                  "good",
                  "satisfactory"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "brand_id",
            "in": "query",
            "required": false,
            "description": "Vinted numeric brand ID, such as 53 for Nike or 10 for Levi's. Keeps only that brand. Find one as brand_id on /v1/vinted/item. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "description": "Vinted numeric category ID, such as 1242 for men's trainers. Keeps only listings in that category. Find one as category.id on /v1/vinted/item. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VintedListingsJob"
                },
                "example": {
                  "request_id": "example-vinted-listings",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "vinted",
                    "country": "us",
                    "query": "levis 501",
                    "page": 1,
                    "page_size": 96,
                    "count": 96,
                    "reported_total": 960,
                    "next_page": 2,
                    "next_cursor": null,
                    "collected_at": "2026-10-05T19:48:25.104841+00:00",
                    "schema_version": 1,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 96,
                      "currency": "USD",
                      "median": 15,
                      "low": 5,
                      "high": 175,
                      "p25": 14,
                      "p75": 20
                    },
                    "data": [
                      {
                        "id": "10260644800",
                        "title": "Levi's 501 skinny",
                        "link": "https://www.vinted.com/items/10260644800-levis-501-skinny",
                        "promoted": false,
                        "displayed_price": {
                          "amount": 14,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$14.00",
                        "original_price": null,
                        "buyer_protection_fee": {
                          "amount": 1.4,
                          "currency": "USD"
                        },
                        "total_price": {
                          "amount": 15.4,
                          "currency": "USD"
                        },
                        "condition": "very_good",
                        "brand": "Levi's",
                        "size": "XS / US 2",
                        "like_count": 0,
                        "business_seller": false,
                        "image": "https://images1.vinted.net/t/02_003a5_m8wHry85poJA28UAyJCr1WA2/f800/13e5d734.webp?s=e6df922e1a9798f57bdee467f53a8f345ef4523f"
                      },
                      {
                        "id": "10260585714",
                        "title": "Vintage Y2K Levi's 501 XX Men's 32x24 Light Wash Blue Denim Button Fly Classic",
                        "link": "https://www.vinted.com/items/10260585714-vintage-y2k-levis-501-xx-mens-32x24-light-wash-blue-denim-button-fly-classic",
                        "promoted": true,
                        "displayed_price": {
                          "amount": 20,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$20.00",
                        "original_price": null,
                        "buyer_protection_fee": {
                          "amount": 1.7,
                          "currency": "USD"
                        },
                        "total_price": {
                          "amount": 21.7,
                          "currency": "USD"
                        },
                        "condition": "good",
                        "brand": "Levi's",
                        "size": "W32",
                        "like_count": 0,
                        "business_seller": false,
                        "image": "https://images1.vinted.net/t/05_0238b_gBhkADedty1WH89vgyEmA7Cs/f800/b78d0cb0.webp?s=b8931ac312a9e7bd1a2f707340ecdecdb74481f2"
                      }
                    ],
                    "field_notes": "Active Vinted listings from the chosen country site. Prices are seller asks, not sale prices. displayed_price is the item price; total_price adds Vinted's buyer protection fee and is what a buyer pays before shipping. Items listed in another currency are shown converted by Vinted. promoted marks paid placements, which Vinted mixes into best_match results. Vinted serves 96 rows a page and at most 10 pages, so reported_total stops at 960. Image links are signed by Vinted and expire. No sold search or final sale prices are provided."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VintedListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/VintedListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/VintedListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/VintedListingsJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/vinted/item": {
      "get": {
        "operationId": "vinted_item",
        "tags": [
          "Vinted"
        ],
        "summary": "Vinted listing details",
        "description": "Fetch one Vinted listing by ID or URL: description, condition, brand, size, colour, category, photos and the seller's rating. Status is not a verified sale. Cached 15 minutes; a cache miss returns 202 to poll.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/vinted-item"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Vinted item ID from search results, or an item URL such as vinted.com/items/... or vinted.fr/items/....",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 300
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Which Vinted site to read the listing on: us, uk or a European site such as fr or de. Use the country you searched. Optional.",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "uk",
                "fr",
                "de",
                "it",
                "es",
                "nl",
                "be",
                "pt",
                "at",
                "lu",
                "ie",
                "pl",
                "se",
                "cz",
                "dk",
                "fi",
                "lt",
                "hu",
                "ro",
                "sk",
                "hr",
                "gr",
                "si",
                "lv",
                "ee"
              ],
              "default": "us"
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional; must match the path.",
            "schema": {
              "type": "string",
              "enum": [
                "vinted"
              ],
              "default": "vinted"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VintedItemJob"
                },
                "example": {
                  "request_id": "example-vinted-item",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "vinted",
                    "country": "us",
                    "query": "10260644800",
                    "collected_at": "2026-10-05T19:48:25.210904+00:00",
                    "schema_version": 1,
                    "count": 1,
                    "data": {
                      "id": "10260644800",
                      "title": "Levi's 501 skinny",
                      "description": "Womens button fly levis size 26W/28L",
                      "link": "https://www.vinted.com/items/10260644800-levis-501-skinny",
                      "status": "active",
                      "displayed_price": {
                        "amount": 14,
                        "currency": "USD"
                      },
                      "condition": "very_good",
                      "brand": "Levi's",
                      "brand_id": 10,
                      "size": "XS / US 2",
                      "color": "Light blue",
                      "uploaded_text": "2 min ago",
                      "like_count": 0,
                      "category": {
                        "id": 1845,
                        "path": [
                          "Women",
                          "Clothing",
                          "Jeans",
                          "Straight jeans",
                          "Levi's Straight jeans"
                        ]
                      },
                      "photos": [
                        "https://images1.vinted.net/t/02_003a5_m8wHry85poJA28UAyJCr1WA2/f800/13e5d734.webp?s=e6df922e1a9798f57bdee467f53a8f345ef4523f",
                        "https://images1.vinted.net/t/04_0125a_Gz6vCm994Vsk6infWQyGDoTt/f800/bc57bd02.webp?s=e2b1cd6d341d6bf27215573b65781f303a2fd289",
                        "https://images1.vinted.net/t/02_01d72_btRRxD2Af7492qLPXnA83f8Y/f800/f0fb80bb.webp?s=e08bb3ebe71908b91f97c52b5f300eca81ddfee0",
                        "https://images1.vinted.net/t/06_004b2_TVTKjXJCRtvtqArmU4p4G76m/f800/fb96bfeb.webp?s=022c35d7a22709b3b5012d42bebca87828c2fb70"
                      ],
                      "seller": {
                        "name": "Example Seller",
                        "business": false,
                        "review_count": 3,
                        "rating": 5
                      }
                    },
                    "field_notes": "One Vinted listing as shown publicly to logged-out visitors. displayed_price is the seller's ask in the currency the seller listed in, before the buyer protection fee and shipping. status is active, reserved or unavailable; unavailable covers sold, hidden and removed items and is not a verified sale record. uploaded_text is Vinted's own relative wording. seller.rating is out of 5. Image links are signed by Vinted and expire."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VintedItemJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/VintedItemJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/VintedItemJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/VintedItemJob"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/sold": {
      "get": {
        "operationId": "legacy_sold",
        "tags": [
          "eBay"
        ],
        "summary": "Legacy alias of /v1/ebay/sold",
        "description": "Old path for /v1/ebay/sold. Same cache, billing and idempotency. No redirect. Use /v1/ebay/sold in new code.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/sold"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be ebay.",
            "schema": {
              "type": "string",
              "enum": [
                "ebay"
              ],
              "default": "ebay"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Which eBay site to search: us (ebay.com), uk (ebay.co.uk), ca (ebay.ca), au (ebay.com.au), de (ebay.de), fr (ebay.fr), it (ebay.it) or es (ebay.es). Results, prices, min_price and max_price use that site's currency. Optional.",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "uk",
                "ca",
                "au",
                "de",
                "fr",
                "it",
                "es"
              ],
              "default": "us"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "eBay's own condition groups. Send one or more, separated by commas, like new,open_box. new is Brand New, open_box is Open Box or New (Other), refurbished is every refurbished grade, used is Pre-Owned and for_parts is Parts Only. eBay applies the filter.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "new",
                  "open_box",
                  "refurbished",
                  "used",
                  "for_parts"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Result order. Leave it out for eBay's best match. recently_sold is newest sale first. price_asc and price_desc sort by price plus shipping.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "recently_sold",
                "price_asc",
                "price_desc"
              ]
            }
          },
          {
            "name": "item_location",
            "in": "query",
            "required": false,
            "description": "Where sellers are. domestic keeps sellers in the country you search; worldwide includes every country. Leave it out for the eBay site's own default. On fr the default is narrow: send worldwide for far more results.",
            "schema": {
              "type": "string",
              "enum": [
                "domestic",
                "worldwide"
              ]
            }
          },
          {
            "name": "buying_format",
            "in": "query",
            "required": false,
            "description": "Only one kind of listing: auction, buy_it_now (fixed price, including listings that also take offers) or best_offer (listings that take offers). eBay applies the filter.",
            "schema": {
              "type": "string",
              "enum": [
                "auction",
                "buy_it_now",
                "best_offer"
              ]
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "description": "Rows per page: 200, 120, 60 or 40. Send 200 for the most eBay gives; leaving it out means 40. A search costs one request at any size. Optional.",
            "schema": {
              "type": "integer",
              "enum": [
                40,
                60,
                120,
                200
              ]
            }
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "description": "eBay numeric category ID, such as 27386 for graphics cards. Keeps only listings in that category. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EbaySoldJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "ebay",
                    "country": "us",
                    "query": "sony wh-1000xm5",
                    "page": 1,
                    "page_size": 200,
                    "count": 1,
                    "reported_total": 1,
                    "next_page": null,
                    "next_cursor": null,
                    "collected_at": "2026-09-23T14:02:11Z",
                    "schema_version": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 1,
                      "currency": "USD",
                      "median": 189,
                      "low": 189,
                      "high": 189,
                      "p25": 189,
                      "p75": 189,
                      "earliest_sold_date": "2026-09-21",
                      "latest_sold_date": "2026-09-21",
                      "best_offer_accepted_count": 0,
                      "median_excluding_best_offer": 189
                    },
                    "data": [
                      {
                        "id": "123456789012",
                        "title": "Example eBay listing",
                        "link": "https://www.ebay.com/itm/123456789012",
                        "format": "fixed_price",
                        "displayed_price": {
                          "amount": 189,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$189.00",
                        "displayed_price_range": null,
                        "best_offer_accepted": false,
                        "displayed_shipping": {
                          "amount": 9.99,
                          "currency": "USD"
                        },
                        "shipping_text": "+$9.99 delivery",
                        "sold_date": "2026-09-21",
                        "sold_date_text": "Sep-21 14:35",
                        "condition": "Pre-Owned",
                        "bid_count": null,
                        "seller_text": "sonyfan_outlet (2,418) 99.6%",
                        "location_text": "Located in United States",
                        "image": "https://i.ebayimg.com/images/g/example/s-l500.jpg"
                      }
                    ],
                    "field_notes": "Fields that could not be read are null. Displayed prices are not verified accepted-offer prices."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EbaySoldJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbaySoldJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbaySoldJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbaySoldJob"
                    }
                  ]
                }
              }
            }
          }
        },
        "deprecated": true
      }
    },
    "/listings": {
      "get": {
        "operationId": "legacy_listings",
        "tags": [
          "eBay"
        ],
        "summary": "Legacy alias of /v1/ebay/listings",
        "description": "Old path for /v1/ebay/listings. Same cache, billing and idempotency. No redirect. Use /v1/ebay/listings in new code.",
        "externalDocs": {
          "url": "https://soldgraph.com/docs/api/listings"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            }
          },
          {
            "name": "marketplace",
            "in": "query",
            "required": false,
            "description": "Optional. If sent, it must be ebay.",
            "schema": {
              "type": "string",
              "enum": [
                "ebay"
              ],
              "default": "ebay"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Which eBay site to search: us (ebay.com), uk (ebay.co.uk), ca (ebay.ca), au (ebay.com.au), de (ebay.de), fr (ebay.fr), it (ebay.it) or es (ebay.es). Results, prices, min_price and max_price use that site's currency. Optional.",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "uk",
                "ca",
                "au",
                "de",
                "fr",
                "it",
                "es"
              ],
              "default": "us"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "eBay's listing order. Promoted listings are included and flagged.",
            "schema": {
              "type": "string",
              "enum": [
                "best_match",
                "newest",
                "price_asc",
                "ending_soon"
              ],
              "default": "best_match"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "description": "eBay's own condition groups. Send one or more, separated by commas, like new,open_box. new is Brand New, open_box is Open Box or New (Other), refurbished is every refurbished grade, used is Pre-Owned and for_parts is Parts Only. eBay applies the filter.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "new",
                  "open_box",
                  "refurbished",
                  "used",
                  "for_parts"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "item_location",
            "in": "query",
            "required": false,
            "description": "Where sellers are. domestic keeps sellers in the country you search; worldwide includes every country. Leave it out for the eBay site's own default. On fr the default is narrow: send worldwide for far more results.",
            "schema": {
              "type": "string",
              "enum": [
                "domestic",
                "worldwide"
              ]
            }
          },
          {
            "name": "buying_format",
            "in": "query",
            "required": false,
            "description": "Only one kind of listing: auction, buy_it_now (fixed price, including listings that also take offers) or best_offer (listings that take offers). eBay applies the filter.",
            "schema": {
              "type": "string",
              "enum": [
                "auction",
                "buy_it_now",
                "best_offer"
              ]
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "description": "Rows per page: 200, 120, 60 or 40. Send 200 for the most eBay gives; leaving it out means 40. A search costs one request at any size. Optional.",
            "schema": {
              "type": "integer",
              "enum": [
                40,
                60,
                120,
                200
              ]
            }
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "description": "eBay numeric category ID, such as 27386 for graphics cards. Keeps only listings in that category. Optional.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.",
            "schema": {
              "type": "string",
              "pattern": "^[!-~]{1,128}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete, including cache hits. Costs 1 request.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EbayListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "complete",
                  "credits": 1,
                  "cached": false,
                  "result": {
                    "provider": "ebay",
                    "country": "us",
                    "query": "canon ae-1 program",
                    "page": 1,
                    "page_size": 200,
                    "count": 1,
                    "reported_total": 1,
                    "next_page": null,
                    "next_cursor": null,
                    "collected_at": "2026-09-23T14:02:11Z",
                    "schema_version": 2,
                    "completeness": "provider_page_only",
                    "summary": {
                      "priced_count": 1,
                      "currency": "USD",
                      "median": 189,
                      "low": 189,
                      "high": 189,
                      "p25": 189,
                      "p75": 189
                    },
                    "data": [
                      {
                        "id": "123456789012",
                        "title": "Example eBay listing",
                        "link": "https://www.ebay.com/itm/123456789012",
                        "promoted": false,
                        "format": "fixed_price",
                        "displayed_price": {
                          "amount": 189,
                          "currency": "USD"
                        },
                        "displayed_price_text": "$189.00",
                        "displayed_price_range": null,
                        "displayed_shipping": {
                          "amount": 0,
                          "currency": "USD"
                        },
                        "shipping_text": "Free delivery",
                        "condition": "Pre-Owned",
                        "bid_count": null,
                        "ends_at": null,
                        "best_offer": false,
                        "seller_text": "filmcamerashop (1,204) 100%",
                        "location_text": null,
                        "image": "https://i.ebayimg.com/images/g/example/s-l500.jpg"
                      }
                    ],
                    "field_notes": "Listings are in the marketplace's order; promoted listings are included and flagged. Fields that could not be read are null."
                  }
                }
              }
            }
          },
          "202": {
            "description": "Pending. Poll `poll_url` (or `Location`) with the same API key. Both are paths: join them to https://api.soldgraph.com.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "Job path, like /v1/jobs/{id}.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Always 2. Prefer long-polling with ?wait=20.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EbayListingsJob"
                },
                "example": {
                  "request_id": "00000000-0000-4000-8000-000000000001",
                  "status": "pending",
                  "credits": 0,
                  "cached": false,
                  "poll_url": "/v1/jobs/00000000-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found. batch_not_found: No batch with that ID belongs to this account. Or a replay of a search that failed because of the search (the body is then the failed job): not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbayListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters. result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. duplicate_parameter: A parameter was sent more than once. sort_not_implemented: sort=best_deal is not available. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_wait: wait must be a whole number from 0 to 20. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page. invalid_format: format must be json or csv, and include must be results. Or a replay of a search that failed because of the search (the body is then the failed job): rejected, filter_not_supported, filter_not_applied, location_not_served.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbayListingsJob"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account. quota_exceeded: Your plan's allowance is used up, and you have no extra requests left. too_many_pending: Your account has too many searches still pending. Wait for results before sending more.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporary failure, or a replay of a failed search (the body is then the failed job). upstream_daily_limit: The marketplace's daily limit was reached, so new searches are paused. Cached results still work. queue_full: The collection queue is full. collection_unavailable: We can't collect from this marketplace right now. storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    },
                    {
                      "$ref": "#/components/schemas/EbayListingsJob"
                    }
                  ]
                }
              }
            }
          }
        },
        "deprecated": true
      }
    },
    "/jobs/{id}": {
      "get": {
        "operationId": "get_job",
        "tags": [
          "Jobs"
        ],
        "summary": "Get a search's status and result",
        "description": "Returns HTTP 200 whether the job is pending, complete or failed, so check status. Polling costs no requests but counts toward the per-minute rate limit.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "wait",
            "in": "query",
            "description": "Seconds to hold the request open until the job settles (long-poll).",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 20,
              "default": 0
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "csv returns the result's rows as a file, once the job is complete.",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "csv"
              ],
              "default": "json"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The job. Check status: pending, complete or failed.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/EbaySoldJob"
                    },
                    {
                      "$ref": "#/components/schemas/EbayListingsJob"
                    },
                    {
                      "$ref": "#/components/schemas/PoshmarkSoldJob"
                    },
                    {
                      "$ref": "#/components/schemas/PoshmarkListingsJob"
                    },
                    {
                      "$ref": "#/components/schemas/MercariSoldJob"
                    },
                    {
                      "$ref": "#/components/schemas/MercariListingsJob"
                    },
                    {
                      "$ref": "#/components/schemas/DepopListingsJob"
                    },
                    {
                      "$ref": "#/components/schemas/WhatnotListingsJob"
                    },
                    {
                      "$ref": "#/components/schemas/TcgplayerSearchJob"
                    },
                    {
                      "$ref": "#/components/schemas/TcgplayerSalesJob"
                    },
                    {
                      "$ref": "#/components/schemas/OfferupListingsJob"
                    },
                    {
                      "$ref": "#/components/schemas/OfferupItemJob"
                    },
                    {
                      "$ref": "#/components/schemas/FacebookListingsJob"
                    },
                    {
                      "$ref": "#/components/schemas/FacebookItemJob"
                    },
                    {
                      "$ref": "#/components/schemas/VintedListingsJob"
                    },
                    {
                      "$ref": "#/components/schemas/VintedItemJob"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. request_not_found: The job ID is well-formed but unknown, or belongs to another account. An ID that isn't a UUID is no such path: 404 not_found.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "414": {
            "description": "uri_too_long: The query string is longer than 2,048 characters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "invalid_wait: wait must be a whole number from 0 to 20.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/usage": {
      "get": {
        "operationId": "get_usage",
        "tags": [
          "Account"
        ],
        "summary": "Get your usage and allowance",
        "description": "The same numbers the API uses to accept or refuse a search. Free: costs no request, but counts toward the per-minute rate limit.",
        "responses": {
          "200": {
            "description": "Your usage.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Usage"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/batches": {
      "post": {
        "operationId": "create_batch",
        "tags": [
          "Batches"
        ],
        "summary": "Run many searches in one call",
        "description": "Each search is admitted, cached, charged and refunded exactly like a single GET. The call counts once toward the per-minute rate limit. A batch can hold as many searches as your plan allows pending at once.",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "description": "Makes a retry return the same batch.",
            "schema": {
              "type": "string",
              "maxLength": 128
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "searches"
                ],
                "properties": {
                  "defaults": {
                    "type": "object",
                    "description": "Inputs applied to every search unless the search sets its own.",
                    "additionalProperties": true,
                    "properties": {
                      "endpoint": {
                        "type": "string",
                        "enum": [
                          "ebay/sold",
                          "ebay/listings",
                          "poshmark/sold",
                          "poshmark/listings",
                          "mercari/sold",
                          "mercari/listings",
                          "depop/listings",
                          "whatnot/listings",
                          "tcgplayer/search",
                          "tcgplayer/sales",
                          "offerup/listings",
                          "offerup/item",
                          "facebook/listings",
                          "facebook/item",
                          "vinted/listings",
                          "vinted/item"
                        ]
                      }
                    }
                  },
                  "searches": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 200,
                    "items": {
                      "type": "object",
                      "required": [
                        "q"
                      ],
                      "additionalProperties": true,
                      "description": "One search: `endpoint` plus the same inputs its GET route takes. `endpoint` may come from `defaults` instead.",
                      "properties": {
                        "endpoint": {
                          "type": "string",
                          "enum": [
                            "ebay/sold",
                            "ebay/listings",
                            "poshmark/sold",
                            "poshmark/listings",
                            "mercari/sold",
                            "mercari/listings",
                            "depop/listings",
                            "whatnot/listings",
                            "tcgplayer/search",
                            "tcgplayer/sales",
                            "offerup/listings",
                            "offerup/item",
                            "facebook/listings",
                            "facebook/item",
                            "vinted/listings",
                            "vinted/item"
                          ],
                          "description": "Required unless defaults.endpoint is set."
                        },
                        "q": {
                          "type": "string"
                        },
                        "pages": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10,
                          "description": "eBay only. Expands to one search per page, starting at page 1."
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Every search was already cached.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Batch"
                }
              }
            }
          },
          "202": {
            "description": "Accepted. Poll the Location.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Batch"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "idempotency_conflict: This Idempotency-Key was already used with different search parameters.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large: The batch body is over 256 KB.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "415": {
            "description": "unsupported_media_type: A batch must be sent as Content-Type: application/json.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_or_invalid_query: An unknown parameter, or a value outside the documented range. error.param names the input to fix when it is one of the route's inputs. invalid_idempotency_key: Idempotency-Key must be 1–128 printable ASCII characters, with no spaces. invalid_body: The batch body is not JSON, or has no searches list. batch_too_large: The batch holds more searches than your plan allows at once. pages counts as one search per page.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/batches/{id}": {
      "get": {
        "operationId": "get_batch",
        "tags": [
          "Batches"
        ],
        "summary": "Get a batch's status, summaries and results",
        "description": "Polling costs no requests but counts toward the per-minute rate limit.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "wait",
            "in": "query",
            "description": "Seconds to hold the request open until every search settles (long-poll).",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 20,
              "default": 0
            }
          },
          {
            "name": "include",
            "in": "query",
            "description": "Send results to include each search's full result.",
            "schema": {
              "type": "string",
              "enum": [
                "results"
              ]
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "csv returns every row of every complete search as one file, once nothing is pending.",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "csv"
              ],
              "default": "json"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The batch.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Batch"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "description": "invalid_api_key: The API key is missing, malformed or revoked.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "account_suspended: The account is suspended, so none of its keys work. Email support to restore it. origin_not_allowed: A browser sent the request from a site that isn't allowed. Call the API from your server.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found: No such path. batch_not_found: No batch with that ID belongs to this account.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed: Wrong method for this route. Searches, jobs and usage use GET. Only /v1/batches takes POST.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "result_not_ready: CSV was requested before every search settled. Poll as JSON until status is complete, then ask for CSV.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "invalid_wait: wait must be a whole number from 0 to 20. invalid_format: format must be json or csv, and include must be results.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited: More than 60 API calls this minute for your account.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "storage_unavailable: Our database is briefly unavailable. origin_unavailable: The edge couldn't reach our API server. service_unconfigured: The API is misconfigured on our side. Contact support.",
            "headers": {
              "X-Request-Id": {
                "description": "Unique ID for this response. Include it when you contact support.",
                "schema": {
                  "type": "string"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "scheme": "bearer",
        "description": "An API key from the Soldgraph dashboard, starting with sg_."
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "invalid_api_key",
                  "account_suspended",
                  "origin_not_allowed",
                  "not_found",
                  "request_not_found",
                  "batch_not_found",
                  "method_not_allowed",
                  "idempotency_conflict",
                  "result_not_ready",
                  "payload_too_large",
                  "uri_too_long",
                  "unsupported_media_type",
                  "unsupported_or_invalid_query",
                  "duplicate_parameter",
                  "sort_not_implemented",
                  "invalid_idempotency_key",
                  "invalid_wait",
                  "invalid_body",
                  "batch_too_large",
                  "invalid_format",
                  "rate_limited",
                  "quota_exceeded",
                  "too_many_pending",
                  "upstream_daily_limit",
                  "queue_full",
                  "collection_unavailable",
                  "storage_unavailable",
                  "origin_unavailable",
                  "service_unconfigured"
                ]
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words. On every error; safe to show to a user."
              },
              "param": {
                "type": "string",
                "description": "On a 422: the input to fix, when it is one of the route's inputs. Never a value."
              },
              "index": {
                "type": "integer",
                "description": "On a refused batch: the position of the search to fix."
              },
              "upgrade_url": {
                "type": "string",
                "format": "uri",
                "description": "On quota_exceeded: the billing page, where you move to a larger plan or buy extra requests."
              }
            }
          }
        }
      },
      "Money": {
        "type": "object",
        "required": [
          "amount",
          "currency"
        ],
        "properties": {
          "amount": {
            "type": "number"
          },
          "currency": {
            "type": "string",
            "description": "ISO 4217 code, like USD."
          }
        }
      },
      "EbaySoldRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "format",
          "displayed_price",
          "displayed_price_text",
          "displayed_price_range",
          "best_offer_accepted",
          "displayed_shipping",
          "shipping_text",
          "sold_date",
          "sold_date_text",
          "condition",
          "bid_count",
          "seller_text",
          "location_text",
          "image"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The marketplace's listing ID."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Listing title as shown."
          },
          "link": {
            "type": "string",
            "description": "URL of the listing on the eBay site you searched, like https://www.ebay.co.uk/itm/…."
          },
          "format": {
            "type": "string",
            "description": "auction when the sale had bids, otherwise fixed_price."
          },
          "displayed_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "{ amount, currency } parsed from the price shown. Null if it couldn't be read. Null when eBay shows a price range for a multi-variation listing (\"$247.00 to $911.00\"): the amount wouldn't say which variant. The range is in displayed_price_range and displayed_price_text. When best_offer_accepted is true, this is the asking price, not the sale price."
          },
          "displayed_price_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The price text as shown, like $189.00, £124.46 or €230.00."
          },
          "displayed_price_range": {
            "type": [
              "object",
              "null"
            ],
            "required": [
              "low",
              "high",
              "currency"
            ],
            "properties": {
              "low": {
                "type": "number"
              },
              "high": {
                "type": "number"
              },
              "currency": {
                "type": "string",
                "description": "ISO 4217 code, like USD."
              }
            },
            "description": "{ low, high, currency } when eBay shows a price range for a multi-variation listing (\"$247.00 to $911.00\"). Null otherwise. displayed_price is null for these rows, so they stay out of the summary maths."
          },
          "best_offer_accepted": {
            "type": "boolean",
            "description": "True when the sale closed on an accepted Best Offer. eBay does not publish the accepted amount on sold listings, so on these rows displayed_price is the seller's asking price. summary.median_excluding_best_offer gives the median of the rows whose price is the sale price."
          },
          "displayed_shipping": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "{ amount, currency } read from exact shipping text, in the site's currency, like +$9.99 delivery, +£3.92 delivery or +€6.99 Lieferung. Free shipping is 0, in every country's wording. Estimates and Shipping not specified are null."
          },
          "shipping_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Shipping text as shown, like +$9.99 delivery, Free delivery or + €10.49 de envío."
          },
          "sold_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Sale date as YYYY-MM-DD. eBay's text has no year, so we use the most recent date that matches. Null if the text couldn't be read."
          },
          "sold_date_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Sold date text as shown. eBay leaves out the year. The order depends on the site: Sep-21 14:35 (US, Australia, France, Italy, Spain), 21-Sep 14:35 (UK, Canada) or 21. Sep. 14:35 (Germany)."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "eBay's condition text as shown, in the site's language, like Pre-Owned, Pre-owned or Gebraucht. To filter by condition in any language, use condition."
          },
          "bid_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of bids, for auctions. Null for fixed-price sales."
          },
          "seller_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller text as eBay shows it: username, feedback count and positive percentage, e.g. clutch_supply (1,325) 99.7%."
          },
          "location_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller location text as eBay shows it, like Located in United States or da Germania. Often null for sellers in the country you searched."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Image URL on i.ebayimg.com."
          }
        }
      },
      "EbaySoldPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "next_cursor",
          "page_size",
          "summary",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Total matches the marketplace reports for the search. It may be rounded or capped."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "next_cursor": {
            "type": "null",
            "description": "Always null. eBay pages by number: send page=next_page for the next page."
          },
          "page_size": {
            "type": "integer",
            "description": "Rows per page, as eBay reports it."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price in the site's currency."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "earliest_sold_date": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Oldest sold date on this page."
              },
              "latest_sold_date": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Newest sold date on this page."
              },
              "best_offer_accepted_count": {
                "type": "integer",
                "description": "Rows that sold by accepted Best Offer. eBay shows only the asking price on these, so they are kept out of `median_excluding_best_offer`."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              },
              "median_excluding_best_offer": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Median over rows whose displayed price is the sale price: accepted Best Offers, where eBay shows only the asking price, are left out. Null when every priced row was a Best Offer."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "earliest_sold_date",
              "latest_sold_date",
              "best_offer_accepted_count",
              "p25",
              "p75",
              "median_excluding_best_offer"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high, p25, p75, earliest_sold_date, latest_sold_date and best_offer_accepted_count. No row is removed from data. Rows with a price range or an unread price are left out of the maths."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EbaySoldRow"
            }
          }
        }
      },
      "EbaySoldJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/EbaySoldPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "EbayListingsRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "promoted",
          "format",
          "displayed_price",
          "displayed_price_text",
          "displayed_price_range",
          "displayed_shipping",
          "shipping_text",
          "condition",
          "bid_count",
          "ends_at",
          "best_offer",
          "seller_text",
          "location_text",
          "image"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The marketplace's listing ID."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Listing title as shown."
          },
          "link": {
            "type": "string",
            "description": "URL of the listing on the eBay site you searched, like https://www.ebay.co.uk/itm/…."
          },
          "promoted": {
            "type": "boolean",
            "description": "True for a sponsored placement."
          },
          "format": {
            "type": "string",
            "description": "auction when the listing shows bids or an end time, otherwise fixed_price."
          },
          "displayed_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "{ amount, currency } parsed from the price shown: the asking price or current bid. Null if it couldn't be read. Null when eBay shows a price range for a multi-variation listing (\"$247.00 to $911.00\"): the amount wouldn't say which variant. The range is in displayed_price_range and displayed_price_text."
          },
          "displayed_price_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The price text as shown, like $189.00, £124.46 or €230.00."
          },
          "displayed_price_range": {
            "type": [
              "object",
              "null"
            ],
            "required": [
              "low",
              "high",
              "currency"
            ],
            "properties": {
              "low": {
                "type": "number"
              },
              "high": {
                "type": "number"
              },
              "currency": {
                "type": "string",
                "description": "ISO 4217 code, like USD."
              }
            },
            "description": "{ low, high, currency } when eBay shows a price range for a multi-variation listing (\"$247.00 to $911.00\"). Null otherwise. displayed_price is null for these rows, so they stay out of the summary maths."
          },
          "displayed_shipping": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "{ amount, currency } read from exact shipping text, in the site's currency, like +$9.99 delivery, +£3.92 delivery or +€6.99 Lieferung. Free shipping is 0, in every country's wording. Estimates and Shipping not specified are null."
          },
          "shipping_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Shipping text as shown, like +$9.99 delivery, Free delivery or + €10.49 de envío."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "eBay's condition text as shown, in the site's language, like Pre-Owned, Pre-owned or Gebraucht. To filter by condition in any language, use condition."
          },
          "bid_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of bids, for auctions."
          },
          "ends_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Auction end time, ISO 8601 UTC."
          },
          "best_offer": {
            "type": "boolean",
            "description": "True when the seller accepts Best Offers."
          },
          "seller_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller text as eBay shows it: username, feedback count and positive percentage, e.g. clutch_supply (1,325) 99.7%."
          },
          "location_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Item location text as shown."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Image URL on i.ebayimg.com."
          }
        }
      },
      "EbayListingsPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "next_cursor",
          "page_size",
          "summary",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Total matches the marketplace reports for the search. It may be rounded or capped."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "next_cursor": {
            "type": "null",
            "description": "Always null. eBay pages by number: send page=next_page for the next page."
          },
          "page_size": {
            "type": "integer",
            "description": "Rows per page, as eBay reports it."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price in the site's currency."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "p25",
              "p75"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high. No row is removed from data. Rows with a price range or an unread price are left out of the maths."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EbayListingsRow"
            }
          }
        }
      },
      "EbayListingsJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/EbayListingsPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "PoshmarkSoldRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "displayed_price",
          "displayed_price_text",
          "sold_date",
          "sold_date_text",
          "condition",
          "seller_text",
          "brand",
          "size",
          "image"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The marketplace's listing ID."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Listing title as shown."
          },
          "link": {
            "type": "string",
            "description": "URL of the listing on the marketplace."
          },
          "displayed_price": {
            "$ref": "#/components/schemas/Money",
            "description": "{ amount, currency } of the listing's asking price, in the country's currency. Not what the buyer paid."
          },
          "displayed_price_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The price text as shown, like $189.00, or C$40.00 on Poshmark Canada."
          },
          "sold_date": {
            "type": "string",
            "description": "Date part of sold_date_text, as YYYY-MM-DD."
          },
          "sold_date_text": {
            "type": "string",
            "description": "When the listing's inventory changed to sold out, as an ISO 8601 timestamp. Not a verified sale time."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "Poshmark's own condition code, as Poshmark returns it, like nwt or ug. See condition codes."
          },
          "seller_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The seller's Poshmark username."
          },
          "brand": {
            "type": [
              "string",
              "null"
            ],
            "description": "Brand as the seller entered it."
          },
          "size": {
            "type": [
              "string",
              "null"
            ],
            "description": "Size as the seller entered it."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Image URL on Poshmark's image CDN."
          }
        }
      },
      "PoshmarkSoldPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "page_size",
          "summary",
          "next_cursor",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Total matches the marketplace reports for the search. It may be rounded or capped."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "page_size": {
            "type": "integer",
            "description": "Rows Poshmark returned before we removed listings that aren't sold. It can be larger than count."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "earliest_sold_date": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Oldest sold date on this page."
              },
              "latest_sold_date": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Newest sold date on this page."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "earliest_sold_date",
              "latest_sold_date",
              "p25",
              "p75"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high, p25, p75, earliest_sold_date and latest_sold_date. No row is removed from data. Rows with no single readable price are left out of the maths."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Send this as cursor, with page=next_page, to get the next page. Null on the last page."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PoshmarkSoldRow"
            }
          }
        }
      },
      "PoshmarkSoldJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/PoshmarkSoldPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "PoshmarkListingsRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "displayed_price",
          "displayed_price_text",
          "condition",
          "brand",
          "size",
          "listed_at",
          "seller_text",
          "image"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The marketplace's listing ID."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Listing title as shown."
          },
          "link": {
            "type": "string",
            "description": "URL of the listing on the marketplace."
          },
          "displayed_price": {
            "$ref": "#/components/schemas/Money",
            "description": "{ amount, currency } of the seller's current asking price, in the country's currency."
          },
          "displayed_price_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The price text, like $35.00, or C$40.00 on Poshmark Canada."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "Poshmark's own condition code, as Poshmark returns it, like nwt or ug. See condition codes."
          },
          "brand": {
            "type": [
              "string",
              "null"
            ],
            "description": "Brand as the seller entered it."
          },
          "size": {
            "type": [
              "string",
              "null"
            ],
            "description": "Size as the seller entered it."
          },
          "listed_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the listing was published, as an ISO 8601 timestamp."
          },
          "seller_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The seller's Poshmark username."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Image URL on Poshmark's image CDN."
          }
        }
      },
      "PoshmarkListingsPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "page_size",
          "summary",
          "next_cursor",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Total matches the marketplace reports for the search. It may be rounded or capped."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "page_size": {
            "type": "integer",
            "description": "Rows Poshmark returned before we removed listings that aren't for sale. It can be larger than count."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "p25",
              "p75"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high. No row is removed from data. Rows with no single readable price are left out of the maths."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Send this as cursor, with page=next_page, to get the next page. Null on the last page."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PoshmarkListingsRow"
            }
          }
        }
      },
      "PoshmarkListingsJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/PoshmarkListingsPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "MercariSoldRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "displayed_price",
          "displayed_price_text",
          "sold_date",
          "sold_date_text",
          "condition",
          "seller_text",
          "image",
          "condition_id",
          "category_id",
          "brand_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The marketplace's listing ID."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Listing title as shown."
          },
          "link": {
            "type": "string",
            "description": "URL of the listing on the marketplace."
          },
          "displayed_price": {
            "$ref": "#/components/schemas/Money",
            "description": "{ amount, currency } of the price Mercari shows. It can differ from what the buyer paid."
          },
          "displayed_price_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The price text as shown, like $189.00."
          },
          "sold_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "The date part of sold_date_text, as YYYY-MM-DD. Null when Mercari doesn't report a sold time."
          },
          "sold_date_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The sold time Mercari reports, as a UTC timestamp. Null when Mercari doesn't report one."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mercari's condition label: New, Like New, Good, Fair or Poor."
          },
          "seller_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The seller's Mercari ID, as a string."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Image URL on Mercari's image CDN."
          },
          "condition_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Mercari's condition number: 1 new, 2 like new, 3 good, 4 fair, 5 poor."
          },
          "category_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Mercari's category ID for the listing."
          },
          "brand_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Mercari's brand ID. The brand name isn't returned."
          }
        }
      },
      "MercariSoldPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "page_size",
          "summary",
          "next_cursor",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Total matches the marketplace reports for the search. It may be rounded or capped."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "page_size": {
            "type": "integer",
            "description": "Rows Mercari returned before we removed listings that aren't sold. It can be larger than count."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "earliest_sold_date": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Oldest sold date on this page."
              },
              "latest_sold_date": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Newest sold date on this page."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "earliest_sold_date",
              "latest_sold_date",
              "p25",
              "p75"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high, p25, p75, earliest_sold_date and latest_sold_date. No row is removed from data. Rows with no single readable price are left out of the maths."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Send this as cursor, with page=next_page, to get the next page. Null on the last page."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MercariSoldRow"
            }
          }
        }
      },
      "MercariSoldJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/MercariSoldPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "MercariListingsRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "displayed_price",
          "displayed_price_text",
          "condition",
          "listed_at",
          "seller_text",
          "image",
          "condition_id",
          "category_id",
          "brand_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The marketplace's listing ID."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Listing title as shown."
          },
          "link": {
            "type": "string",
            "description": "URL of the listing on the marketplace."
          },
          "displayed_price": {
            "$ref": "#/components/schemas/Money",
            "description": "{ amount, currency } of the price Mercari shows."
          },
          "displayed_price_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The price text, like $35.00."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mercari's condition label: New, Like New, Good, Fair or Poor."
          },
          "listed_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the listing was published, as an ISO 8601 timestamp."
          },
          "seller_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The seller's Mercari ID, as a string."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Image URL on Mercari's image CDN."
          },
          "condition_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Mercari's condition number: 1 new, 2 like new, 3 good, 4 fair, 5 poor."
          },
          "category_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Mercari's category ID for the listing."
          },
          "brand_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Mercari's brand ID. The brand name isn't returned."
          }
        }
      },
      "MercariListingsPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "page_size",
          "summary",
          "next_cursor",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Total matches the marketplace reports for the search. It may be rounded or capped."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "page_size": {
            "type": "integer",
            "description": "Rows Mercari returned before we removed listings that aren't for sale. It can be larger than count."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "p25",
              "p75"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high. No row is removed from data. Rows with no single readable price are left out of the maths."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Send this as cursor, with page=next_page, to get the next page. Null on the last page."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MercariListingsRow"
            }
          }
        }
      },
      "MercariListingsJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/MercariListingsPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "DepopListingsRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "promoted",
          "displayed_price",
          "displayed_price_text",
          "condition",
          "brand",
          "size",
          "location_text",
          "like_count",
          "image",
          "price_includes"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The marketplace's listing ID."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Depop's listing description, up to 2,000 characters."
          },
          "link": {
            "type": "string",
            "description": "URL of the listing on the marketplace."
          },
          "promoted": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether Depop marks the listing as boosted."
          },
          "displayed_price": {
            "$ref": "#/components/schemas/Money",
            "description": "{ amount, currency } of Depop's headline price, in the country's currency. It includes the parts listed in price_includes. It isn't what a buyer paid."
          },
          "displayed_price_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The headline price as text, like $52.00, £24.75, A$50.00 or C$89.00."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "Depop's condition code, like used_good."
          },
          "brand": {
            "type": [
              "string",
              "null"
            ],
            "description": "The brand Depop shows, when there is one."
          },
          "size": {
            "type": [
              "string",
              "null"
            ],
            "description": "The sizes available, when Depop lists them."
          },
          "location_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The location Depop shows, when there is one."
          },
          "like_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "How many Depop users have liked the listing. Null when Depop doesn't report it."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Image URL on Depop's photo CDN."
          },
          "price_includes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "What the headline price includes: buyer_fee, shipping_price, tax, or a mix. An empty array means none of them."
          }
        }
      },
      "DepopListingsPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "page_size",
          "summary",
          "next_cursor",
          "reported_total",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The total Depop reports, when there is one. Often null after the first page. It doesn't mean full coverage."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "page_size": {
            "type": "integer",
            "description": "Rows Depop returned before we removed listings that aren't active listings from the country you searched, priced in its currency. It can be larger than count."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "p25",
              "p75"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high. No row is removed from data. Rows with no single readable price are left out of the maths."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Send this as cursor, with page=next_page, to get the next page. Null on the last page."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DepopListingsRow"
            }
          }
        }
      },
      "DepopListingsJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/DepopListingsPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "WhatnotListingsRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "displayed_price",
          "displayed_price_text",
          "condition",
          "image",
          "quantity",
          "listed_at",
          "seller_text",
          "grading_service",
          "grade",
          "card_set",
          "card_number",
          "language"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Whatnot opaque listing ID; use it to deduplicate across pages."
          },
          "title": {
            "type": "string",
            "description": "Seller title, up to 2,000 characters."
          },
          "link": {
            "type": "string",
            "description": "Public Whatnot listing URL."
          },
          "displayed_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Asking price as { amount, currency } in the country's currency, excluding shipping and checkout charges. Null for an unequal variant range or an absent source price. Never a transaction price."
          },
          "displayed_price_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Formatted asking price or variant range, like $40.00 or C$189.00."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller-supplied condition, when present."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary image on the Whatnot image CDN."
          },
          "quantity": {
            "type": "integer",
            "description": "Available quantity reported by the source at collection time."
          },
          "listed_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Source creation timestamp in UTC, when present. Not a sale timestamp."
          },
          "seller_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Public seller username."
          },
          "grading_service": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller-supplied grading service; not independently verified."
          },
          "grade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller-supplied grade; not independently verified."
          },
          "card_set": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller-supplied card set, when present."
          },
          "card_number": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller-supplied card number, when present."
          },
          "language": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller-supplied language, when present."
          }
        }
      },
      "WhatnotListingsPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "page_size",
          "summary",
          "next_cursor",
          "reported_total",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Always null: no reliable total is provided by this search."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "page_size": {
            "type": "integer",
            "description": "Source rows, including non-listing text dividers, before excluding unavailable inventory, sellers in another country and prices in another currency."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "p25",
              "p75"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high. No row is removed from data. Rows with no single readable price are left out of the maths."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Send as cursor with page=next_page. Null at the end."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WhatnotListingsRow"
            }
          }
        }
      },
      "WhatnotListingsJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/WhatnotListingsPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "TcgplayerSearchRow": {
        "type": "object",
        "required": [
          "product_id",
          "name",
          "link",
          "product_line",
          "set_name",
          "set_code",
          "card_number",
          "rarity",
          "market_price",
          "lowest_ask",
          "lowest_ask_with_shipping",
          "listed_median",
          "active_listing_count",
          "offers"
        ],
        "properties": {
          "product_id": {
            "type": "integer",
            "description": "Canonical TCGplayer product ID."
          },
          "name": {
            "type": "string",
            "description": "Product title."
          },
          "link": {
            "type": "string",
            "description": "Public product page."
          },
          "product_line": {
            "type": [
              "string",
              "null"
            ],
            "description": "TCGplayer game or product line."
          },
          "set_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Set name."
          },
          "set_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Set code."
          },
          "card_number": {
            "type": [
              "string",
              "null"
            ],
            "description": "Card number when supplied."
          },
          "rarity": {
            "type": [
              "string",
              "null"
            ],
            "description": "Source rarity when supplied."
          },
          "market_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "TCGplayer estimate calculated from completed sales, not an individual sale."
          },
          "lowest_ask": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Lowest advertised seller ask, before shipping."
          },
          "lowest_ask_with_shipping": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Source estimate of lowest ask including shipping."
          },
          "listed_median": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Median advertised ask when available."
          },
          "active_listing_count": {
            "type": "integer",
            "description": "Source-reported number of active listings."
          },
          "offers": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Up to three current seller-offer snapshots with asking and shipping prices."
          }
        }
      },
      "TcgplayerSearchPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "page_size",
          "summary",
          "reported_total",
          "next_cursor",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Source-reported result count for this response."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "page_size": {
            "type": "integer",
            "description": "Number of source rows in this response."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "p25",
              "p75"
            ],
            "description": "Price maths over market_price for the products on this page: priced_count, currency, median, low, high, p25 and p75. Products with no market price are left out of the maths, never removed from data."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Always null; use next_page for offset pagination."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgplayerSearchRow"
            }
          }
        }
      },
      "TcgplayerSearchJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/TcgplayerSearchPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "TcgplayerSalesRow": {
        "type": "object",
        "required": [
          "product_id",
          "title",
          "condition",
          "variant",
          "language",
          "quantity",
          "purchase_price",
          "shipping_price",
          "total_price",
          "sold_at"
        ],
        "properties": {
          "product_id": {
            "type": "integer",
            "description": "TCGplayer product ID."
          },
          "title": {
            "type": "string",
            "description": "Product title from the sale row."
          },
          "condition": {
            "type": "string",
            "description": "Condition sold."
          },
          "variant": {
            "type": "string",
            "description": "Printing or variant sold."
          },
          "language": {
            "type": "string",
            "description": "Language sold."
          },
          "quantity": {
            "type": "integer",
            "description": "Quantity in transaction."
          },
          "purchase_price": {
            "$ref": "#/components/schemas/Money",
            "description": "Paid item price excluding shipping."
          },
          "shipping_price": {
            "$ref": "#/components/schemas/Money",
            "description": "Shipping separately reported by source."
          },
          "total_price": {
            "$ref": "#/components/schemas/Money",
            "description": "Sum of purchase_price and shipping_price; excludes tax and other checkout charges."
          },
          "sold_at": {
            "type": "string",
            "description": "Transaction timestamp from source in UTC."
          }
        }
      },
      "TcgplayerSalesPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "product_id",
          "page_size",
          "summary",
          "reported_total",
          "next_cursor",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Source-reported result count for this response."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "product_id": {
            "type": "integer",
            "description": "Exact TCGplayer product ID requested."
          },
          "page_size": {
            "type": "integer",
            "description": "Number of source rows in this response."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle item price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest item price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest item price."
              },
              "earliest_sold_date": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Oldest sold date on this page."
              },
              "latest_sold_date": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Newest sold date on this page."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "earliest_sold_date",
              "latest_sold_date",
              "p25",
              "p75"
            ],
            "description": "Price maths over the sales on this page: priced_count, currency, median, low, high of purchase_price (the item price, without shipping), plus earliest_sold_date and latest_sold_date. Each sale counts once, whatever its quantity."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Always null; sales pagination is not exposed."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgplayerSalesRow"
            }
          }
        }
      },
      "TcgplayerSalesJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/TcgplayerSalesPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "OfferupListingsRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "displayed_price",
          "displayed_price_text",
          "call_for_price",
          "firm_price",
          "condition",
          "location_text",
          "city",
          "state",
          "image",
          "vehicle_miles",
          "promoted",
          "flags"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "OfferUp listing ID. Pass it to /v1/offerup/item for full details."
          },
          "title": {
            "type": "string",
            "description": "Seller title, up to 2,000 characters."
          },
          "link": {
            "type": "string",
            "description": "Public OfferUp listing URL."
          },
          "displayed_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "USD asking price as { amount, currency }. Null when the seller asks buyers to call. Never a sale price."
          },
          "displayed_price_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Formatted USD asking price."
          },
          "call_for_price": {
            "type": "boolean",
            "description": "The listing shows \"call for price\", mostly dealer vehicles."
          },
          "firm_price": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "The seller marked the price firm, when the source says."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "Condition label when search shows one. Usually null; the item endpoint always has condition."
          },
          "location_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller-chosen area, such as Oakland, CA. Not an address."
          },
          "city": {
            "type": [
              "string",
              "null"
            ],
            "description": "City from location_text when it reads \"City, ST\"."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "description": "Two-letter state from location_text."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Thumbnail URL on the OfferUp image CDN."
          },
          "vehicle_miles": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Odometer reading shown on vehicle listings."
          },
          "promoted": {
            "type": "boolean",
            "description": "A paid placement OfferUp mixed into the results."
          },
          "flags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Raw source flags, such as LOCAL_PICKUP or CALL_FOR_PRICE."
          }
        }
      },
      "OfferupListingsPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "location",
          "vehicle_search",
          "category_id",
          "page_size",
          "summary",
          "count",
          "next_cursor",
          "reported_total",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows returned: the page minus listings already returned on earlier pages of this search."
          },
          "reported_total": {
            "type": "null",
            "description": "Always null: OfferUp does not report a total."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "location": {
            "type": "object",
            "description": "The search center as zip, latitude and longitude. Also radius_miles (applied), requested_radius_miles, and widened_radius_miles: the wider area OfferUp used for this page because nearby results ran out, else null."
          },
          "vehicle_search": {
            "type": "boolean",
            "description": "True when OfferUp treated the search as cars and trucks. Vehicle radius options, filters and sorts apply only then."
          },
          "category_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Category OfferUp applied, including one it picked from the keywords, such as 5.1 for \"honda civic\"."
          },
          "page_size": {
            "type": "integer",
            "description": "Listing rows on the source page, including repeats from earlier pages."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "p25",
              "p75"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high. No row is removed from data. Rows with no single readable price are left out of the maths."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Send as cursor with page=next_page. Null at the end, when a page is mostly repeats, or after about 220 listings."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OfferupListingsRow"
            }
          }
        }
      },
      "OfferupListingsJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/OfferupListingsPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "OfferupItemRow": {
        "type": "object",
        "required": [
          "id",
          "item_number",
          "title",
          "link",
          "status",
          "description",
          "displayed_price",
          "original_price",
          "condition",
          "condition_code",
          "posted_at",
          "edited_at",
          "quantity",
          "firm_price",
          "location",
          "local_pickup",
          "shipping",
          "category",
          "photos",
          "seller",
          "vehicle"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "OfferUp listing ID."
          },
          "item_number": {
            "type": "string",
            "description": "OfferUp numeric item number. Also accepted as q."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "The listing's title."
          },
          "link": {
            "type": "string",
            "description": "The listing's page on OfferUp."
          },
          "status": {
            "type": "string",
            "description": "active, pending, sold, removed or another lowercase source state. The seller sets it: sold is not a verified sale, and its price is not a sale price."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller description, up to 10,000 characters."
          },
          "displayed_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Current USD asking price."
          },
          "original_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Earlier asking price when the seller lowered it, else null."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "new, open_box, refurbished, used, for_parts or other. condition_code is the raw source number."
          },
          "condition_code": {
            "type": [
              "integer",
              "null"
            ],
            "description": "OfferUp's own numeric code for the condition, like 40 for used."
          },
          "posted_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the listing was posted, in UTC."
          },
          "edited_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Last seller edit in UTC, when present."
          },
          "quantity": {
            "type": [
              "integer",
              "null"
            ],
            "description": "How many the seller has for sale."
          },
          "firm_price": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "True when the seller marked the price as firm."
          },
          "location": {
            "type": "object",
            "description": "Public listing area as { name, latitude, longitude }. Approximate, not an address."
          },
          "local_pickup": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Local pickup is offered."
          },
          "shipping": {
            "type": "object",
            "description": "available, price (a USD object or null), seller_pays and buy_now."
          },
          "category": {
            "type": "object",
            "description": "Category id, and path names from the top level down."
          },
          "photos": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Full-size photo URLs on the OfferUp image CDN."
          },
          "seller": {
            "type": "object",
            "description": "Public profile: id, name, joined_at, items_sold, rating_average, rating_count, business, auto_dealer and truyou_verified."
          },
          "vehicle": {
            "type": [
              "object",
              "null"
            ],
            "description": "For Vehicles listings: year, make, model, trim, miles, vin, title_status, transmission, drivetrain, fuel_type, color and body. Seller supplied."
          }
        }
      },
      "OfferupItemPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Total matches the marketplace reports for the search. It may be rounded or capped."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "data": {
            "$ref": "#/components/schemas/OfferupItemRow"
          }
        }
      },
      "OfferupItemJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/OfferupItemPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "FacebookListingsRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "pending",
          "displayed_price",
          "displayed_price_text",
          "original_price",
          "condition",
          "city",
          "state",
          "city_id",
          "approx_distance_miles",
          "listed_at",
          "delivery",
          "category_id",
          "image"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Facebook Marketplace item ID. Pass it to /v1/facebook/item for full details."
          },
          "title": {
            "type": "string",
            "description": "Seller title, up to 2,000 characters."
          },
          "link": {
            "type": "string",
            "description": "Public Facebook Marketplace listing URL."
          },
          "pending": {
            "type": "boolean",
            "description": "True when the seller marked a sale in progress. Sold listings are left out."
          },
          "displayed_price": {
            "$ref": "#/components/schemas/Money",
            "description": "USD asking price as { amount, currency }. 0 means free. Never a sale price."
          },
          "displayed_price_text": {
            "type": "string",
            "description": "Formatted USD asking price."
          },
          "original_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Earlier asking price shown struck through when the seller lowered it, else null."
          },
          "condition": {
            "type": "null",
            "description": "Always null: Facebook search pages don't show condition. Use /v1/facebook/item, or filter with condition."
          },
          "city": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller-chosen city."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "description": "Two-letter state code."
          },
          "city_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Facebook city page ID for that city."
          },
          "approx_distance_miles": {
            "type": [
              "number",
              "null"
            ],
            "description": "Miles from your search point to the listing's city, not to the item. Null when the city is not in our place table."
          },
          "listed_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the listing was posted, in UTC."
          },
          "delivery": {
            "type": "object",
            "description": "local_pickup and shipping booleans from the listing's delivery options."
          },
          "category_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Facebook Marketplace category ID."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary photo on Facebook's CDN. The link is signed and expires after some days."
          }
        }
      },
      "FacebookListingsPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "location",
          "page_size",
          "summary",
          "count",
          "next_page",
          "reported_total",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows returned: the page minus sold or hidden listings and listings outside your radius."
          },
          "reported_total": {
            "type": "null",
            "description": "Always null: Facebook does not report a total."
          },
          "next_page": {
            "type": "null",
            "description": "Always null. Facebook serves one page to logged-out visitors; narrow with sort, prices or days_since_listed to reach more listings."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "location": {
            "type": "object",
            "description": "The search center as zip, latitude and longitude, your radius_miles, the Facebook city searched as source_city (id, name, state, latitude, longitude, distance_miles from your point), and source_radius_km, the radius sent to Facebook, widened to cover your circle from that city."
          },
          "page_size": {
            "type": "integer",
            "description": "Listing rows on the source page."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "p25",
              "p75"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high. No row is removed from data. Rows with no single readable price are left out of the maths."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacebookListingsRow"
            }
          }
        }
      },
      "FacebookListingsJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/FacebookListingsPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "FacebookItemRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "status",
          "description",
          "displayed_price",
          "original_price",
          "condition",
          "listed_at",
          "location",
          "delivery",
          "category",
          "photos"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Facebook Marketplace item ID."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "The listing's title."
          },
          "link": {
            "type": "string",
            "description": "The listing's page on Facebook Marketplace."
          },
          "status": {
            "type": "string",
            "description": "active, pending, sold or unavailable. The seller sets it: sold is not a verified sale, and its price is not a sale price. A deleted listing fails with not_found and costs nothing."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller description, up to 10,000 characters."
          },
          "displayed_price": {
            "$ref": "#/components/schemas/Money",
            "description": "Current USD asking price."
          },
          "original_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Earlier asking price shown struck through, else null."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "new, used_like_new, used_good, used_fair or another source value, as the seller chose."
          },
          "listed_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the listing was posted, in UTC."
          },
          "location": {
            "type": "object",
            "description": "name (city, state), approximate latitude and longitude, and city_id. Not an address."
          },
          "delivery": {
            "type": "object",
            "description": "local_pickup, shipping, shipping_offered and shipping_price_text as Facebook shows it."
          },
          "category": {
            "type": "object",
            "description": "Category id and slug, such as bicycles."
          },
          "photos": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Photo URLs on Facebook's CDN, in listing order. Signed links that expire."
          }
        }
      },
      "FacebookItemPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Total matches the marketplace reports for the search. It may be rounded or capped."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "data": {
            "$ref": "#/components/schemas/FacebookItemRow"
          }
        }
      },
      "FacebookItemJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/FacebookItemPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "VintedListingsRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "link",
          "promoted",
          "displayed_price",
          "displayed_price_text",
          "original_price",
          "buyer_protection_fee",
          "total_price",
          "condition",
          "brand",
          "size",
          "like_count",
          "business_seller",
          "image"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Vinted item ID. Pass it to /v1/vinted/item for full details."
          },
          "title": {
            "type": "string",
            "description": "Seller title, up to 2,000 characters."
          },
          "link": {
            "type": "string",
            "description": "Public listing URL on the Vinted site you searched."
          },
          "promoted": {
            "type": "boolean",
            "description": "True for a paid placement. Vinted mixes these into best_match results."
          },
          "displayed_price": {
            "$ref": "#/components/schemas/Money",
            "description": "Item asking price as { amount, currency }, in the site's currency. Before the buyer protection fee and shipping. Never a sale price."
          },
          "displayed_price_text": {
            "type": "string",
            "description": "Formatted item price, like $14.00, £42.54, €25.00 or PLN 45.00."
          },
          "original_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Earlier item price when Vinted shows a discounted one, else null."
          },
          "buyer_protection_fee": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Vinted's buyer protection fee for this item."
          },
          "total_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Item price plus the buyer protection fee: what a buyer pays before shipping."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "new_with_tags, new_without_tags, very_good, good or satisfactory, as the seller chose, in the same codes on every site. Null if Vinted shows another value."
          },
          "brand": {
            "type": [
              "string",
              "null"
            ],
            "description": "Brand name as shown on the listing card."
          },
          "size": {
            "type": [
              "string",
              "null"
            ],
            "description": "Size as shown, like M / US 8-10 or 10. Null for items without sizes."
          },
          "like_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "How many members have favourited the listing."
          },
          "business_seller": {
            "type": "boolean",
            "description": "True when the seller is a registered business (Vinted Pro)."
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Main photo on Vinted's CDN. The link is signed and expires."
          }
        }
      },
      "VintedListingsPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "page_size",
          "summary",
          "count",
          "next_page",
          "reported_total",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows returned. Every row on the source page is returned."
          },
          "reported_total": {
            "type": "integer",
            "description": "Matches as Vinted reports them. Vinted stops counting at 960, so 960 means \"960 or more\"."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The next page number, or null on the last page. Never more than 10."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "page_size": {
            "type": "integer",
            "description": "Listing rows on the source page, up to 96."
          },
          "summary": {
            "type": "object",
            "properties": {
              "priced_count": {
                "type": "integer",
                "description": "Rows on this page that show one price."
              },
              "currency": {
                "type": "string",
                "description": "Currency of the amounts below."
              },
              "median": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Middle displayed price of those rows."
              },
              "low": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Lowest displayed price."
              },
              "high": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Highest displayed price."
              },
              "p25": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "First-quartile displayed price: a quarter of priced rows are at or below it."
              },
              "p75": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
              }
            },
            "required": [
              "priced_count",
              "currency",
              "median",
              "low",
              "high",
              "p25",
              "p75"
            ],
            "description": "Price maths over the rows on this page: priced_count, currency, median, low, high. No row is removed from data. Rows with no single readable price are left out of the maths."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VintedListingsRow"
            }
          }
        }
      },
      "VintedListingsJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/VintedListingsPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "VintedItemRow": {
        "type": "object",
        "required": [
          "id",
          "title",
          "description",
          "link",
          "status",
          "displayed_price",
          "condition",
          "brand",
          "brand_id",
          "size",
          "color",
          "uploaded_text",
          "like_count",
          "category",
          "photos",
          "seller"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Vinted item ID."
          },
          "title": {
            "type": "string",
            "description": "The listing's title."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seller description, up to 10,000 characters."
          },
          "link": {
            "type": "string",
            "description": "The listing's page on Vinted."
          },
          "status": {
            "type": "string",
            "description": "active, reserved or unavailable. unavailable covers sold, hidden and removed items: it is not a verified sale. A deleted listing fails with not_found and costs nothing."
          },
          "displayed_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Asking price as { amount, currency }, in the currency the seller listed in. That can differ from the site's currency. Before the buyer protection fee and shipping. Null if the page shows no price."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "description": "new_with_tags, new_without_tags, very_good, good or satisfactory, as the seller chose."
          },
          "brand": {
            "type": [
              "string",
              "null"
            ],
            "description": "Brand name."
          },
          "brand_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Vinted brand ID. Use it as brand_id on /v1/vinted/listings."
          },
          "size": {
            "type": [
              "string",
              "null"
            ],
            "description": "Size as shown. Null for items without sizes."
          },
          "color": {
            "type": [
              "string",
              "null"
            ],
            "description": "Colours as shown, like Grey, Black."
          },
          "uploaded_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "When it was listed, in Vinted's own words, like 2 days ago. Vinted shows no exact date."
          },
          "like_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "How many members have favourited the listing."
          },
          "category": {
            "type": "object",
            "description": "Category id (use it as category_id on /v1/vinted/listings) and path, the category names from the top down."
          },
          "photos": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Photo URLs on Vinted's CDN, in listing order. Signed links that expire."
          },
          "seller": {
            "type": "object",
            "description": "Public seller details: name (username), business, review_count and rating out of 5 (null with no reviews)."
          }
        }
      },
      "VintedItemPage": {
        "type": "object",
        "required": [
          "provider",
          "country",
          "query",
          "page",
          "count",
          "reported_total",
          "next_page",
          "collected_at",
          "schema_version",
          "completeness",
          "field_notes",
          "data"
        ],
        "properties": {
          "provider": {
            "type": "string",
            "description": "Marketplace ID, like ebay or poshmark."
          },
          "country": {
            "type": "string",
            "description": "The country searched: us, or on eBay the country you sent."
          },
          "query": {
            "type": "string",
            "description": "The q you sent, with extra spaces removed."
          },
          "page": {
            "type": "integer",
            "description": "The page you asked for."
          },
          "count": {
            "type": "integer",
            "description": "Rows in result.data on this page."
          },
          "reported_total": {
            "type": "integer",
            "description": "Total matches the marketplace reports for the search. It may be rounded or capped."
          },
          "next_page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
          },
          "collected_at": {
            "type": "string",
            "description": "When we collected the page, as an ISO 8601 timestamp."
          },
          "schema_version": {
            "type": "integer",
            "description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
          },
          "completeness": {
            "type": "string",
            "description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
          },
          "field_notes": {
            "type": "string",
            "description": "Plain-text notes on how to read this page's fields."
          },
          "data": {
            "$ref": "#/components/schemas/VintedItemRow"
          }
        }
      },
      "VintedItemJob": {
        "type": "object",
        "required": [
          "request_id",
          "status",
          "credits",
          "cached"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "description": "ID of this request. Poll it at /v1/jobs/{request_id}."
          },
          "status": {
            "type": "string",
            "description": "pending, complete or failed. Always check it, even on HTTP 200.",
            "enum": [
              "pending",
              "complete",
              "failed"
            ]
          },
          "credits": {
            "type": "integer",
            "description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
          },
          "cached": {
            "type": "boolean",
            "description": "True when the result came from the 15-minute cache."
          },
          "poll_url": {
            "type": "string",
            "description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
          },
          "result": {
            "$ref": "#/components/schemas/VintedItemPage"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "page_mismatch",
                  "schema",
                  "network",
                  "upstream",
                  "throttled",
                  "blocked",
                  "rejected",
                  "not_found",
                  "filter_not_supported",
                  "filter_not_applied",
                  "location_not_served",
                  "auth",
                  "daily_limit",
                  "deadline_exceeded",
                  "credential_storage"
                ],
                "description": "Failed job code."
              },
              "message": {
                "type": "string",
                "description": "What the code means, in plain words."
              }
            }
          }
        }
      },
      "Usage": {
        "type": "object",
        "required": [
          "plan",
          "used",
          "limit",
          "remaining",
          "extra_requests",
          "window",
          "shared_allowance",
          "rate_limit_per_minute"
        ],
        "properties": {
          "plan": {
            "type": "string",
            "description": "Your plan, like free or pro."
          },
          "used": {
            "type": "integer",
            "description": "Requests counted against the allowance: in the rolling 30 days, or of the one-time free credit when window is one_time. Free accounts include linked accounts."
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The plan's allowance per rolling 30 days, or the size of the one-time free credit when window is one_time. Null when unlimited."
          },
          "remaining": {
            "type": [
              "integer",
              "null"
            ],
            "description": "limit minus used, never below 0. Null when unlimited."
          },
          "extra_requests": {
            "type": "integer",
            "description": "Extra requests bought on top of the plan. Spent only after the allowance."
          },
          "window": {
            "type": "string",
            "enum": [
              "rolling_30_days",
              "one_time"
            ],
            "description": "rolling_30_days: usage frees up as it ages out. one_time: a free account's one-time credit, which does not refill."
          },
          "shared_allowance": {
            "type": "boolean",
            "description": "True when other linked free accounts draw on the same allowance."
          },
          "rate_limit_per_minute": {
            "type": "integer",
            "description": "API calls allowed per minute, job polls and this call included."
          }
        }
      },
      "Batch": {
        "type": "object",
        "required": [
          "batch_id",
          "status",
          "created_at",
          "counts",
          "credits",
          "items"
        ],
        "properties": {
          "batch_id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "complete"
            ],
            "description": "complete once no search is pending."
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "counts": {
            "type": "object",
            "required": [
              "pending",
              "complete",
              "failed",
              "rejected"
            ],
            "properties": {
              "pending": {
                "type": "integer"
              },
              "complete": {
                "type": "integer"
              },
              "failed": {
                "type": "integer"
              },
              "rejected": {
                "type": "integer"
              }
            }
          },
          "credits": {
            "type": "integer",
            "description": "Requests this batch has cost so far."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "index",
                "endpoint",
                "q",
                "request_id",
                "status",
                "cached",
                "credits"
              ],
              "properties": {
                "index": {
                  "type": "integer",
                  "description": "Position in the batch, after `pages` is expanded."
                },
                "endpoint": {
                  "type": "string",
                  "description": "The search route, like ebay/sold."
                },
                "q": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "request_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "uuid",
                  "description": "The search's own job. Read it at /v1/jobs/{id}. Null when the search was rejected."
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "pending",
                    "complete",
                    "failed",
                    "rejected"
                  ]
                },
                "cached": {
                  "type": "boolean"
                },
                "credits": {
                  "type": "integer",
                  "description": "1 when the search completed, else 0."
                },
                "rows": {
                  "type": "integer",
                  "description": "Rows in the result. Complete searches only."
                },
                "summary": {
                  "type": "object",
                  "description": "The result's price summary, where the marketplace has one."
                },
                "result": {
                  "type": "object",
                  "description": "The full result. Only with include=results."
                },
                "error": {
                  "type": "object",
                  "required": [
                    "code"
                  ],
                  "properties": {
                    "code": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
