# TiresAPI Retailer Store Directory - Paged Dump

> TiresAPI Retailer Store Directory - Paged Dump is a paid API for AI agents from tiresapi.com, paid per call via x402, $5/call, status unknown (last checked 2026-09-13).

Returns a paginated directory of tire retailer store locations, filterable by US state and retailer key, at $5 per 100 rows.

## Facts

- Endpoint: GET https://tiresapi.com/api/v1/corpus/retailers
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiresapi-com-7e559873
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7cctCqR85IN3Z4q0cXECk

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tiresapi-com-7e559873
```

Example prompt: Pull me the first 100 DISCOUNTTIRE store locations from the tiresapi retailer directory for the state of TX — I want their store numbers, cities, and zip codes.

## When to prefer this

Use this endpoint when you need to bulk-download or enumerate tire retailer store locations for offline analysis, coverage mapping, or building a local store directory. Prefer it over the inventory or price endpoints when you only need store location data without inventory or pricing context. Choose the state or retailer_key filters to reduce cost by narrowing the result set.

## Known failure modes

- Invalid state code (not 2-letter uppercase) returns a validation error
- limit exceeding 100 is rejected with a schema validation error
- Unknown retailer_key returns an empty result set (auto-credited)
- Invalid or expired cursor returns a pagination error
- Insufficient balance on the agent's virtual account blocks the request

## How this service works

Paged retailer store directory dump. Priced at $5.00 per 100 rows; `limit` is hard-capped at 100. Empty result sets are auto-credited back to the agent's virtual balance.

## Output

A paginated array of retailer store records, each containing store_num, city, state, and zip_code, along with a page object indicating the limit used, an opaque next-page cursor, and a has_more boolean. A meta object may include as_of_utc timestamp and data_source. Each page of up to 100 rows costs $5 USDC; empty result sets are auto-credited.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 100,
       "maximum": 100,
       "minimum": 1
      },
      "state": {
       "type": "string",
       "pattern": "^[A-Z]{2}$",
       "description": "2-letter US state."
      },
      "cursor": {
       "type": "string"
      },
      "retailer_key": {
       "type": "string",
       "description": "Uppercase scraper key, e.g. DISCOUNTTIRE."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "page"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "city": {
          "type": "string"
         },
         "state": {
          "type": "string"
         },
         "zip_code": {
          "type": "string"
         },
         "store_num": {
          "type": "string"
         },
         "retailer_key": {
          "type": "string"
         }
        }
       }
      },
      "meta": {
       "type": "object",
       "properties": {
        "as_of_utc": {
         "type": [
          "string",
          "null"
         ],
         "format": "date-time"
        },
        "data_source": {
         "type": "string"
        }
       }
      },
      "page": {
       "type": "object",
       "required": [
        "has_more"
       ],
       "properties": {
        "limit": {
         "type": "integer",
         "description": "Echo of the request limit used for this page."
        },
        "cursor": {
         "type": [
          "string",
          "null"
         ],
         "description": "Opaque cursor for the next page; null when done."
        },
        "has_more": {
         "type": "boolean"
        }
       }
      },
      "pricing": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "city": "Tampa",
    "state": "FL",
    "zip_code": "33614",
    "store_num": "1234",
    "retailer_key": "DISCOUNTTIRE"
   }
  ],
  "page": {
   "limit": 100,
   "cursor": null,
   "has_more": true
  },
  "pricing": "$5.00 per 100 rows"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiresapi-com-7e559873/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tiresapi.com](https://www.zero.xyz/host/tiresapi.com/llms.txt)