{"uid":"cap_XQR01ijwP7SCdEo4DrIUi","slug":"syntalic-price-history-b21a7264","name":"Syntalic Price History","description":"Get historical price observations for a product within a date range. Returns current price, period low/high/avg, trend (rising/falling/stable), good-deal flag, and an observation time-series for charting.","url":"https://api.syntalic.com/v1/shopper/price-history","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","example":"airpods","minLength":1,"description":"Search query (product name, keyword, or category term)"},"to":{"type":"string","format":"date","example":"2026-05-01","description":"End date (ISO 8601, defaults to now)"},"from":{"type":"string","format":"date","example":"2026-04-01","description":"Start date (ISO 8601, defaults to 30 days ago)"},"country":{"enum":["us","ca"],"type":"string","default":"us","example":"us","description":"Country (us or ca)"},"retailer":{"enum":["amazon","walmart","costco","homedepot","nordstrom","ikea"],"type":"string","example":"amazon","description":"Filter to a specific retailer"}},"additionalProperties":false},"responseSchema":{"type":"object","properties":{"query":{"type":"string"},"history":{"type":"array","items":{"type":"object"}}}},"example":null,"exampleRequest":null,"tags":["x402","shopping"],"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_pZChFG-lvhk9Ape7jpcWi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical price observations for a product over a date range, including current price, period low/high/avg, price trend, good-deal flag, and a time-series for charting.","exampleAgentPrompt":"Show me the price history for AirPods on Amazon in the US over the last 30 days — I want to know the current price, the period low and high, whether the price is trending up or down, and if it's a good deal right now.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the query string and a history array of time-series price observations. Each observation includes timestamps and price data points. Top-level summary fields include current price, period low, period high, period average, trend classification (rising/falling/stable), and a boolean good-deal flag suitable for charting or purchase-timing decisions.","failureModes":["No results found for obscure or misspelled product queries — returns empty history array","Invalid date range (from > to) — returns 400 validation error","Unsupported country code — returns 400 enum validation error","Unsupported retailer value — returns 400 enum validation error","Payment failure or insufficient USDC balance — returns 402 Payment Required","Rate limiting if too many requests in short period — returns 429 Too Many Requests"],"whenToPreferThis":"Use this endpoint when you need historical price trend data for a specific product, want to determine if a product is currently at a low price, need to chart price fluctuations over a custom date range, or want to evaluate purchase timing. Prefer this over Best Price (which only gives current lowest price) when trend context, volatility, or period statistics matter. Choose this over Inflation or Price Dispersion when you want product-level history rather than category-level aggregates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:43:55.471Z","isFirstParty":false}