nodemaven_list_locations
Discover exact country, region, city, ISP, or zip code names for proxy targeting. Prevents empty proxy pools by verifying spellings before use.
Instructions
List the countries, regions, cities, ISPs or zip codes available for targeting.
Use this to discover exact spellings before targeting - guessing a city name is the most common reason a proxy connection returns an empty pool.
Returns: str: Markdown or JSON with the schema: { "total": int, "count": int, "offset": int, "limit": int, "has_more": bool, "next_offset": int | None, "items": [ { ... } ] # raw records as returned by NodeMaven } On failure: "Error: "
Examples: - "which countries can I target?" -> level='countries' - "list German cities" -> level='cities', country='de' - "which carriers exist in the US?" -> level='isps', country='us'
Requires NODEMAVEN_API_KEY.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | One of: countries, regions, cities, isps, zipcodes. | countries |
| limit | No | Maximum records to return. | |
| offset | No | Records to skip, for pagination. | |
| region | No | Region name scoping cities. | |
| country | No | Two-letter country code scoping regions, cities, ISPs or zip codes. | |
| response_format | No | 'markdown' for a compact summary, 'json' for the full payload. | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |