{"uid":"cap_7cctCqR85IN3Z4q0cXECk","slug":"tiresapi-com-7e559873","name":"TiresAPI Retailer Store Directory - Paged Dump","description":"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.","url":"https://tiresapi.com/api/v1/corpus/retailers","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iSzhB0gTFdqp18orloiY7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated directory of tire retailer store locations, filterable by US state and retailer key, at $5 per 100 rows.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:39:49.975Z","isFirstParty":false}