API reference

Search

GET/v1/search

Find products by title, ASIN or amazon.com link.

1 request per callTry it

Request

curl -G https://trackpin.co/api/v1/search \
  --data-urlencode "q=air fryer" \
  -d limit=2 \
  -H "x-api-key: $TRACKPIN_API_KEY"

const params = new URLSearchParams({ q: "air fryer", limit: "2" });
const res = await fetch(`https://trackpin.co/api/v1/search?${params}`, {
  headers: { "x-api-key": process.env.TRACKPIN_API_KEY },
});
const data = await res.json();
if (!res.ok) throw new Error(`TrackPin ${res.status}: ${data.error}`);

for (const p of data.results) console.log(p.asin, p.verdict?.label ?? "no verdict", p.title);

import os
import requests

r = requests.get(
    "https://trackpin.co/api/v1/search",
    params={"q": "air fryer", "limit": 2},
    headers={"x-api-key": os.environ["TRACKPIN_API_KEY"]},
    timeout=10,
)
r.raise_for_status()
data = r.json()

for p in data["results"]:
    print(p["asin"], (p["verdict"] or {}).get("label", "no verdict"), p["title"])

ResponseLive exampleRefreshed daily

{
  "query": "air fryer",
  "resolved": null,
  "count": 2,
  "results": [
    {
      "asin": "B08QKTXT1N",
      "title": "Ninja Air Fryer XL, 5.5 Qt, 5-in-1, Grey, AF150AMZ | Air fry, roast, reheat, dehydrate, 1750W, 400F max, Fits 3 lbs wings, Dishwasher-safe",
      "image": "https://m.media-amazon.com/images/I/718YY3fzE1L._AC_SL200_.jpg",
      "rating": 4.7,
      "review_count": 68337,
      "price": {
        "current_cents": 17999,
        "reference_cents": 9999,
        "discount_pct": -80.01
      },
      "verdict": {
        "label": "above"
      }
    },
    {
      "asin": "B089TQWJKK",
      "title": "Ninja Foodi Air Fryer, 8 Qt DualZone, 6-in-1, Grey, DZ201 | Air fry, roast, broil, bake, reheat, dehydrate, 2 independent baskets, Smart Finish, Match Cook",
      "image": "https://m.media-amazon.com/images/I/719pq1kY8VL._AC_SL200_.jpg",
      "rating": 4.8,
      "review_count": 26326,
      "price": {
        "current_cents": 15995,
        "reference_cents": 12999,
        "discount_pct": -23.05
      },
      "verdict": {
        "label": "above"
      }
    }
  ]
}

Parameters

qrequired
string
Example
air fryer
At least 3 characters of title, or an ASIN, or an amazon.com product link.
limit
integer, range 1–50
Default
20
Max 50.

Response

A JSON object. Money is integer cents (USD). Fields marked nullable can be null.

querystring
Echoes q.
resolvedobjectnullable
{asin} when q was an ASIN or a product link.
countinteger
Number of results.
results[].asinstring
ASIN.
results[].titlestringnullable
Title.
results[].imagestringnullable
Image URL.
results[].ratingnumbernullable
Star rating.
results[].review_countintegernullable
Number of ratings.
results[].in_stockbooleannullable
Availability at the last check.
results[].priceobjectnullable
{current_cents, reference_cents, discount_pct, observed_at}; null when we have no price history. observed_at is when the price was last seen (ms since epoch).
results[].verdictobjectnullable
{label}; null when we have no price history.

Notes

Title search ranks titles with all of your words, best first (titles with only some of them follow when few have all); when ranking is unavailable it falls back to titles containing your text, unranked. -word leaves out titles with that word. Pasting a link or ASIN is always exact.
amazon.com product links and ASINs resolve to that product directly (resolved is set). Links to other Amazon stores or to non-product pages return 400 with a specific error.
Calls count toward your key's per-minute ceiling (Free 60, Pro 300, Business 1,200 calls a minute), and searches have their own: 20 a minute (10 on Free). A call over either gets 429 rate limit exceeded and isn't charged.
Each call with a valid key counts as one request against your daily quota, even if the request then fails. A call turned away by a per-minute ceiling (429 rate limit exceeded) doesn't count.

Errors

400query too short
q needs at least 3 characters, or an ASIN or link.
400only amazon.com links are supported
q is a link to another Amazon store.
400not a product link
q is a link that doesn't point to a product page.
401missing api key
No key sent.
401invalid api key
Unknown or revoked key.
405method not allowed
The data endpoints are GET only. The Allow header lists the methods an endpoint answers: GET, HEAD and OPTIONS (POST and OPTIONS for /v1/keys/rotate).
429rate limit exceeded
More than your plan's per-minute ceiling; wait Retry-After seconds. Not charged. The body adds limit, window_s and retry_after_s.
429daily quota exceeded
Over today's quota. The body adds limit and used.
500internal error
Something failed on our side, not in your request.
503temporarily unavailable
Our database can't be reached right now. Retry after the number of seconds in the Retry-After header.
504search timed out
The title search took too long. Use fewer or more specific words.

Error bodies are {"error": string}. A daily-quota 429 adds limit and used; a per-minute 429 adds limit, window_s and retry_after_s, with a Retry-After header. See Errors and Quotas.

Try it

Send a real request from this page with your key. It goes from your browser straight to TrackPin.

Demo mode covers /product only. Use your key to try this endpoint.

Try the product demo

Response

Send a request to see the status, headers and body here.

Early access.

Free keys are emailed straight away; Pro and Business are bought by card through Stripe. Request an API key