Soldgraph is an MCP server published by io.github.soldgraph, hosted at api.soldgraph.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 19 tools, including ebay_sold, ebay_listings, poshmark_sold, poshmark_listings, mercari_sold.
Sold comps and active listings from eBay, Poshmark, Mercari, Depop, Vinted, TCGplayer and more.
Nothing else in the archive shares these values.
Inferred from the host name and headers: what a server runs on, not who runs it.
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
| Parameter | 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 |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| 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. |
| condition | array | 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. |
| 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. |
| category_id | integer | eBay numeric category ID, such as 27386 for graphics cards. Keeps only listings in that category. Optional. |
| buying_format | string | 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 | string | 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. |
{
"name": "ebay_sold",
"title": "eBay sold listings",
"description": "Search one page of eBay sold listings by keyword, on eBay US or seven other countries. A page holds up to 200 rows with count=200, or 40 without it. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/sold",
"inputSchema": {
"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
},
"annotations": {
"title": "eBay sold listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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. |
| condition | array | 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. |
| 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. |
| category_id | integer | eBay numeric category ID, such as 27386 for graphics cards. Keeps only listings in that category. Optional. |
| buying_format | string | 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 | string | 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. |
{
"name": "ebay_listings",
"title": "eBay active listings",
"description": "Search one page of eBay active listings by keyword, on eBay US or seven other countries, in the sort order you pick. A page holds up to 200 rows with count=200, or 40 without it. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/listings",
"inputSchema": {
"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
},
"annotations": {
"title": "eBay active listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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 | 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. |
{
"name": "poshmark_sold",
"title": "Poshmark sold listings",
"description": "Search one page of Poshmark sold listings by keyword, on Poshmark US or Canada. Pages use a cursor. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/poshmark-sold",
"inputSchema": {
"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
},
"annotations": {
"title": "Poshmark sold listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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 | 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 | 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. |
{
"name": "poshmark_listings",
"title": "Poshmark active listings",
"description": "Search one page of Poshmark active listings by keyword, on Poshmark US or Canada, in the sort order you pick. Pages use a cursor. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/poshmark-listings",
"inputSchema": {
"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
},
"annotations": {
"title": "Poshmark active listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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 | string | One Mercari condition: new, like_new, good, fair or poor. Rows return Mercari's label and condition_id. |
| 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. |
| category_id | integer | Mercari numeric category ID. Optional. |
{
"name": "mercari_sold",
"title": "Mercari sold listings",
"description": "Search one page of Mercari US sold listings by keyword, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/mercari-sold",
"inputSchema": {
"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
},
"annotations": {
"title": "Mercari sold listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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 | string | One Mercari condition: new, like_new, good, fair or poor. Rows return Mercari's label and condition_id. |
| 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. |
| category_id | integer | Mercari numeric category ID. Optional. |
{
"name": "mercari_listings",
"title": "Mercari active listings",
"description": "Search one page of Mercari US active listings by keyword, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/mercari-listings",
"inputSchema": {
"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
},
"annotations": {
"title": "Mercari active listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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. |
{
"name": "depop_listings",
"title": "Depop active listings",
"description": "Search one page of Depop active listings by keyword, from sellers in the US, UK, Australia or Canada, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/depop-listings",
"inputSchema": {
"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
},
"annotations": {
"title": "Depop active listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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. |
| country | string | 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 | string | Whatnot category slug using lowercase letters, digits and underscores, such as pokemon_cards. |
| condition | string | Exact case-sensitive seller attribute, such as Near Mint or Graded. Values vary by category. |
| 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. |
| grading_service | string | Exact case-sensitive seller-supplied grading service, such as PSA. |
{
"name": "whatnot_listings",
"title": "Whatnot active listings",
"description": "Search one page of Whatnot Buy It Now active listings from sellers in the US or Canada, up to 24 rows. Prices are seller asks. No sold search. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/whatnot-listings",
"inputSchema": {
"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
},
"annotations": {
"title": "Whatnot active listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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. |
{
"name": "tcgplayer_search",
"title": "TCGplayer product search",
"description": "Search TCGplayer products by keyword; returns catalog identity, source market-price estimate and a few active seller asks. Cached 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/tcgplayer-search",
"inputSchema": {
"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
},
"annotations": {
"title": "TCGplayer product search",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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. |
{
"name": "tcgplayer_sales",
"title": "TCGplayer recent sales",
"description": "Fetch an exact product’s recent individual sales. Anonymous source access has shown at most five rows; this is not a complete sales history. Cached 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/tcgplayer-sales",
"inputSchema": {
"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
},
"annotations": {
"title": "TCGplayer recent sales",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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. |
| fields | string | summary keeps the fields most agents need; full returns every field the API returns. |
| radius | integer | 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… |
| category | string | 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 | array | One condition, or several separated by commas, such as new,open_box. OfferUp labels these differently for vehicles; see the endpoint page. |
| 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. |
| vehicle_make | array | Vehicle searches only. One make, or several separated by commas, such as honda,toyota. |
| vehicle_style | array | Vehicle searches only. One body style, or several separated by commas. |
| vehicle_drivetrain | array | Vehicle searches only. One drivetrain, or several separated by commas. |
| vehicle_max_mileage | integer | Vehicle searches only. Highest odometer reading. |
| vehicle_transmission | string | Vehicle searches only. |
{
"name": "offerup_listings",
"title": "OfferUp local listings",
"description": "Search one page of OfferUp US active listings near a ZIP code or point, about 50 rows. Prices are seller asks. No sold search. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/offerup-listings",
"inputSchema": {
"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
},
"annotations": {
"title": "OfferUp local listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | Type | Description |
|---|---|---|
| q * | string | OfferUp listing ID from search results, the numeric item number, or an offerup.com/item/detail/... URL. |
{
"name": "offerup_item",
"title": "OfferUp listing details",
"description": "Fetch one OfferUp listing by ID or URL: description, posted date, condition, coordinates, shipping, photos, seller and vehicle details. Status is the seller-set state, not a verified sale. Cached 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/offerup-item",
"inputSchema": {
"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
},
"annotations": {
"title": "OfferUp listing details",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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 | string | summary keeps the fields most agents need; full returns every field the API returns. |
| radius | integer | 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 | string | Only listings offering local pickup, or only listings that ship. |
| condition | array | One condition, or several separated by commas, such as used_like_new,used_good. |
| 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. |
| days_since_listed | integer | Only listings posted in the last 1, 7 or 30 days. |
{
"name": "facebook_listings",
"title": "Facebook local listings",
"description": "Search Facebook Marketplace US active listings near a ZIP code or point, up to about 24 rows. Prices are seller asks. No sold search. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/facebook-listings",
"inputSchema": {
"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
},
"annotations": {
"title": "Facebook local listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | Type | Description |
|---|---|---|
| q * | string | Facebook Marketplace item ID from search results, or a facebook.com/marketplace/item/... URL. |
{
"name": "facebook_item",
"title": "Facebook listing details",
"description": "Fetch one Facebook Marketplace listing by ID or URL: description, condition, posted date, approximate coordinates, delivery and photos. Status is the seller-set state, not a verified sale. Cached 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/facebook-item",
"inputSchema": {
"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
},
"annotations": {
"title": "Facebook listing details",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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. |
| condition | array | Vinted's own conditions. Send one or more, separated by commas, like new_with_tags,very_good. Vinted applies the filter. |
| 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. |
| category_id | integer | 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. |
{
"name": "vinted_listings",
"title": "Vinted active listings",
"description": "Search one page of Vinted active listings by keyword, on Vinted US, UK or 24 European sites, 96 rows a page. Prices are seller asks. No sold search. Results are cached for 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/vinted-listings",
"inputSchema": {
"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
},
"annotations": {
"title": "Vinted active listings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}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
| Parameter | 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. |
{
"name": "vinted_item",
"title": "Vinted listing details",
"description": "Fetch one Vinted listing by ID or URL: description, condition, brand, size, colour, category, photos and the seller's rating. Status is not a verified sale. Cached 15 minutes. Each completed search costs 1 request, cache hits included; failed searches are free. Docs: https://soldgraph.com/docs/api/vinted-item",
"inputSchema": {
"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
},
"annotations": {
"title": "Vinted listing details",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}Finish a search that was still collecting when its tool call returned. Free: it never charges again.
| Parameter | 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. |
{
"name": "get_result",
"title": "Get a pending search result",
"description": "Finish a search that was still collecting when its tool call returned. Free: it never charges again.",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}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.
No parameters.
{
"name": "account_usage",
"title": "Check usage and remaining requests",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}Live health, success rate and response time for every marketplace. Free.
No parameters.
{
"name": "api_status",
"title": "Check marketplace status",
"description": "Live health, success rate and response time for every marketplace. Free.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}Soldgraph returns live resale data from eBay (8 countries), Vinted (US, UK and 24 European countries), Poshmark (US and Canada), Depop (US, UK, Australia and Canada), Whatnot (US and Canada), and Mercari, OfferUp, Facebook Marketplace and TCGplayer (US). Use *_sold tools for what items actually sold for and *_listings tools for current asking prices. Each call returns one source page; pass page or cursor from the result for more. Keyword searches carry result.summary (median, low, high over the whole page, even when rows are trimmed); eBay tools take count up to 200 rows per page. Each completed search costs 1 request. Check account_usage before large runs. Link people to each row's link so they can verify it.
Names, descriptions and schemas were written by the server and are shown as data.