Marketplace Search
Find second-hand listings and products across regions
Search major marketplace domains and shopping indexes for used goods, classifieds, auctions, and online product offers across multiple regions. Useful when you want one search workflow without setting up source-specific marketplace credentials.
Search Listings
Search multiple marketplace domains and shopping indexes for second-hand listings, classifieds, auctions, and product offers with region, source, condition, and listing-class filters.
Returns: Deduped marketplace listing cards with source names, URLs, snippets, inferred listing class, and price text when available
Parameters
query *stringProduct, second-hand item, brand, model, or listing phrase to search for
sourcestringMarketplace source: all, shopping_index, ebay, facebook_marketplace, craigslist, gumtree, trademe, mercadolibre, olx, rakuten, vinted, carousell
sourcesarrayOptional explicit source list when you want to search multiple named marketplaces at once
regionsarrayRegion or market codes such as US, CA, UK, EU, AU, NZ, JP, SG, HK, LATAM, MX, BR, or APAC
countrystringOptional 2-letter search country code for result localization, such as us, gb, de, jp, or au
languagestringOptional search language code such as en, es, pt, de, fr, or ja
locationstringOptional city, country, or local search phrase to bias the query, such as "Berlin" or "Auckland"
listing_classesarrayFilter toward classifieds, auctions, fixed-price listings, or retail marketplaces
conditionstringOptional condition hint such as used, refurbished, new, or preowned
local_pickupbooleanBias the search toward listings mentioning local pickup or collection
limitnumberMaximum listings to return (1-25, default 10)
pagenumberPage number for the underlying search-index query window (default 1)
Example
Search across all no-key sources for a used Herman Miller chair in the UK and Europe
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "marketplace-search",
"skill": "search_listings",
"input": {
"query": "Herman Miller Aeron",
"source": "all",
"regions": [
"UK",
"EU"
],
"condition": "used",
"limit": 8
}
}' \
https://api.toolrouter.com/v1/tools/callListing Details
Preview a single marketplace URL so you can inspect the title, description, image, inferred source, region, listing id, and any price text available from metadata.
Returns: A quick metadata preview for one listing URL with inferred source, region, and listing characteristics
Parameters
url *stringFull listing URL returned by search_listings
source_urlstringOptional alias for url
Example
Preview an eBay listing URL returned by marketplace search
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "marketplace-search",
"skill": "listing_details",
"input": {
"url": "https://www.ebay.com/itm/325123456789"
}
}' \
https://api.toolrouter.com/v1/tools/callWatchlist Snapshot
Generate a compact marketplace snapshot for a query so you can monitor new listings, prices, and sources over time without storing state in the tool.
Returns: Compact watchlist rows with stable snapshot ids, marketplace names, price text, and listing URLs
Parameters
query *stringProduct, second-hand item, brand, model, or listing phrase to search for
sourcestringMarketplace source: all, shopping_index, ebay, facebook_marketplace, craigslist, gumtree, trademe, mercadolibre, olx, rakuten, vinted, carousell
sourcesarrayOptional explicit source list when you want to search multiple named marketplaces at once
regionsarrayRegion or market codes such as US, CA, UK, EU, AU, NZ, JP, SG, HK, LATAM, MX, BR, or APAC
countrystringOptional 2-letter search country code for result localization, such as us, gb, de, jp, or au
languagestringOptional search language code such as en, es, pt, de, fr, or ja
locationstringOptional city, country, or local search phrase to bias the query, such as "Berlin" or "Auckland"
listing_classesarrayFilter toward classifieds, auctions, fixed-price listings, or retail marketplaces
conditionstringOptional condition hint such as used, refurbished, new, or preowned
local_pickupbooleanBias the search toward listings mentioning local pickup or collection
limitnumberMaximum listings to return (1-25, default 10)
pagenumberPage number for the underlying search-index query window (default 1)
Example
Create a compact watchlist snapshot for used Leica cameras across Europe
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "marketplace-search",
"skill": "watchlist_snapshot",
"input": {
"query": "Leica Q2",
"regions": [
"EU"
],
"condition": "used",
"limit": 6
}
}' \
https://api.toolrouter.com/v1/tools/callSource Coverage
Show which marketplaces are active for a given region or listing class in the no-key version of the tool, including caveats and access tiers.
Returns: Coverage rows describing which marketplaces are active, how they are accessed, and what caveats apply
Parameters
sourcestringMarketplace source: all, shopping_index, ebay, facebook_marketplace, craigslist, gumtree, trademe, mercadolibre, olx, rakuten, vinted, carousell
sourcesarrayOptional explicit source list when you want to search multiple named marketplaces at once
regionsarrayRegion or market codes such as US, CA, UK, EU, AU, NZ, JP, SG, HK, LATAM, MX, BR, or APAC
listing_classesarrayFilter toward classifieds, auctions, fixed-price listings, or retail marketplaces
Example
Check which no-key sources cover Europe second-hand marketplaces
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "marketplace-search",
"skill": "source_coverage",
"input": {
"regions": [
"EU"
],
"listing_classes": [
"classified"
]
}
}' \
https://api.toolrouter.com/v1/tools/callQuick Start
MCP (Claude Code)
claude mcp add --transport stdio \
--env TOOLROUTER_API_KEY=YOUR_API_KEY \
toolrouter -- npx -y toolrouter-mcpREST API
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{"tool":"marketplace-search","skill":"search_listings","input":{}}' \
https://api.toolrouter.com/v1/tools/call