{"uid":"cap_4UF1KQCkTPaFRFNtrKDhg","slug":"tiresapi-com-46f82051","name":"TiresAPI Inventory Latest Snapshot","description":"Latest-snapshot inventory rows (up to 200/page). Requires at least one filter (tire_size, key_brand_mpc, retailer_key, zip_code, or state); if none are on the URL, zip_code defaults to 33705 (Tampa) with radius_miles=40 so discovery probes reach a 402. For cheapest-in-radius use POST /api/v1/answers/best_price_near.","url":"https://tiresapi.com/api/v1/corpus/inventory/latest","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","anyOf":[{"required":["tire_size"]},{"required":["key_brand_mpc"]},{"required":["retailer_key"]},{"required":["zip_code"]},{"required":["state"]}],"properties":{"limit":{"type":"integer","default":200,"maximum":200,"minimum":1},"state":{"type":"string","pattern":"^[A-Z]{2}$"},"cursor":{"type":"string"},"zip_code":{"type":"string","pattern":"^[0-9]{5}$"},"tire_size":{"type":"string"},"radius_miles":{"type":"integer","default":40,"maximum":200,"minimum":1},"retailer_key":{"type":"string"},"key_brand_mpc":{"type":"string","description":"base64url of the binary SKU key."}}}},"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","null"]},"size":{"type":"string"},"brand":{"type":["string","null"]},"model":{"type":["string","null"]},"state":{"type":["string","null"]},"zip_code":{"type":["string","null"]},"store_num":{"type":["string","null"]},"tire_size":{"type":"string"},"brand_tier":{"enum":["Best","Better","Good","Economy",null],"type":["string","null"],"description":"fg_brand_tier classification. Brands not in fg_brand_tier resolve to 'Economy' by contract."},"history_id":{"type":"integer"},"retailer_key":{"type":"string"},"single_price":{"type":"number"},"key_brand_mpc":{"type":"string","description":"Opaque base64url hash of (brand, manufacturer_product_number). Internal cursor key — not a cross-retailer SKU identifier."},"last_extracted":{"type":"string","format":"date-time"},"store_distance_miles":{"type":["number","null"]},"manufacturer_product_number":{"type":["string","null"],"description":"Canonical cross-retailer SKU code (MPC/MPN). Together with `brand` this is the external key."}}}},"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"}}}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"city":"Tampa","size":"235/55R17","brand":"Michelin","model":"Defender T+H","state":"FL","zip_code":"33614","store_num":"1234","tire_size":"235/55R17","retailer_key":"DISCOUNTTIRE","single_price":142.99,"key_brand_mpc":"AAECAw","last_extracted":"2026-05-20T08:30:00Z","store_distance_miles":4.2,"manufacturer_product_number":"13420"}],"page":{"cursor":null,"has_more":false}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GOonpWpXLikTyJqQdrAHb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns paginated latest-snapshot tire inventory rows (up to 200/page) filtered by tire size, SKU, retailer, ZIP code, or state","exampleAgentPrompt":"Show me the latest tire inventory for size 225/65R17 within 50 miles of ZIP code 90210 — list up to 200 results with prices, store distances, and brand tiers.","exampleUseCases":[{"title":"Compare tire prices across nearby retailers","prompt":"I need to find all available 205/55R16 tires within 25 miles of my location in Dallas, Texas. Show me the inventory with prices and store distances so I can compare which retailer has the best deal."},{"title":"Locate specific tire brand and model in stock","prompt":"Can you search for Michelin Defender tires in size 235/75R15 across all retailers in California? I want to see which stores have it in stock right now and what they're charging."},{"title":"Browse budget-friendly tires in your area","prompt":"Show me all Economy and Good tier tires available in size 175/70R13 near ZIP code 60601. I want at least 50 results so I can pick the cheapest option with a store nearby."}],"resultDescription":"A paginated JSON object with a 'data' array of up to 200 inventory rows and a 'page' object for cursor-based pagination. Each row includes tire_size, brand, model, single_price, brand_tier (Best/Better/Good/Economy), retailer_key, store_num, city, state, zip_code, store_distance_miles, key_brand_mpc, manufacturer_product_number, last_extracted timestamp, and history_id.","failureModes":["402 Payment Required if no valid filter param is provided and no x402 payment is sent","Empty result set (auto-credited) if no inventory matches the filters","400 Bad Request if zip_code is not exactly 5 digits or state is not a 2-letter code","400 Bad Request if no required filter (tire_size, key_brand_mpc, retailer_key, zip_code, or state) is present","Pagination cursor mismatch if cursor value is stale or invalid","radius_miles exceeding 200 returns validation error"],"whenToPreferThis":"Use this endpoint when you need raw, paginated inventory rows with full store-level detail (price, location, brand tier) for a given tire size, SKU, retailer, or geographic area. Prefer this over /answers/best_price_near when you need more than one result, want to compare across retailers, or need to do your own analysis. Use the summary=true mode for aggregated band/severity analysis instead of row-by-row data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:41:23.180Z","isFirstParty":false}