Soldgraph

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/sold

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "country": {
      "type": "string",
      "enum": [
        "us",
        "uk",
        "ca",
        "au",
        "de",
        "fr",
        "it",
        "es"
      ],
      "default": "us",
      "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."
    },
    "condition": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "new",
          "open_box",
          "refurbished",
          "used",
          "for_parts"
        ]
      },
      "uniqueItems": true,
      "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."
    },
    "sort": {
      "type": "string",
      "enum": [
        "best_match",
        "recently_sold",
        "price_asc",
        "price_desc"
      ],
      "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."
    },
    "item_location": {
      "type": "string",
      "enum": [
        "domestic",
        "worldwide"
      ],
      "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."
    },
    "buying_format": {
      "type": "string",
      "enum": [
        "auction",
        "buy_it_now",
        "best_offer"
      ],
      "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."
    },
    "count": {
      "type": "integer",
      "enum": [
        40,
        60,
        120,
        200
      ],
      "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."
    },
    "category_id": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2147483647,
      "description": "eBay numeric category ID, such as 27386 for graphics cards. Keeps only listings in that category. Optional."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/listings

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "country": {
      "type": "string",
      "enum": [
        "us",
        "uk",
        "ca",
        "au",
        "de",
        "fr",
        "it",
        "es"
      ],
      "default": "us",
      "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."
    },
    "sort": {
      "type": "string",
      "enum": [
        "best_match",
        "newest",
        "price_asc",
        "ending_soon"
      ],
      "default": "best_match",
      "description": "eBay's listing order. Promoted listings are included and flagged."
    },
    "condition": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "new",
          "open_box",
          "refurbished",
          "used",
          "for_parts"
        ]
      },
      "uniqueItems": true,
      "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."
    },
    "item_location": {
      "type": "string",
      "enum": [
        "domestic",
        "worldwide"
      ],
      "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."
    },
    "buying_format": {
      "type": "string",
      "enum": [
        "auction",
        "buy_it_now",
        "best_offer"
      ],
      "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."
    },
    "count": {
      "type": "integer",
      "enum": [
        40,
        60,
        120,
        200
      ],
      "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."
    },
    "category_id": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2147483647,
      "description": "eBay numeric category ID, such as 27386 for graphics cards. Keeps only listings in that category. Optional."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Search one page of Poshmark sold listings by keyword, on Poshmark US or Canada. Pages use a cursor. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/poshmark-sold

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "country": {
      "type": "string",
      "enum": [
        "us",
        "ca"
      ],
      "default": "us",
      "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."
    },
    "condition": {
      "type": "string",
      "enum": [
        "nwt",
        "uln",
        "ug",
        "uf"
      ],
      "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."
    },
    "cursor": {
      "type": "string",
      "description": "The previous page's next_cursor. Leave it out on page 1. Required on every later page."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/poshmark-listings

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "country": {
      "type": "string",
      "enum": [
        "us",
        "ca"
      ],
      "default": "us",
      "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."
    },
    "sort": {
      "type": "string",
      "enum": [
        "best_match",
        "newest",
        "price_asc"
      ],
      "default": "best_match",
      "description": "Poshmark's listing order. ending_soon isn't available on Poshmark and returns 422."
    },
    "condition": {
      "type": "string",
      "enum": [
        "nwt",
        "uln",
        "ug",
        "uf"
      ],
      "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."
    },
    "cursor": {
      "type": "string",
      "description": "The previous page's next_cursor. Leave it out on page 1. Required on every later page."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Search one page of Mercari US sold listings by keyword, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/mercari-sold

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "condition": {
      "type": "string",
      "enum": [
        "new",
        "like_new",
        "good",
        "fair",
        "poor"
      ],
      "description": "One Mercari condition: new, like_new, good, fair or poor. Rows return Mercari's label and condition_id."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "The previous page's next_cursor. Leave it out on page 1. Keep every other parameter the same."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 100,
      "description": "Most rows per page. Mercari can return fewer."
    },
    "sort": {
      "type": "string",
      "enum": [
        "best_match",
        "newest",
        "price_asc",
        "price_desc",
        "most_popular",
        "recently_sold"
      ],
      "default": "recently_sold",
      "description": "Mercari's result order. newest sorts by when the listing was created. recently_sold sorts by Mercari's sold time."
    },
    "category_id": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2147483647,
      "description": "Mercari numeric category ID. Optional."
    },
    "brand_id": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2147483647,
      "description": "Mercari numeric brand ID. Optional."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Search one page of Mercari US active listings by keyword, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/mercari-listings

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "condition": {
      "type": "string",
      "enum": [
        "new",
        "like_new",
        "good",
        "fair",
        "poor"
      ],
      "description": "One Mercari condition: new, like_new, good, fair or poor. Rows return Mercari's label and condition_id."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "The previous page's next_cursor. Leave it out on page 1. Keep every other parameter the same."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 100,
      "description": "Most rows per page. Mercari can return fewer."
    },
    "sort": {
      "type": "string",
      "enum": [
        "best_match",
        "newest",
        "price_asc",
        "price_desc",
        "most_popular"
      ],
      "default": "best_match",
      "description": "Mercari's result order. newest sorts by when the listing was created."
    },
    "category_id": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2147483647,
      "description": "Mercari numeric category ID. Optional."
    },
    "brand_id": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2147483647,
      "description": "Mercari numeric brand ID. Optional."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/depop-listings

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "country": {
      "type": "string",
      "enum": [
        "us",
        "uk",
        "au",
        "ca"
      ],
      "default": "us",
      "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."
    },
    "condition": {
      "type": "string",
      "enum": [
        "brand_new",
        "used_like_new",
        "used_excellent",
        "used_good",
        "used_fair"
      ],
      "description": "One Depop condition: brand_new, used_like_new, used_excellent, used_good or used_fair. Rows return the same codes."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 24,
      "description": "Most rows per page. Depop can return fewer."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "The previous page's next_cursor. Leave it out on page 1. Keep the query, filters and count the same."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/whatnot-listings

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "country": {
      "type": "string",
      "enum": [
        "us",
        "ca"
      ],
      "default": "us",
      "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."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 24,
      "default": 24,
      "description": "Most source rows per page. Whatnot can return fewer."
    },
    "sort": {
      "type": "string",
      "enum": [
        "best_match",
        "newest",
        "price_asc",
        "price_desc"
      ],
      "default": "best_match",
      "description": "Source ranking, creation time descending, or asking price ascending/descending."
    },
    "condition": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Exact case-sensitive seller attribute, such as Near Mint or Graded. Values vary by category."
    },
    "category": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Whatnot category slug using lowercase letters, digits and underscores, such as pokemon_cards."
    },
    "grading_service": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Exact case-sensitive seller-supplied grading service, such as PSA."
    },
    "grade": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "Exact seller-supplied grade, such as 10. This is not certificate verification."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "Previous page's next_cursor. Omit on page 1. Keep query, filters, sort and count unchanged."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Search TCGplayer products by keyword; returns catalog identity, source market-price estimate and a few active seller asks. Cached 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/tcgplayer-search

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 24,
      "default": 24,
      "description": "Products per source page."
    },
    "product_line": {
      "type": "string",
      "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."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/tcgplayer-sales

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 12,
      "description": "Exact numeric TCGplayer product ID, such as 451396."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/offerup-listings

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "zip": {
      "type": "string",
      "description": "Five-digit US ZIP code to search around. Send zip, or both lat and lon. Unknown ZIP codes return 422."
    },
    "lat": {
      "type": "number",
      "minimum": 17,
      "maximum": 72,
      "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)."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": -64,
      "description": "Longitude of the search center in decimal degrees. Use with lat."
    },
    "radius": {
      "type": "integer",
      "enum": [
        5,
        10,
        20,
        25,
        30,
        50,
        80,
        100,
        200,
        5000
      ],
      "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."
    },
    "category": {
      "type": "string",
      "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."
    },
    "condition": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "new",
          "open_box",
          "refurbished",
          "used",
          "for_parts",
          "other"
        ]
      },
      "uniqueItems": true,
      "description": "One condition, or several separated by commas, such as new,open_box. OfferUp labels these differently for vehicles; see the endpoint page."
    },
    "sort": {
      "type": "string",
      "enum": [
        "best_match",
        "newest",
        "nearest",
        "price_asc",
        "price_desc",
        "newest_model",
        "lowest_mileage"
      ],
      "default": "best_match",
      "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."
    },
    "vehicle_make": {
      "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,
      "description": "Vehicle searches only. One make, or several separated by commas, such as honda,toyota."
    },
    "vehicle_max_mileage": {
      "type": "integer",
      "enum": [
        0,
        25000,
        50000,
        75000,
        100000,
        125000,
        150000,
        175000,
        200000
      ],
      "description": "Vehicle searches only. Highest odometer reading."
    },
    "vehicle_style": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "car",
          "suv",
          "truck",
          "van"
        ]
      },
      "uniqueItems": true,
      "description": "Vehicle searches only. One body style, or several separated by commas."
    },
    "vehicle_transmission": {
      "type": "string",
      "enum": [
        "automatic",
        "manual"
      ],
      "description": "Vehicle searches only."
    },
    "vehicle_drivetrain": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "awd",
          "fwd",
          "rwd"
        ]
      },
      "uniqueItems": true,
      "description": "Vehicle searches only. One drivetrain, or several separated by commas."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "Previous page's next_cursor. Omit it on page 1. Keep every other parameter unchanged."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/offerup-item

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "OfferUp listing ID from search results, the numeric item number, or an offerup.com/item/detail/... URL."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/facebook-listings

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1,
      "default": 1,
      "description": "Always 1. Facebook serves one page per search, so there is no page 2. Optional."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "zip": {
      "type": "string",
      "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."
    },
    "lat": {
      "type": "number",
      "minimum": 17,
      "maximum": 72,
      "description": "Latitude of the search center in decimal degrees. Use with lon instead of zip. Rounded to 4 decimals (about 11 m)."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": -64,
      "description": "Longitude of the search center in decimal degrees. Use with lat."
    },
    "radius": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "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."
    },
    "sort": {
      "type": "string",
      "enum": [
        "best_match",
        "newest",
        "price_asc",
        "price_desc"
      ],
      "default": "best_match",
      "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."
    },
    "condition": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "new",
          "used_like_new",
          "used_good",
          "used_fair"
        ]
      },
      "uniqueItems": true,
      "description": "One condition, or several separated by commas, such as used_like_new,used_good."
    },
    "delivery": {
      "type": "string",
      "enum": [
        "local_pickup",
        "shipping"
      ],
      "description": "Only listings offering local pickup, or only listings that ship."
    },
    "days_since_listed": {
      "type": "integer",
      "enum": [
        1,
        7,
        30
      ],
      "description": "Only listings posted in the last 1, 7 or 30 days."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/facebook-item

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "Facebook Marketplace item ID from search results, or a facebook.com/marketplace/item/... URL."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/vinted-listings

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 1,
      "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."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "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."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price."
    },
    "country": {
      "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",
      "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."
    },
    "sort": {
      "type": "string",
      "enum": [
        "best_match",
        "newest",
        "price_asc",
        "price_desc"
      ],
      "default": "best_match",
      "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."
    },
    "condition": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "new_with_tags",
          "new_without_tags",
          "very_good",
          "good",
          "satisfactory"
        ]
      },
      "uniqueItems": true,
      "description": "Vinted's own conditions. Send one or more, separated by commas, like new_with_tags,very_good. Vinted applies the filter."
    },
    "brand_id": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2147483647,
      "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."
    },
    "category_id": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2147483647,
      "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."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

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. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/vinted-item

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "Vinted item ID from search results, or an item URL such as vinted.com/items/... or vinted.fr/items/...."
    },
    "country": {
      "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",
      "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."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Finish a search that was still collecting when its tool call returned. Free: it never charges again.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "request_id from the pending result."
    },
    "fields": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    }
  },
  "required": [
    "request_id"
  ],
  "additionalProperties": false
}

Your plan, requests used in the rolling 30 days or of the one-time free credit, remaining allowance, extra requests and rate limit. The same numbers the API enforces. Free.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Live health, success rate and response time for every marketplace. Free.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}