{"uid":"cap_yGIIWBYv6YSqP_qFjoNjT","slug":"tiresapi-com-160a3d85","name":"TiresAPI Catalogue Dump","description":"Paged tire SKU catalogue dump for offline matching. Priced at $5.00 per 100 rows; `limit` is hard-capped at 100. Optional `updated_since=YYYY-MM-DD` returns only rows updated on/after that UTC date so agents can diff snapshots cheaply. Response echoes `catalogue_as_of_utc`. Empty result sets are auto-credited back to the agent's virtual balance.","url":"https://tiresapi.com/api/v1/corpus/catalogue","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":{"brand":{"type":"string","description":"Brand name; case-insensitive substring filter."},"limit":{"type":"integer","default":100,"maximum":100,"minimum":1},"cursor":{"type":"string","description":"Opaque pagination cursor from a prior page."},"tire_size":{"type":"string","description":"Tire size, e.g. '235/55R17'."},"updated_since":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Return only rows updated on/after this UTC date."}}}},"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":{"size":{"type":"string"},"utqg":{"type":["string","null"]},"brand":{"type":"string"},"model":{"type":"string"},"runflat":{"type":["string","null"]},"category":{"type":["string","null"]},"tire_load":{"type":["string","null"]},"tire_speed":{"type":["string","null"]},"sidewall_abr":{"type":["string","null"]},"updated_date":{"type":"string"},"key_brand_mpc":{"type":"string","description":"Opaque base64url hash of (brand, manufacturer_product_number). Use only as a cursor or to call /tires/{key_brand_mpc} — never as a cross-retailer SKU key."},"manufacturer_product_number":{"type":["string","null"],"description":"Canonical cross-retailer SKU code (MPC/MPN). Together with `brand` this uniquely identifies the tire across retailers — that's the external key. `key_brand_mpc` is just a SHA1 hash of (brand, manufacturer_product_number) used internally for stable cursors."}}}},"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: base64url `key_brand_mpc` of last row"},"has_more":{"type":"boolean"}}},"pricing":{"type":"string"},"catalogue_as_of_utc":{"type":["string","null"],"description":"UTC timestamp the snapshot was rolled."}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"size":"235/55R17","utqg":"820-A-B","brand":"Michelin","model":"Defender T+H","runflat":"No","category":"All-Season","tire_load":"99","tire_speed":"H","sidewall_abr":"BW","key_brand_mpc":"AAECAw","manufacturer_product_number":"13420"}],"page":{"limit":100,"cursor":"AAECAw","has_more":true},"pricing":"$5.00 per 100 rows","catalogue_as_of_utc":"2026-05-20T12:00:00Z"}},"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_4UaS2iiWFpfgpXvUits9Q","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 paged, filterable dump of tire SKUs from the master catalogue, optionally filtered to records updated since a given date for incremental syncing.","exampleAgentPrompt":"Pull the first 100 Michelin tires in size 235/55R17 from the TiresAPI catalogue, and only include records updated since 2024-01-01 so I can diff against my local snapshot.","exampleUseCases":null,"resultDescription":"Returns up to 100 tire SKU rows per page, each with brand, model, size, UTQG, runflat, category, load/speed ratings, sidewall abbreviation, manufacturer product number, opaque key_brand_mpc hash, and updated_date. Also includes a meta block with catalogue_as_of_utc timestamp and an opaque pagination cursor for fetching the next page. Empty result sets are auto-credited back to the caller's balance.","failureModes":["limit exceeds 100 — server hard-caps and may return 400 or silently clamp","invalid updated_since date format (must match YYYY-MM-DD) returns 400 validation error","invalid or expired pagination cursor returns 400 or empty result","unknown brand or size filter returns empty data array (auto-credited)","authentication/payment failure returns 402 Payment Required","network timeout on large catalogue pages"],"whenToPreferThis":"Use this endpoint when you need to bulk-fetch or incrementally sync the master tire SKU catalogue for offline matching, cross-referencing MPNs, or building a local database. Prefer updated_since for cheap incremental diffs rather than full re-dumps. For live inventory or pricing queries, use the inventory or pricing endpoints instead. For a single curated answer (cheapest tire near a ZIP), use the curated answer endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:27.638Z","isFirstParty":false}