{"uid":"cap_nU052ga9nPrkNp3kwLE4q","slug":"tiresapi-com-347fc79f","name":"TiresAPI Stores Near ZIP Answer","description":"Curated answer: retailer stores carrying a SKU (or any inventory) near a ZIP. $0.001 per call, debited from the agent's virtual USD balance first.","url":"https://tiresapi.com/api/v1/answers/stores_near","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"zip_code":{"type":"string","pattern":"^[0-9]{5}$"},"key_brand_mpc":{"type":"string","description":"base64url of the binary SKU key; see /api/v1/tires/{key_brand_mpc}."}}},"responseSchema":{"type":"json","example":{"stores":[{"city":"Tampa","state":"FL","zip_code":"33614","store_num":"1234","retailer_key":"DISCOUNTTIRE","store_distance_miles":4.2},{"store_num":null,"retailer_key":"TIRERACK","store_distance_miles":null}],"store_count":2}},"example":{"request":{"zip_code":"90210","tire_size":"225/65R17","radius_miles":30},"response":{"_truncated":true,"_originalSize":23824}},"exampleRequest":{"zip_code":"90210","tire_size":"225/65R17","radius_miles":30},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mhGj5LsHx8Ctlu6JCyLeP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a curated list of retailer stores carrying a specific tire SKU (or any inventory) near a given ZIP code","exampleAgentPrompt":"Find all retailers carrying the Michelin tire with SKU key_brand_mpc ABC123 within 30 miles of ZIP code 90210 and show me where I can buy it nearby.","exampleUseCases":[{"title":"Find nearby tire shops for replacements","prompt":"I need new tires for my car and I'm in the 75001 area. Can you find stores near me that have the Bridgestone Turanza QuietTrack in stock so I can compare prices and visit one today?"},{"title":"Locate specific tire availability instantly","prompt":"I'm looking for the Continental PureContact LS in size 225/45R18 around my ZIP code 60601. Which retailers nearby actually have it in stock right now?"},{"title":"Compare local tire retailer inventory quickly","prompt":"Show me all the tire shops within 20 miles of ZIP 98101 that carry Goodyear Assurance MaxLife tires so I can figure out which one has the best selection and pricing."}],"resultDescription":"A curated list of retailer store records that carry the requested SKU or inventory item near the provided ZIP code, including store details and availability data, debited at $0.001 per call from the agent's virtual USD balance.","failureModes":["No stores found near the ZIP for the given SKU — empty result set returned","Invalid ZIP code format — request rejected with validation error","Missing required filter (SKU or ZIP not provided) — error response","Insufficient virtual USD balance — payment fails before query executes","SKU not recognized in catalogue — no matches returned"],"whenToPreferThis":"Use this endpoint when you need to find physical retailer locations near a specific ZIP code that carry a particular tire SKU or inventory item. Prefer this over the full inventory snapshot endpoint when you want a geographically filtered, store-centric answer rather than raw inventory rows. Best for consumer-facing 'find a store near me' scenarios where a fast, curated single-call answer is needed at $0.001 per query.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:39:10.852Z","isFirstParty":false}