{"uid":"cap_5cG30y8vDf8ZjrFHjWol3","slug":"tiresapi-com-7ed8a54b","name":"TiresAPI Inventory By-Day (Historical Snapshot)","description":"Inventory rows for a single last_extracted partition (single SKU or size).","url":"https://tiresapi.com/api/v1/corpus/inventory/by-day","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","required":["utc_date"],"properties":{"limit":{"type":"integer","default":500,"maximum":500,"minimum":1},"state":{"type":"string","pattern":"^[A-Z]{2}$"},"cursor":{"type":"string"},"utc_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"UTC snapshot date."},"tire_size":{"type":"string"},"retailer_key":{"type":"string"},"key_brand_mpc":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","utc_date","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. Wire format: `<price>|<retailer_key>|<store_number>|<history_id>`"},"has_more":{"type":"boolean"}}},"utc_date":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"size":"235/55R17","store_num":"1234","history_id":987654321,"retailer_key":"DISCOUNTTIRE","single_price":142.99,"key_brand_mpc":"AAECAw","last_extracted":"2026-05-19T18:00:00Z"}],"page":{"cursor":"142.99|DISCOUNTTIRE|1234|987654321","has_more":true},"utc_date":"2026-05-19"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":100,"state":"TX","utc_date":"2024-03-15","tire_size":"225/65R17"}}},"response":{"_truncated":true,"_originalSize":50032}},"exampleRequest":{"limit":100,"state":"TX","utc_date":"2024-03-15","tire_size":"225/65R17"},"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_CirAv7aN3QM50BIdu-ZKr","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 inventory rows for a specific UTC date snapshot, filterable by tire size, SKU, retailer, or state.","exampleAgentPrompt":"Pull all tire inventory rows for size 225/65R17 in Texas from the 2024-03-15 snapshot — page through up to 500 results at a time.","exampleUseCases":null,"resultDescription":"A paginated array of inventory records for the requested date snapshot, each containing store location (city, state, zip, store number), tire details (size, brand, model, brand_tier), pricing (single_price), retailer identifier, and the key_brand_mpc hash. Includes pagination cursor and metadata such as as_of timestamp.","failureModes":["Missing required utc_date parameter returns 400 Bad Request","Invalid date format (not YYYY-MM-DD) returns 400 with pattern validation error","State code not matching ^[A-Z]{2}$ pattern returns 400","No inventory found for the given partition returns empty data array (auto-credited)","limit exceeds 500 returns 400 validation error","Invalid cursor token returns 400 or 422","Payment not included or insufficient returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need historical tire inventory data for a specific past date — ideal for time-series analysis, price trend research, or auditing what was in stock on a given day. Prefer this over the latest-snapshot endpoint when you need point-in-time historical records rather than current availability. Use the summary=true mode (via the history walk endpoint) for aggregate band analysis; use this by-day endpoint when you need raw per-store rows for a single date partition.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:46:57.199Z","isFirstParty":false}