{"uid":"cap_dtPOq1hjLJFmR2wkIVwL4","slug":"price-drop-alert-9b82bbf4","name":"Price Drop Alert","description":"Check whether a product's current price is below its rolling average within a configurable lookback window. Returns current price vs. the average across the window plus the lowest-seen price and date. Response field `avg_price_last_30d` is a fixed name for backwards compatibility; the value is always computed across the configured `lookback_days` window.","url":"https://api.syntalic.com/v1/shopper/price-drop-alert","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)"},"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"},"lookback_days":{"type":"integer","default":30,"example":30,"description":"Days to look back for price drops (default 30)"}},"additionalProperties":false},"responseSchema":{"type":"object","properties":{"drops":{"type":"array","items":{"type":"object"}},"query":{"type":"string"}}},"example":{"request":{"q":"laptop","country":"us","retailer":"amazon","lookback_days":30},"response":{"query":"laptop","scope":"listing","country":"us","currency":"USD","retailer":"amazon","condition":"refurbished","entity_uid":"4e39ad2ba123b2f4bc05b38947ea4537","lowest_seen":389.9,"product_uid":"amazon:B07JB2C4RZ","member_count":1,"product_name":"Apple 15.4in MacBook Pro Laptop (Retina, Touch Bar, 2.6GHz 6-Core Intel Core i7, 16GB RAM, 512GB SSD Storage) Space Gray (MR942LL/A) (2018 Model) (Renewed)","current_price":389.9,"is_price_drop":false,"lowest_seen_date":"2026-06-15","price_vs_avg_pct":0,"resolved_product":{"scope":"listing","retailer":"amazon","condition":"refurbished","entity_uid":"4e39ad2ba123b2f4bc05b38947ea4537","product_uid":"amazon:B07JB2C4RZ","member_count":1,"product_name":"Apple 15.4in MacBook Pro Laptop (Retina, Touch Bar, 2.6GHz 6-Core Intel Core i7, 16GB RAM, 512GB SSD Storage) Space Gray (MR942LL/A) (2018 Model) (Renewed)","product_type":null,"category_path":"computers/computers-tablets/laptops/traditional-laptops"},"observation_count":1,"avg_price_last_30d":389.9,"insufficient_history":true}},"exampleRequest":{"q":"laptop","country":"us","retailer":"amazon","lookback_days":30},"tags":["x402","shopping"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.00","successRate":"0.00","reviews":1,"stars":null,"state":"rated"},"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_r1rCdrBxoznG2TYC2Vcfz","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":"Check whether a product's current price is below its rolling average, returning current price, rolling average, lowest-seen price, and date within a configurable lookback window.","exampleAgentPrompt":"Is the current price of AirPods on Amazon lower than its 30-day average? Check against a 30-day lookback window in the US and tell me the current price, the rolling average, and the lowest price ever seen.","exampleUseCases":null,"resultDescription":"Returns an array of matching product price-drop results, each containing the current price, the rolling average price over the configured lookback window (field named avg_price_last_30d for backwards compatibility), the lowest-seen price and its date, and the original query string.","failureModes":["Empty 'drops' array if no products match the search query","Unsupported retailer or country enum value returns validation error","Very short or ambiguous query string may yield irrelevant results","lookback_days values outside acceptable range may return errors or default behavior","Price data unavailable for niche or newly listed products"],"whenToPreferThis":"Use this endpoint when you need to determine whether a product's current price represents a good deal relative to its recent price history — specifically when comparing against a rolling average and lowest-seen price. Prefer this over a simple best-price lookup when the goal is historical context and deal detection rather than just cross-retailer comparison.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-06-26T22:23:22.355Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:42:18.670Z","isFirstParty":false}