← Back to Aeriepeek

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.

Start 7-day trial for $1Open Account in the app

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).

ParameterWhat it does
qWords in the product name
stagenew, emerging, rising, stable, saturated, declining, or early (emerging and rising)
verdictPick check: strong, maybe or skip
group, categoryOur broad group (pets, home, beauty, tech, …) or CJ's exact category name
warehouse=usOnly products in CJ's US-warehouse list
minPrice, maxPriceSupplier cost range, USD
minMargin, maxMarginEstimated margin, USD
sortlisted (default), growing, newest, margin, price, price_desc
limit, offsetPaging. 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

PlanAPI calls per dayProduct rowsHistory
FreeNo API access––
Pro and the 7-day trial5001,00030 days
Business5,0005,00090 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": "…"}}.

StatusCodeWhat it means
400bad_requestA parameter or id isn't valid
401missing_key, invalid_key, revoked_keyNo key, a key we don't know, or a key that was revoked
403plan_requiredThe account has no active Pro or Business plan
404not_foundNo such endpoint, product or topic
405method_not_allowedThe API is read-only. Use GET.
429rate_limitedDaily limit reached. Wait Retry-After seconds.
500server_errorSomething went wrong on our side. Try again in a minute.

Terms

Questions or need more calls? support@aeriepeek.com