Servers Playground How we check Add a server Log in

Soldgraph

Working · 830 ms

io.github.soldgraph/soldgraphv1.0.1

Sold comps and active listings from eBay, Poshmark, Mercari, Depop, Vinted, TCGplayer and more.

Commerce

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.soldgraph.com/mcp

Authorization (required)

Bearer <your Soldgraph API key>. Get one at https://soldgraph.com/app/keys

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

account_usage Read-only

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.

This tool takes no arguments.

Soldgraph MCP server | mcptry

Tools (19)

account_usage

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.

read-only

No arguments.

Input schema (JSON)

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

api_status

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

read-only

No arguments.

Input schema (JSON)

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

depop_listings

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
page	integer	Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.
count	integer	Most rows per page. Depop can return fewer.
cursor	string	The previous page's next_cursor. Leave it out on page 1. Keep the query, filters and count the same.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.
country	string	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	string	One Depop condition: brand_new, used_like_new, used_excellent, used_good or used_fair. Rows return the same codes.
max_price	integer	Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.
min_price	integer	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.

Input schema (JSON)

ebay_listings

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
page	integer	Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.
sort	string	eBay's listing order. Promoted listings are included and flagged.
count	integer	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.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.
country	string	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.

ebay_sold

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
page	integer	Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.
sort	string	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.
count	integer	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.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.
country	string	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.

facebook_item

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

read-only

Argument	Type	Description
q*	string	Facebook Marketplace item ID from search results, or a facebook.com/marketplace/item/... URL.

Input schema (JSON)

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

facebook_listings

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
lat	number	Latitude of the search center in decimal degrees. Use with lon instead of zip. Rounded to 4 decimals (about 11 m).
lon	number	Longitude of the search center in decimal degrees. Use with lat.
zip	string	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.
page	integer	Always 1. Facebook serves one page per search, so there is no page 2. Optional.
sort	string	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.
fields

get_result

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

read-only

Argument	Type	Description
fields	string	summary keeps the fields most agents need; full returns every field the API returns.
request_id*	string	request_id from the pending result.

Input schema (JSON)

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

mercari_listings

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
page	integer	Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.
sort	string	Mercari's result order. newest sorts by when the listing was created.
count	integer	Most rows per page. Mercari can return fewer.
cursor	string	The previous page's next_cursor. Leave it out on page 1. Keep every other parameter the same.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.
brand_id	integer	Mercari numeric brand ID. Optional.
condition

mercari_sold

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
page	integer	Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.
sort	string	Mercari's result order. newest sorts by when the listing was created. recently_sold sorts by Mercari's sold time.
count	integer	Most rows per page. Mercari can return fewer.
cursor	string	The previous page's next_cursor. Leave it out on page 1. Keep every other parameter the same.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.
brand_id	integer	Mercari numeric brand ID. Optional.
condition

offerup_item

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

read-only

Argument	Type	Description
q*	string	OfferUp listing ID from search results, the numeric item number, or an offerup.com/item/detail/... URL.

Input schema (JSON)

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

offerup_listings

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
lat	number	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	number	Longitude of the search center in decimal degrees. Use with lat.
zip	string	Five-digit US ZIP code to search around. Send zip, or both lat and lon. Unknown ZIP codes return 422.
page	integer	Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.
sort	string	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.
cursor	string	Previous page's next_cursor. Omit it on page 1. Keep every other parameter unchanged.

poshmark_listings

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
page	integer	Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.
sort	string	Poshmark's listing order. ending_soon isn't available on Poshmark and returns 422.
cursor	string	The previous page's next_cursor. Leave it out on page 1. Required on every later page.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.
country	string	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	string

poshmark_sold

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
page	integer	Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.
cursor	string	The previous page's next_cursor. Leave it out on page 1. Required on every later page.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.
country	string	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	string	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.
max_price

tcgplayer_sales

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

read-only

Argument	Type	Description
q*	string	Exact numeric TCGplayer product ID, such as 451396.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.

Input schema (JSON)

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

tcgplayer_search

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
page	integer	Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.
count	integer	Products per source page.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.
product_line	string	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.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "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",
      "default": 1,
      "maximum": 100,
      "minimum": 1,
      "description": "Source page to fetch. Where an endpoint has cursor, pages after 1 also need it."
    },
    "count": {
      "type": "integer",
      "default": 24,
      "maximum": 24,
      "minimum": 1,
      "description": "Products per source page."
    },
    "fields": {
      "enum": [
        "summary",
        "full"
      ],
      "type": "string",
      "default": "summary",
      "description": "summary keeps the fields most agents need; full returns every field the API returns."
    },
    "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."
    }
  },
  "additionalProperties": false
}

vinted_item

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

read-only

Argument	Type	Description
q*	string	Vinted item ID from search results, or an item URL such as vinted.com/items/... or vinted.fr/items/....
country	string	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.

Input schema (JSON)

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

vinted_listings

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
page	integer	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.
sort	string	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.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.
country	string	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.
brand_id	integer	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.

whatnot_listings

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

read-only

Argument	Type	Description
q*	string	Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.
page	integer	Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.
sort	string	Source ranking, creation time descending, or asking price ascending/descending.
count	integer	Most source rows per page. Whatnot can return fewer.
grade	string	Exact seller-supplied grade, such as 10. This is not certificate verification.
cursor	string	Previous page's next_cursor. Omit on page 1. Keep query, filters, sort and count unchanged.
fields	string	summary keeps the fields most agents need; full returns every field the API returns.

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

Input schema (JSON)

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

Input schema (JSON)

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

Input schema (JSON)

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

Input schema (JSON)

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

Input schema (JSON)

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

Input schema (JSON)

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

Input schema (JSON)

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

Input schema (JSON)

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

Input schema (JSON)

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

Input schema (JSON)

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