TagX Product Scraping API

GET /credits

Returns the remaining credit balance for the authenticated user. This endpoint is free.

Example

curl -X GET "https://amzapi.tagxdata.com/credits" \
  -H "x-api-key: your_api_key_here"

import requests

resp = requests.get(
    "https://amzapi.tagxdata.com/credits",
    headers={"x-api-key": "your_api_key_here"},
)
print(resp.json())   # {'credits': 10.0}

Response

{
  "credits": 10.0
}

POST /pdp

Fetches a product page and returns the parsed product details as JSON in the same response — there is no polling. The URL is validated first: it must be a valid product URL from a supported marketplace. Invalid or non-product URLs are rejected before any credits are charged.

Request Body

Pricing

Each successful call costs $0.10 (or your account's custom PDP rate). If the page cannot be fetched, the charge is automatically refunded.

Example

curl -X POST "https://amzapi.tagxdata.com/pdp" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/dp/PRODUCTID"
  }'

import requests

resp = requests.post(
    "https://amzapi.tagxdata.com/pdp",
    headers={
        "x-api-key": "your_api_key_here",
        "Content-Type": "application/json",
    },
    json={"url": "https://www.example.com/dp/PRODUCTID"},
)

result = resp.json()
product = result["data"]
print(product["title"], product["price"]["current"])

Response

The parsed product is returned under data:

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "cost": 0.10,
  "data": {
    "asin": "PRODUCTID0",
    "title": "Example Product Title - Variant, Size, Colour",
    "price": { "current": "1900", "list_price": null },
    "images": [ "https://images.example.com/i/product-1_large.jpg", "..." ],
    "description": "",
    "features": [ "Key selling point one ...", "Key selling point two ...", "..." ],
    "brand": "Example Brand",
    "brand_url": "https://www.example.com/stores/ExampleBrand/page/...",
    "category": [],
    "rating": {
      "average": "4.5",
      "count": "78",
      "breakdown": { "five_star": "...", "four_star": "...", "three_star": "...", "two_star": "...", "one_star": "..." }
    },
    "seller": {},
    "variants": [ "16.9 Fl Oz (Pack of 1)", "33.8 Fl Oz (Pack of 1)" ],
    "additional_details": {},
    "coupon": null,
    "coupon_details": null,
    "prime_flag": "Yes",
    "subscribe_and_save": "YES",
    "video": [],
    "feature_bullets_count": 5,
    "count_of_images": 10,
    "amazons_choice_flag": "YES",
    "best_seller_flag": "NO",
    "climate_pledge_friendly": "YES",
    "small_business_badge": "NO"
  }
}

Field reference

A field that is not present on a given product is returned empty (null, [], or {}) rather than omitted, so the response shape is always the same.

POST /scrape

Submits a reviews-scraping job for a product URL and returns a request_id.

Request Body

Pricing

Examples

curl -X POST "https://amzapi.tagxdata.com/scrape" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/dp/PRODUCTID"
  }'

curl -X POST "https://amzapi.tagxdata.com/scrape" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/dp/PRODUCTID",
    "reviewer_type": "avp_only_reviews",
    "sort_by": ""
  }'

curl -X POST "https://amzapi.tagxdata.com/scrape" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/dp/PRODUCTID",
    "pages": 3
  }'

import requests, time

BASE = "https://amzapi.tagxdata.com"
headers = {"x-api-key": "your_api_key_here", "Content-Type": "application/json"}

# 1) Submit the job
resp = requests.post(f"{BASE}/scrape", headers=headers, json={
    "url": "https://www.example.com/dp/PRODUCTID",
    "all_reviews": True,
    "reviewer_type": "all_reviews",
    "sort_by": "recent",
})
request_id = resp.json()["request_id"]
print("Submitted:", request_id)

# 2) Poll until ready (202 = still processing, 200 = done)
while True:
    r = requests.get(f"{BASE}/result/{request_id}", headers=headers)
    if r.status_code == 202:
        time.sleep(5)
        continue
    r.raise_for_status()
    reviews = r.json()
    break

print(reviews)

Response

{
  "message": "Request accepted",
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

GET /result/{request_id}

Fetches the result of a previously submitted /scrape job. Poll this until it returns 200.

Status codes

Example

curl -X GET "https://amzapi.tagxdata.com/result/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: your_api_key_here"

import requests

request_id = "550e8400-e29b-41d4-a716-446655440000"
r = requests.get(
    f"https://amzapi.tagxdata.com/result/{request_id}",
    headers={"x-api-key": "your_api_key_here"},
)

if r.status_code == 202:
    print("Still processing, try again shortly.")
elif r.status_code == 200:
    print(r.json())   # review data

Response (200)

The body contains the scraped reviews for the product (structure depends on the request parameters).