Skip to main content
GET
/
v1
/
shopper
/
price-drop-alert
Check for recent price drops on a product
curl --request GET \
  --url https://api.syntalic.com/v1/shopper/price-drop-alert \
  --header 'Content-Type: application/json' \
  --data '
{
  "q": "airpods",
  "country": "us",
  "retailer": "amazon",
  "lookback_days": 30
}
'
{
  "query": "<string>",
  "drops": [
    {}
  ]
}

Query Parameters

​
q
string
required

Search query (product name, keyword, or category term)

Minimum string length: 1
​
country
enum<string>
default:us

Country (us or ca)

Available options:
us,
ca
​
retailer
enum<string>

Filter to a specific retailer

Available options:
amazon,
walmart,
costco,
homedepot,
nordstrom,
ikea
​
lookback_days
integer
default:30

Days to look back for price drops (default 30)

Body

application/json

Query parameters as JSON (alternative to URL query string for agents that prefer body-based invocation).

​
q
string
required

Search query (product name, keyword, or category term)

Minimum string length: 1
Example:

"airpods"

​
country
enum<string>
default:us

Country (us or ca)

Available options:
us,
ca
Example:

"us"

​
retailer
enum<string>

Filter to a specific retailer

Available options:
amazon,
walmart,
costco,
homedepot,
nordstrom,
ikea
Example:

"amazon"

​
lookback_days
integer
default:30

Days to look back for price drops (default 30)

Example:

30

Response

Price drop alerts

​
query
string
​
drops
object[]