Developer API
Read Aeriepeek's product trend data from your own tools: trend stage, pick check, risk flags, estimated margin, best time to sell, store gaps and niche topics.
What this data is: how many stores list a product through CJdropshipping, how that count changes day to day, supplier costs, and Google Trends search interest. Pinterest and eBay data appear only when those sources are switched on, and they aren't today. It is not sales data. We don't know how many units anyone sold. Every response says when its numbers are from.
Get a key
API access comes with Pro and Business, including the 7-day trial. Open Account in the app, then API access, and choose Create key. Keys start with ap_live_.
We show the full key once, when you make it. We only keep a fingerprint (a SHA-256 hash), so we can't show it again. If you lose it, revoke it and make a new one. You can have up to 5 active keys.
Keep keys on your server. Anyone who has a key can use your daily calls, so don't put it in browser or app code.
Authentication
Send the key in the Authorization header on every request. Base URL: https://aeriepeek.com/api/v1. Every endpoint is GET and returns JSON.
curl https://aeriepeek.com/api/v1/products?limit=5 \
-H "Authorization: Bearer $AERIEPEEK_KEY"
Every successful response has data and meta. meta includes asOf (the date the numbers are from), source, and attribution.
Products
GET/api/v1/products
Products in our catalog, with trend stage, pick check, risk flags, estimated margin and best time to sell. You get as many rows as your plan's product list (Pro 1,000, Business 5,000).
| Parameter | What it does |
|---|---|
q | Words in the product name |
stage | new, emerging, rising, stable, saturated, declining, or early (emerging and rising) |
verdict | Pick check: strong, maybe or skip |
group, category | Our broad group (pets, home, beauty, tech, …) or CJ's exact category name |
warehouse=us | Only products in CJ's US-warehouse list |
minPrice, maxPrice | Supplier cost range, USD |
minMargin, maxMargin | Estimated margin, USD |
sort | listed (default), growing, newest, margin, price, price_desc |
limit, offset | Paging. limit is 1 to 100 (default 50). paging.next is the next offset, or null on the last page. |
curl "https://aeriepeek.com/api/v1/products?stage=early&verdict=strong&group=pets&sort=growing&limit=20" \
-H "Authorization: Bearer $AERIEPEEK_KEY"
{
"data": [{
"id": "1849…", "name": "Orthopedic Calming Pet Bed Donut", "category": "Pet Beds & Mats", "group": "pets",
"stage": { "key": "emerging", "label": "Emerging" },
"stores": { "listing": 420, "change7d": 118 },
"supplier": { "name": "CJdropshipping", "costMin": 9.5, "costMax": 11, "currency": "USD", "usWarehouse": true, "url": "https://cjdropshipping.com/…" },
"estimate": { "suggestedPrice": 27.99, "margin": 16.99, "note": "About 2.5x the top supplier cost, before shipping, fees and ads." },
"pickCheck": { "verdict": "strong", "label": "Strong pick", "reasons": [ … ] },
"risks": [],
"bestTime": { "peakMonth": "Dec", "peakMonths": ["Nov", "Dec", "Jan"], "listBy": "2026-11-18", "note": "…", "source": "Google Trends via SerpApi …" }
}],
"paging": { "offset": 0, "limit": 20, "total": 37, "next": 20 },
"meta": { "asOf": "2026-11-18", "source": "CJdropshipping store listings and our daily snapshots; …", "attribution": "Data from Aeriepeek", "note": "Trend and supplier data, not sales." }
}
The estimated margin is the suggested price minus the top supplier cost. It doesn't include shipping, platform fees or ads.
GET/api/v1/products/{id}
One product, with everything above plus the Signal check (store adds and Google searches side by side; Pinterest and eBay show only when those sources are switched on), daily store-count history (Pro 30 days, Business 90 days) and similar products from the same CJ category.
curl https://aeriepeek.com/api/v1/products/1849… \
-H "Authorization: Bearer $AERIEPEEK_KEY"
Gaps
GET/api/v1/gaps
Crowded vs. open, by group: products many stores already list and growth has slowed, next to products few stores list yet that are still being added. Also niche topics with rising searches but few matching products. Each response includes the rules we use.
curl https://aeriepeek.com/api/v1/gaps -H "Authorization: Bearer $AERIEPEEK_KEY"
Niches
GET/api/v1/niches?kind=etsy|seasonal
Niche finder topics (Etsy and print-on-demand, or seasonal), ranked, with stage, search interest change, season timing and a matching Pinterest trend when that source is switched on. kind defaults to etsy.
curl "https://aeriepeek.com/api/v1/niches?kind=seasonal" -H "Authorization: Bearer $AERIEPEEK_KEY"
GET/api/v1/niches/{kind}/{slug}
One topic, with when interest usually peaks, the weekly Google Trends series and matching products (seasonal topics).
curl https://aeriepeek.com/api/v1/niches/seasonal/christmas-pet -H "Authorization: Bearer $AERIEPEEK_KEY"
Use with Claude, ChatGPT or Cursor (MCP)
Aeriepeek is also an MCP server, so an AI assistant can search the catalog for you ("find rising pet products under $10 that ship from the US"). It uses the same API key and daily limits as the API: every tool call counts as one API call. Endpoint: https://aeriepeek.com/mcp (Streamable HTTP, key in the Authorization header).
Tools: search_products, get_product, store_gaps, list_niches, get_niche. All read-only. Store counts are supplier listings, not sales, and margins are estimates.
Claude Desktop or Claude Code, Cursor and other clients that take a JSON config:
{
"mcpServers": {
"aeriepeek": {
"type": "http",
"url": "https://aeriepeek.com/mcp",
"headers": { "Authorization": "Bearer ap_live_..." }
}
}
}
Claude Code from a terminal: claude mcp add --transport http aeriepeek https://aeriepeek.com/mcp --header "Authorization: Bearer ap_live_..."
New to MCP? Read the plain-language Claude, ChatGPT and Cursor setup guide.
Hosts that only connect with OAuth (for example some web-based connector screens) aren't supported yet. Keep your key private; revoke it in Account if it leaks.
Limits
| Plan | API calls per day | Product rows | History |
|---|---|---|---|
| Free | No API access | – | – |
| Pro and the 7-day trial | 500 | 1,000 | 30 days |
| Business | 5,000 | 5,000 | 90 days |
The daily limit is for your whole account, across all your keys. It resets at 00:00 UTC. Every response has X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (Unix time). Over the limit you get 429 with Retry-After in seconds. Our data updates once a day, around 06:15 to 07:00 UTC, so there's rarely a reason to ask for the same thing twice in a day.
Errors
Errors use one shape: {"error": {"code": "…", "message": "…", "docs": "…"}}.
| Status | Code | What it means |
|---|---|---|
| 400 | bad_request | A parameter or id isn't valid |
| 401 | missing_key, invalid_key, revoked_key | No key, a key we don't know, or a key that was revoked |
| 403 | plan_required | The account has no active Pro or Business plan |
| 404 | not_found | No such endpoint, product or topic |
| 405 | method_not_allowed | The API is read-only. Use GET. |
| 429 | rate_limited | Daily limit reached. Wait Retry-After seconds. |
| 500 | server_error | Something went wrong on our side. Try again in a minute. |
Terms
- Use the data in your own tools, research and store work. Don't resell it or redistribute the raw data, for example as a feed, a dataset or another API.
- When you show our data to other people, credit it: Data from Aeriepeek.
- Don't say or suggest the data shows sales, revenue or guaranteed results. It shows store listings, supplier costs and search interest.
- We can revoke keys that are shared, abused or used against these terms, and we may change limits with notice. Breaking changes will come as a new version (
/api/v2), not to v1. - We keep a log of which endpoints and items each key looks up (no request bodies, no IPs) for 90 days, to run the limits and learn what's useful. See the Privacy Policy.
- The data is a guide and can be wrong or late. Check anything important before you rely on it. Our Terms of Service apply.
Questions or need more calls? support@aeriepeek.com