Now supporting product search on 20 storefronts

Search Amazon, Walmart, Coupang, Olive Young, Rakuten, Flipkart, Zalando and 13 more storefronts in five countries, and get each one’s product ranking with prices, ratings and review counts in the same shape.

What you get

• COMMERCE_SERP: one task searches one storefront, picked with payload.site, from 20 storefronts in the US, Korea, Japan, India and Germany.
• products: the storefront’s ranking for your query, up to 40 products, each with rank, productId, title and url.
• price as a number with its currency, plus rating, reviewCount, brand and imageUrl whenever the results page shows them.
• The same product fields on every storefront, so one parser reads Amazon, Coupang, Rakuten and Zalando alike.

Storefronts

• United States (US): Amazon amazon, Walmart walmart, Target target, eBay ebay, AliExpress aliexpress, Sephora sephora, Ulta ulta
• Korea (KR): Coupang coupang, 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 first results page the storefront shows for your query in its own country and returns the products in the storefront’s default order. Listings the storefront marks as sponsored are left out on every storefront except Coupang, and rank counts the rest in page order.

productId is the storefront’s own ID: the ASIN on Amazon, the item number on eBay, shop:item on Rakuten. price is a number in the product’s own currency (ISO 4217), and the lowest price when sizes are priced apart. rating uses a five-point scale on the storefronts that show ratings; Kurly and Zalando list products with prices and titles.

When a storefront sends a search to another page, the products come from that page: Ulta sends some brand names to the brand page, Target sends some searches to a related search, and Nykaa shows the category page for searches that name a category. A search that finds no products ends as a failed task.

Where it helps

• Track where your product ranks for its category search on Amazon, Walmart and Target, day by day.
• Compare your price, rating and review count with the products ranked around you.
• Follow a beauty or fashion line across Olive Young, Rakuten, Nykaa and Zalando with one request shape.
• Put the storefront ranking next to ChatGPT or Google AI Mode answers for the same query and see which products shoppers meet in each place.

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_SERP",
    "payload": { "site": "target", "query": "sunscreen", "limit": 10 }
  }'

Request fields

taskTypestringRequired

The engine to run, such as CHATGPT or GOOGLE.

payload.sitestringRequired

The storefront to search, such as amazon, coupang or rakuten. The 20 values are listed with the engine.

payload.querystringRequired

The search query, written the way a shopper types it into the storefront’s search box. 1 to 500 characters.

payload.countrystring

The storefront’s own country, such as US for amazon or KR for coupang. It is also the default.

payload.limitinteger

Products to return, 1 to 40. Default 20.

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": "fa04f93f-babe-4d50-9549-8b7100261fee",
    "taskType": "COMMERCE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-22T00:05:55.416Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "target",
    "query": "sunscreen",
    "country": "US",
    "returnedCount": 10,
    "products": [
      {
        "rank": 1,
        "productId": "76545827",
        "title": "La Roche Posay Anthelios Melt in Milk Sunscreen Lotion - SPF 100 - 3.0 fl oz",
        "brand": "La Roche Posay",
        "url": "https://www.target.com/p/la-roche-posay-anthelios-melt-in-milk-sunscreen-lotion-spf-100-3-0-fl-oz/-/A-76545827",
        "price": 20.99,
        "currency": "USD",
        "rating": 4.54,
        "reviewCount": 995
      },
      {
        "rank": 2,
        "productId": "80839020",
        "title": "Neutrogena Beach Defense Sunscreen Lotion - SPF 70 - 1 fl oz",
        "brand": "Neutrogena",
        "url": "https://www.target.com/p/neutrogena-beach-defense-sunscreen-lotion-spf-70-1-fl-oz/-/A-80839020",
        "price": 1.99,
        "currency": "USD",
        "rating": 4.59,
        "reviewCount": 1580
      },
      "…"
    ]
  }
}

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

The number of products in products.

response.productsarray

Products in the storefront’s order: rank, productId, title and url, plus price, currency, rating, reviewCount, imageUrl and brand when the results page shows them.

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

site is outside the 20 storefronts, query is empty or longer than 500 characters, limit is outside 1 to 40, or the payload carries another field. details names the field.

REGION_UNSUPPORTEDHTTP 422

country is another country than the storefront’s own, such as KR with amazon.

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 search uses 3 credits on every storefront. Credits are charged when the task completes.