{"uid":"cap_kbQ6dJ9wRg3Q_BKvO5jPr","slug":"tiresapi-com-a399df79","name":"TiresAPI SKU Price History","description":"Daily price series for one SKU (key_brand_mpc) over up to 365 days.","url":"https://tiresapi.com/api/v1/corpus/price-history/sku","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":["key_brand_mpc"],"properties":{"days":{"type":"integer","default":90,"maximum":365,"minimum":1},"state":{"type":"string","pattern":"^[A-Z]{2}$"},"dma_code":{"type":"string","maxLength":5,"description":"Nielsen DMA code (TV market = retail competition cluster). Orthogonal to `state` — pin one or both. Use to scope the series to a single metro for severity/regional pricing questions."},"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","properties":{"sku":{"type":["object","null"],"properties":{"size":{"type":["string","null"]},"brand":{"type":["string","null"]},"model":{"type":["string","null"]},"key_brand_mpc":{"type":"string"},"manufacturer_product_number":{"type":["string","null"],"description":"Canonical cross-retailer SKU code (MPC/MPN). (brand, manufacturer_product_number) is the external SKU key."}}},"data":{"type":"array","items":{"type":"object","properties":{"listings":{"type":"integer"},"utc_date":{"type":"string","format":"date"},"avg_price":{"type":"number"},"max_price":{"type":"number"},"min_price":{"type":"number"},"sample_rows":{"type":"integer"},"median_price":{"type":"number"}}}},"days":{"type":"integer"},"count":{"type":"integer"},"state":{"type":["string","null"]},"dma_code":{"type":["string","null"]},"key_brand_mpc":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"sku":{"size":"225/65R17","brand":"Michelin","model":"Defender 2","key_brand_mpc":"AAECAw","manufacturer_product_number":"13420"},"data":[{"utc_date":"2026-05-19","avg_price":144.5,"max_price":162.99,"min_price":138.99,"sample_rows":23}],"days":90,"count":90,"state":null,"dma_code":null,"key_brand_mpc":"AAECAw"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MA0dOHKpyDafssHFAOpGT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a daily price series (min/max/avg/median/listings) for a single tire SKU over up to 365 days, optionally scoped to a US state or Nielsen DMA market.","exampleAgentPrompt":"Pull the daily price history for tire SKU 'TlMxMjM0NQ' from tiresapi.com for the last 180 days, scoped to California (state CA), so I can see how min, max, and median prices have moved.","exampleUseCases":null,"resultDescription":"A JSON object containing the SKU's metadata (brand, model, size, manufacturer product number) and an array of daily price records — each with utc_date, avg_price, min_price, max_price, median_price, listings count, and sample_rows — covering the requested date range, optionally filtered to a state or DMA.","failureModes":["Missing or invalid key_brand_mpc returns a 400 error","Invalid state code (not 2 uppercase letters) causes a validation error","days value outside 1–365 is rejected","Unknown SKU key returns an empty data array","Invalid dma_code format returns a 400 validation error","Payment not fulfilled results in a 402 response"],"whenToPreferThis":"Use this endpoint when you need time-series price data for a single, known tire SKU — especially for trend analysis, price volatility studies, or regional pricing comparisons. Prefer it over the size-level price history endpoint when you have a specific brand+MPN and need SKU-level granularity. Use the state or dma_code filters to scope analysis to a specific market.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:32:07.602Z","isFirstParty":false}