Introducing Commerce Product

Pass a product page URL from Amazon, Walmart, Sephora, Olive Young, Rakuten, Zalando or 11 more storefronts, and get its price, stock, gallery and description images, specs and options in one shape.

What you get

• COMMERCE_PRODUCT: one task reads one product page, from 17 storefronts in the US, Korea, Japan, India and Germany. Pass the page’s url; it picks the storefront.
• title, brand, price and listPrice with their currency, inStock, seller, rating and reviewCount, as the page shows them.
• images: the product gallery. descriptionImages: the images in the product description, such as the seller’s detail page or Amazon’s A+ content, in page order.
• description, specs, options, categories and gtin, in the same fields on every storefront.

Storefronts

• United States (US): Amazon amazon, Walmart walmart, Target target, Sephora sephora, Ulta ulta
• Korea (KR): Olive Young oliveyoung, 11st 11st, Lotte ON lotteon, Musinsa musinsa, Kurly kurly
• Japan (JP): Rakuten rakuten, Yahoo! Shopping yahoo_shopping, Qoo10 qoo10
• India (IN): Flipkart flipkart, Myntra myntra, Nykaa nykaa
• Germany (DE): Zalando zalando

How it works

Each task reads the product page from the storefront’s own country and returns the values for the choice the page opens on. price is what a shopper pays before coupons and delivery, and options lists the other sizes, colors or sets.

images holds up to 30 photos from the gallery and descriptionImages up to 300 images from the description, in page order. Description images come from Amazon, Ulta, Olive Young, 11st, Lotte ON, Musinsa, Kurly, Rakuten, Yahoo! Shopping and Qoo10. Banners and notices a seller places there come along, and text inside an image stays in the image.

title, price, currency and images come from every storefront; the other fields arrive when the page shows them, and the engine docs list the storefronts for each one. A page the storefront answers as removed, such as a discontinued product, ends the task with PAGE_UNAVAILABLE.

Where it helps

• Read the top products of a Commerce Search in full: price, stock, seller and every option.
• Track the price, list price and stock of your product page on Amazon, Olive Young and Rakuten day by day.
• Collect competitors’ gallery and detail images to compare how each brand presents the same product.
• Feed specs, options and description images into your catalog or an audit of AI shopping answers.

Send a request

Send the request with your API key in the Authorization header.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "COMMERCE_PRODUCT",
    "payload": { "url": "https://www.amazon.com/dp/B00TTD9BRC" }
  }'

Request fields

taskTypestringRequired

The engine to run, such as CHATGPT or GOOGLE.

payload.urlstringRequired

A product page on one of the 17 storefronts, up to 2,048 characters. The URL picks the storefront and its country.

payload.countrystring

The storefront’s own country, such as US for Amazon or KR for Olive Young. It is also the default.

webhook.urlstring

An HTTPS address on your server. The finished task is posted there the moment it completes.

Response

A finished task looks like this, trimmed for length.

{
  "success": true,
  "task": {
    "id": "3f0f65f4-bb08-492b-8652-7037fe7cba0d",
    "taskType": "COMMERCE_PRODUCT",
    "status": "COMPLETED",
    "createdAt": "2026-10-22T09:27:29.765Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "amazon",
    "country": "US",
    "url": "https://www.amazon.com/dp/B00TTD9BRC",
    "productId": "B00TTD9BRC",
    "title": "CeraVe Moisturizing Cream, Face & Body Moisturizer for Dry Skin, 19oz",
    "brand": "CeraVe",
    "price": 18.39,
    "currency": "USD",
    "inStock": true,
    "seller": "Amazon.com",
    "rating": 4.7,
    "reviewCount": 149176,
    "images": [
      "https://m.media-amazon.com/images/I/61EidjXUBrL._SL1000_.jpg",
      "https://m.media-amazon.com/images/I/61-Ut3jOyyL._SL1500_.jpg",
      "…"
    ],
    "descriptionImages": [
      "https://m.media-amazon.com/images/S/aplus-media-library-service-media/8c56d081-e316-4b57-9731-fcf4eda0821f.__CR0,0,1464,600_PT0_SX1464_V1___.jpg",
      "…"
    ],
    "specs": [
      { "name": "Brand Name", "value": "CeraVe" },
      { "name": "Skin Type", "value": "All, Dry, Sensitive" },
      "…"
    ],
    "options": [
      {
        "name": "Size",
        "values": [
          "8 Ounce",
          "16 Ounce (Pack of 1)",
          "19 Ounce (Pack of 1)",
          "…"
        ]
      }
    ],
    "categories": ["Beauty & Personal Care", "Skin Care", "Face", "…"]
  }
}

task.statusstring

QUEUED, PROCESSING, then COMPLETED with the answer or FAILED with error.

credits.creditsChargedinteger

Credits charged for the finished task. A failed task charges 0.

response.pricenumber

What a shopper pays for the product as the page first shows it, before coupons and delivery, in currency (ISO 4217). listPrice is the struck-through regular price when it is above price.

response.imagesarray

Up to 30 photos from the product gallery, in page order.

response.descriptionImagesarray

Up to 300 images from the product description, such as the seller’s detail page or Amazon’s A+ content, in page order.

response.specsarray

Up to 100 { name, value } pairs from the product details. options lists the choices such as size or color, each with its values.

Receive the result

The request returns the task right away with status QUEUED. Poll GET /v1/async/task/{id} until status is COMPLETED or FAILED, or add webhook.url and the finished task arrives at your server with the same task, credits and response. Results stay available for 24 hours after a task finishes.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Errors

VALIDATION_ERRORHTTP 422

url is missing, longer than 2,048 characters or outside the 17 storefronts’ product pages, or the payload carries a field other than url and country. details names the field.

REGION_UNSUPPORTEDHTTP 422

country is another country than the storefront’s own, such as KR with an Amazon URL.

MISSING_API_KEYHTTP 401

The Authorization header is missing, or its key is unknown, expired or revoked.

INSUFFICIENT_CREDITSHTTP 402

The balance is below the price of the task. Add credits or upgrade the plan, then send again.

Pricing

Each completed read uses 3 credits on every storefront. Credits are charged when the task completes.