---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/marketplace-search
---
# Marketplace Search

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.

- **Version:** 0.02
- **Categories:** search, data
- **Workflow:** source_coverage → search_listings → listing_details → watchlist_snapshot

## Skills (4)

### Search Listings (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Product, second-hand item, brand, model, or listing phrase to search for |
| `source` | string | No | Marketplace source: all, shopping_index, ebay, facebook_marketplace, craigslist, gumtree, trademe, mercadolibre, olx, rakuten, vinted, carousell (all, shopping_index, ebay, facebook_marketplace, craigslist, gumtree, trademe, mercadolibre, olx, rakuten, vinted, carousell) [default: "all"] |
| `sources` | array | No | Optional explicit source list when you want to search multiple named marketplaces at once |
| `regions` | array | No | Region or market codes such as US, CA, UK, EU, AU, NZ, JP, SG, HK, LATAM, MX, BR, or APAC |
| `country` | string | No | Optional 2-letter search country code for result localization, such as us, gb, de, jp, or au |
| `language` | string | No | Optional search language code such as en, es, pt, de, fr, or ja |
| `location` | string | No | Optional city, country, or local search phrase to bias the query, such as "Berlin" or "Auckland" |
| `listing_classes` | array | No | Filter toward classifieds, auctions, fixed-price listings, or retail marketplaces |
| `condition` | string | No | Optional condition hint such as used, refurbished, new, or preowned (any, used, refurbished, new, preowned) [default: "any"] |
| `local_pickup` | boolean | No | Bias the search toward listings mentioning local pickup or collection [default: false] |
| `limit` | number | No | Maximum listings to return (1-25, default 10) [default: 10] |
| `page` | number | No | Page number for the underlying search-index query window (default 1) [default: 1] |

**Returns:** Deduped marketplace listing cards with source names, URLs, snippets, inferred listing class, and price text when available

**Examples:**

*Search across all no-key sources for a used Herman Miller chair in the UK and Europe:*

```json
{
  "query": "Herman Miller Aeron",
  "source": "all",
  "regions": [
    "UK",
    "EU"
  ],
  "condition": "used",
  "limit": 8
}
```

*Search Mercado Libre and OLX for used camera gear in Latin America:*

```json
{
  "query": "Sony A7 III",
  "sources": [
    "mercadolibre",
    "olx"
  ],
  "regions": [
    "LATAM"
  ],
  "condition": "used",
  "limit": 8
}
```

### Listing Details (`listing_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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full listing URL returned by search_listings |
| `source_url` | string | No | Optional alias for url |

**Returns:** A quick metadata preview for one listing URL with inferred source, region, and listing characteristics

**Examples:**

*Preview an eBay listing URL returned by marketplace search:*

```json
{
  "url": "https://www.ebay.com/itm/325123456789"
}
```

### Watchlist Snapshot (`watchlist_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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Product, second-hand item, brand, model, or listing phrase to search for |
| `source` | string | No | Marketplace source: all, shopping_index, ebay, facebook_marketplace, craigslist, gumtree, trademe, mercadolibre, olx, rakuten, vinted, carousell (all, shopping_index, ebay, facebook_marketplace, craigslist, gumtree, trademe, mercadolibre, olx, rakuten, vinted, carousell) [default: "all"] |
| `sources` | array | No | Optional explicit source list when you want to search multiple named marketplaces at once |
| `regions` | array | No | Region or market codes such as US, CA, UK, EU, AU, NZ, JP, SG, HK, LATAM, MX, BR, or APAC |
| `country` | string | No | Optional 2-letter search country code for result localization, such as us, gb, de, jp, or au |
| `language` | string | No | Optional search language code such as en, es, pt, de, fr, or ja |
| `location` | string | No | Optional city, country, or local search phrase to bias the query, such as "Berlin" or "Auckland" |
| `listing_classes` | array | No | Filter toward classifieds, auctions, fixed-price listings, or retail marketplaces |
| `condition` | string | No | Optional condition hint such as used, refurbished, new, or preowned (any, used, refurbished, new, preowned) [default: "any"] |
| `local_pickup` | boolean | No | Bias the search toward listings mentioning local pickup or collection [default: false] |
| `limit` | number | No | Maximum listings to return (1-25, default 10) [default: 10] |
| `page` | number | No | Page number for the underlying search-index query window (default 1) [default: 1] |

**Returns:** Compact watchlist rows with stable snapshot ids, marketplace names, price text, and listing URLs

**Examples:**

*Create a compact watchlist snapshot for used Leica cameras across Europe:*

```json
{
  "query": "Leica Q2",
  "regions": [
    "EU"
  ],
  "condition": "used",
  "limit": 6
}
```

### Source Coverage (`source_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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `source` | string | No | Marketplace source: all, shopping_index, ebay, facebook_marketplace, craigslist, gumtree, trademe, mercadolibre, olx, rakuten, vinted, carousell (all, shopping_index, ebay, facebook_marketplace, craigslist, gumtree, trademe, mercadolibre, olx, rakuten, vinted, carousell) [default: "all"] |
| `sources` | array | No | Optional explicit source list when you want to search multiple named marketplaces at once |
| `regions` | array | No | Region or market codes such as US, CA, UK, EU, AU, NZ, JP, SG, HK, LATAM, MX, BR, or APAC |
| `listing_classes` | array | No | Filter toward classifieds, auctions, fixed-price listings, or retail marketplaces |

**Returns:** Coverage rows describing which marketplaces are active, how they are accessed, and what caveats apply

**Examples:**

*Check which no-key sources cover Europe second-hand marketplaces:*

```json
{
  "regions": [
    "EU"
  ],
  "listing_classes": [
    "classified"
  ]
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call marketplace-search search_listings --query Herman Miller Aeron --source all --regions UK,EU --condition used --limit 8

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -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/call
```

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs