Developer Tool · x402

Business location data for AI agents

Business location data for AI agents. Search, sample, count and buy ready-to-use lists of US business locations: 966 datasets compiled from each brand's official store locator or the public register that publishes the data.Filter by city, state, zip, a radius…

by locationlists.com · discovered, not yet claimed by its owner · updated 2026-09-15

Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.

What it does

Business location data for AI agents. Search, sample, count and buy ready-to-use lists of US business locations: 966 datasets compiled from each brand's official store locator or the public register that publishes the data.Filter by city, state, zip, a radius around any place, or any column in the file. Buy a full CSV by card, or let an agent pay per row or buy the whole file in USDC on Base via x402, with no account or API key. A failed or empty query costs nothing.

Tags: bazaar

Use with an agent

  1. Discover. Agents find this listing with GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP tool search_resources, or /discovery/resources.
  2. Inspect. Fetch /resources/7935.json for the price and payment options.
  3. Pay. Call GET https://locationlists.com/api/x402/query. The provider answers 402 with its payment requirements. An x402 client signs one of the options below and retries with PAYMENT-SIGNATURE.
  4. Execute. The provider returns 200 with the data. Agent Bazaar is not in the request path and never sees your payment.

For humans

You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.

Pricing & payment

Price
$0.31 / request
Protocol
x402 v2
Auth
No account or API key. Pay per request.
Networks
Base
Uptime
1 of the last 1 checks answered
Calls (30d)
6 · 2 unique payers (third-party data from the public x402 Bazaar)

x402 payment requirements

SchemeNetworkAssetAmountPay toTimeout
exactBase
eip155:8453
USDC$0.310x1771e6d558F4dA1b9cfA0C64226cAaf9a097129260s
accepts[] (raw JSON)
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x1771e6d558F4dA1b9cfA0C64226cAaf9a0971292",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "310000",
    "amountUsd": 0.31,
    "maxTimeoutSeconds": 60
  }
]

Schemas

Output schema (JSON Schema)
{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "category": "retail",
          "near": {
            "place": "Los Angeles, CA",
            "radius_miles": 25
          },
          "total": 10
        },
        "bodyType": "json",
        "method": "POST",
        "type": "http"
      },
      "output": {
        "example": {
          "blankNote": null,
          "columns": [
            "name",
            "facilityType",
            "subType",
            "npisAtAddress",
            "npi",
            "address",
            "city",
            "state",
            "zip",
            "country",
            "phone",
            "certifiedDate",
            "chainName",
            "sourceUrl",
            "latitude",
            "longitude",
            "geo_precision",
            "county",
            "county_fips",
            "county_note",
            "address_quality"
          ],
          "dataset": "US Dental Practices",
          "excludedBlank": {},
          "filters": [
            "state eq AK",
            "city eq Kodiak"
          ],
          "matched": 1,
          "note": "All matching rows returned.",
          "offset": 0,
          "returned": 1,
          "rows": [
            {
              "address": "204 Rezanof Dr E, Suite #201",
              "certifiedDate": "2013-10-03",
              "chainName": "",
              "city": "Kodiak",
              "country": "US",
              "facilityType": "dental practice",
              "name": "\"Gentle Dentistry\" Jennifer Spivey Dds",
              "npi": "1306273446",
              "npisAtAddress": "1",
              "phone": "9074813567",
              "sourceUrl": "https://npiregistry.cms.hhs.gov/api/",
              "state": "AK",
              "subType": "general dentistry",
              "zip": "99615-6379"
            }
          ],
          "truncated": false
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "body": {
              "$comment": "Field descriptions: https://locationlists.com/openapi.json",
              "additionalProperties": false,
              "properties": {
                "category": {
                  "type": "string"
                },
                "city": {
                  "type": "string"
                },
                "county": {
                  "type": "string"
                },
                "dataset": {
                  "type": "string"
                },
                "datasets": {
                  "items": {
                    "type": "string"
                  },
                  "maxItems": 150,
                  "minItems": 1,
                  "type": "array"
                },
                "limit": {
                  "maximum": 1000,
                  "minimum": 1,
                  "type": "integer"
                },
                "near": {
                  "additionalProperties": false,
                  "properties": {
                    "drive_minutes": {
                      "maximum": 60,
                      "minimum": 5,
                      "type": "integer"
                    },
                    "lat": {
                      "type": "number"
                    },
                    "lng": {
                      "type": "number"
                    },
                    "place": {
                      "type": "string"
                    },
                    "radius_miles": {
                      "exclusiveMinimum": 0,
                      "maximum": 500,
                      "type": "number"
                    },
                    "zip": {
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "offset": {
                  "maximum": 10000,
                  "minimum": 0,
                  "type": "integer"
                },
                "order_by": {
                  "additionalProperties": false,
                  "properties": {
                    "direction": {
                      "enum": [
                        "asc",
                        "desc"
                      ],
                      "type": "string"
                    },
                    "field": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "field"
                  ],
                  "type": "object"
                },
                "relate": {
                  "additionalProperties": {},
                  "type": "object"
                },
                "state": {
                  "type": "string"
                },
                "total": {
                  "maximum": 1000,
                  "minimum": 1,
                  "type": "integer"
                },
                "where": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "field": {
                        "type": "string"
                      },
                      "op": {
                        "enum": [
                          "eq",
                          "ne",
                          "gt",
                          "gte",
                          "lt",
                          "lte",
                          "in",
                          "contains",
                          "starts_with",
                          "is_blank",
                          "not_blank"
                        ],
                        "type": "string"
                      },
                      "value": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "number"
                          },
                          {
                            "type": "boolean"
                          },
                          {
                            "items": {
                              "type": [
                                "string",
                                "number"
                              ]
                            },
                            "type": "array"
                          }
                        ]
                      }
                    },
                    "required": [
                      "field",
                      "op"
                    ],
                    "type": "object"
                  },
                  "maxItems": 12,
                  "type": "array"
                },
                "zip": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            },
            "headers": {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            "method": {
              "enum": [
                "POST",
                "PUT",
                "PATCH"
              ],
              "type": "string"
            },
            "queryParams": {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}
Example shape — generated from the schema, not a captured live response
null

Examples

curl
curl "https://locationlists.com/api/x402/query"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://locationlists.com/api/x402/query");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}
Python
import httpx
res = httpx.get("https://locationlists.com/api/x402/query")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header

Details

Provider
locationlists.com
Endpoint
https://locationlists.com/api/x402/query
Machine-readable
/resources/7935.json