Skip to content
Docs

Data Service Response

The Data Service returns a query record for each bulk query you retrieve with a Data Service Request. The outer structure is the same for every operation; only data.json_result.result changes, because each operation returns its own kind of Amazon data.

This page describes the record returned by GET https://data.easyparser.com/v1/queries/{id}. It is not the webhook payload: the webhook sent to your callback_url only tells you that a query has finished.

Response structure

success
message                  (when present)
data
  id
  bulk_request_id
  group_id
  account_id
  status                 pending | success | failure
  platform
  operation
  domain
  payload
  callback_url
  create_date
  json_result            (once processing has finished)
    request_info
      id, success, status_code
      error_details[]    { error_code, message }
      address            { zipCode[], city, country_code, district }
    result               (operation-specific)
  links[]                { type, href, method, format, raw }

Response fields

Top level

FieldTypeDescription
successbooleanWhether the Data Service request itself succeeded. It is true for a failure query too; check data.status for the query outcome.
messagestringError or status message, when present.
dataobjectThe query record, including its status and, once finished, the parsed result.

data

FieldTypeDescription
idstringQuery ID. The results[].id you received in the Bulk Service Response.
bulk_request_idstringID of the bulk request (the whole submission). Matches meta_data.bulk_request_id in the Bulk Service Response.
group_idstringID of the request object (group) the query was generated from. Matches data.accepted[].group_id in the Bulk Service Response.
account_idintegerID of the account that submitted the query.
statusstringProcessing status of the query. See Status values.
platformstringTarget platform, for example AMZ.
operationstringOperation that was run, for example DETAIL, OFFER or SELLER_FEEDBACK.
domainstringMarketplace domain, for example .com or .de.
payloadobjectThe single input value this query was created from, for example { "asin": "B0F18KTG8Q" }.
callback_urlstringThe callback_url of the group this query belongs to.
create_datestringWhen the query was created (ISO 8601 date-time).
json_resultobjectThe parsed result and fetch details. Present once processing has finished; absent while status is pending.
linksarrayLinks to the query record and to its result. See data.links[] below. Not shown in the samples on this page.

data.json_result

FieldTypeDescription
request_infoobjectTechnical details of the fetch: success, status code, errors and location.
resultobjectThe parsed Amazon data. Its structure depends on the operation. Empty ({}) when the query failed.

json_result.request_info

FieldTypeDescription
idstringQuery ID, the same value as data.id.
successbooleanWhether the page was fetched and parsed successfully.
status_codeintegerStatus code of the fetch. 200 on success; 0 when the page could not be fetched or parsed.
error_detailsarrayErrors raised during processing. Empty when the query succeeded.
error_details[].error_codeintegerNumeric error code, for example 5002.
error_details[].messagestringError description, for example Something Went Wrong.
addressobjectLocation used to localize the request. May be absent for operations that do not use a location, such as SALES_ANALYSIS_HISTORY.
address.zipCodearrayZip code or codes used, as strings.
address.citystring or nullResolved city, when available.
address.country_codestring or nullResolved country code, when available.
address.districtstring or nullResolved district, when available.

json_result.result

result holds the parsed data of the operation you ran. Its fields follow the response of the same operation in the Real-Time API, so use the operation's response page for the full field list. The table lists the top-level keys you find in Data Service results.

OperationTop-level keys in resultFull reference
DETAILProduct fields such as asin, title, brand, buybox_winner, variants, images, videos, specifications, rating_breakdown, top_reviews, customer_sayDetail response
OFFERoffer.offer_results[], pagination, productOffer response
SEARCHsearch_results[], pagination, refinements, related_searches, result_information, delivered_toSearch response
PRODUCT_LOOKUPsearch_result.products[], country_codeProduct Lookup response
SELLER_PROFILEseller_details, feedback_summary, feedback, ask_a_question, not_matchSeller Profile response
SELLER_PRODUCTSseller_products[], pagination, refinements, delivered_toSeller Products response
SELLER_FEEDBACKseller_feedback[], paginationSeller Feedback response
SALES_ANALYSIS_HISTORYhistory[], productSales Analysis and History response
BEST_SELLERS_RANKproduct (including bestseller), country_codeBest Sellers Rank response
PACKAGE_DIMENSIONpackage, product, country_codePackage Dimension response
SIMILAR_PRODUCTSproduct (including similar[])Similar Products response

Some result shapes in the Data Service samples differ from the Real-Time API samples:

  • DETAIL: the product fields are directly under json_result.result (for example json_result.result.title). This differs from the Real-Time Detail response, which nests them under result.detail.
  • PRODUCT_LOOKUP: the sample shows country_code and search_result under an extra result key.
  • Pagination: OFFER, SEARCH, SELLER_PRODUCTS and SELLER_FEEDBACK return a pagination object inside result, and its fields differ by operation. OFFER uses current_page, total_pages, total_results and current_offer_count; SEARCH and SELLER_PRODUCTS use current_page, last_visible_page and result_count; SELLER_FEEDBACK uses current_page, has_next_page and next_page.
FieldTypeDescription
typestringself points to the query record; result points to the parsed data.
hrefstringFull URL to call.
methodstringHTTP method to use: GET.
formatstringFormat of the response the link returns, for example json.
rawbooleanWhether the link returns the query record rather than the parsed result.

Status values

Check data.status before you read json_result.

ValueMeaning
pendingThe query was accepted and is still processing. There is no json_result yet; retry after a short interval, for example 10 seconds.
successProcessing finished. json_result.result contains the parsed data.
failureProcessing finished without data. json_result.result is empty and json_result.request_info.error_details explains why.

success and failure are final. Processing times out after 5 minutes; a query that does not finish in time ends with failure.

Sample responses

The samples are abbreviated: each result shows only a few representative fields. See the operation's response page for the complete field list.

Sample response (pending query, SEARCH, .com)
{
  "success": true,
  "data": {
    "id": "01a111a8-0d0b-7f0c-b381-8c1c88084534",
    "account_id": 555,
    "status": "pending",
    "platform": "AMZ",
    "operation": "SEARCH",
    "domain": ".com",
    "callback_url": "https://example.com/webhook",
    "payload": {
      "keyword": "car play winter smart pen redesign"
    },
    "create_date": "2026-10-06T14:39:48.472Z",
    "bulk_request_id": "01a111a8-0cf8-7ed5-b104-0b1c78bcd2a1",
    "group_id": "01a111a8-0d0b-7f0c-b381-8c1d2e5feb39"
  }
}
Sample response (failed query, OFFER, .com)
{
  "success": true,
  "data": {
    "account_id": 555,
    "bulk_request_id": "01a03e40-5b12-7c3e-9d4a-2f8e6b1c7a90",
    "callback_url": "https://example.com/webhook",
    "create_date": "2026-06-24T21:20:56.185Z",
    "domain": ".com",
    "group_id": "01a03e40-5b1a-7f02-8c6d-4e9a3b2d1f58",
    "id": "019efb81-eb45-7e4f-a6a2-9bdcc619921e",
    "json_result": {
      "request_info": {
        "id": "019efb81-eb45-7e4f-a6a2-9bdcc619921e",
        "success": false,
        "status_code": 0,
        "error_details": [
          {
            "error_code": 5002,
            "message": "Something Went Wrong."
          }
        ],
        "address": {
          "zipCode": ["19805"],
          "city": null,
          "country_code": null,
          "district": null
        }
      },
      "result": {}
    },
    "operation": "OFFER",
    "payload": {
      "url": "https://www.amazon.com/sp?ie=UTF8&seller=A29DXXRE3BKYH7",
      "link": "/sp?ie=UTF8&seller=A29DXXRE3BKYH7"
    },
    "platform": "AMZ",
    "status": "failure"
  }
}
Sample response (successful query, DETAIL, .com)
//DETAIL
{
  "success": true,
  "data": {
    "account_id": 555,
    "bulk_request_id": "01a03f12-8c40-7a1d-b2e5-6d9f0a3c4e71",
    "callback_url": "https://example.com/webhook",
    "create_date": "2026-06-24T22:31:10.482Z",
    "domain": ".com",
    "group_id": "01a03f12-8c47-7b58-a1f3-9e2c5d8b6a04",
    "id": "019efbc1-2a7e-71d4-9f3c-4a1b8e2d5c60",
    "json_result": {
      "request_info": {
        "id": "019efbc1-2a7e-71d4-9f3c-4a1b8e2d5c60",
        "success": true,
        "status_code": 200,
        "error_details": [],
        "address": {
          "zipCode": ["19805"],
          "city": null,
          "country_code": null,
          "district": null
        }
      },
      "result": {
        "asin": "B0F18KTG8Q",
        "title": "TOURIT Cooler Backpack 32 Cans Large Capacity Insulated Backpack Cooler Bag",
        "brand": "TOURIT",
        "link": "https://www.amazon.com/dp/B0F18KTG8Q",
        "rating": "4.5",
        "ratings_total": 2487,
        "main_image": {
          "id": "41b8ItfyBzL",
          "link": "https://m.media-amazon.com/images/I/41b8ItfyBzL.jpg"
        },
        "buybox_winner": {
          "price": {
            "symbol": "$",
            "raw": "$24.99",
            "currency": "USD",
            "value": "24.99"
          },
          "availability": {
            "raw": "In Stock"
          },
          "seller_type": {
            "type": "FBA",
            "is_fulfilled_by_amazon": true
          }
        },
        "variants": [
          {
            "asin": "B0F18KTG8Q",
            "title": "Green",
            "is_current_product": true,
            "dimensions": [
              {
                "name": "Color",
                "value": "Green"
              }
            ]
          }
        ],
        "top_reviews": [
          {
            "id": "R3KQWZ8N2PLXVA",
            "title": "Perfect for beach days",
            "rating": "5.0",
            "body": "Took this to the lake and it kept everything cold for the whole afternoon. The padded straps make a real difference when it is packed full, and the front pocket holds keys and sunscreen without getting damp.",
            "date": {
              "raw": "Reviewed in the United States on June 12, 2026"
            },
            "profile": {
              "id": "AF4KDLQ7NX2MTBWZ3RHVY6PSCQ5A",
              "name": "Daniel R.",
              "link": "https://www.amazon.com/gp/profile/amzn1.account.AF4KDLQ7NX2MTBWZ3RHVY6PSCQ5A"
            },
            "link": "https://www.amazon.com/gp/customer-reviews/R3KQWZ8N2PLXVA",
            "helpful_votes": 3,
            "verified_purchase": true,
            "vine_program": false,
            "is_global_review": true,
            "review_country": "USA"
          }
        ]
      }
    },
    "operation": "DETAIL",
    "payload": {
      "asin": "B0F18KTG8Q"
    },
    "platform": "AMZ",
    "status": "success"
  }
}
Abbreviated result by operation

Each snippet shows only the result object of a successful query, not the full record.

// OFFER
{
  "offer": {
    "offer_results": [
      {
        "buybox_winner": true,
        "position": 0,
        "condition": {
          "is_new": true,
          "title": "New"
        },
        "price": {
          "symbol": "$",
          "raw": "$24.99",
          "value": "24.99"
        },
        "seller": {
          "id": "A29DXXRE3BKYH7",
          "name": "TOURIT Official Store",
          "rating": "5.0"
        },
        "seller_type": {
          "fba": true,
          "fbm": false,
          "is_prime": true
        }
      }
    ]
  },
  "pagination": {
    "current_page": 1,
    "total_pages": 1,
    "total_results": 6,
    "current_offer_count": 6
  },
  "product": {
    "asin": "B0F18KTG8Q",
    "title": "TOURIT Cooler Backpack",
    "rating": "4.5",
    "offer_count": 6
  }
}
// SALES_ANALYSIS_HISTORY
{
  "history": [
    {
      "date": "2026-06-21T00:00:00.000Z",
      "average_price": 36.18,
      "best_seller_rank": 6,
      "purchases": 1,
      "total_offers": 2,
      "views": 97
    }
  ],
  "product": {
    "asin": "B0F25371FH",
    "brand": "STANLEY",
    "name": "STANLEY Quencher H2.0 Tumbler",
    "category": "Kitchen & Dining/Storage & Organization/Thermoses",
    "marketplace": "US",
    "performance": {
      "sales": {
        "purchases_last30_days": 7,
        "purchases_last90_days": 47
      },
      "traffic": {
        "views_last30_days": 661,
        "views_last90_days": 4290
      }
    }
  }
}
// BEST_SELLERS_RANK
{
  "country_code": "US",
  "product": {
    "asin": "B0F25371FH",
    "brand_name": "STANLEY",
    "title": "STANLEY Quencher H2.0 Tumbler with Handle and Straw",
    "link": "https://www.amazon.com/gp/product/B0F25371FH",
    "bestseller": {
      "rank": 4,
      "context_name": "Kitchen & Dining",
      "sub_category_id": "46802055"
    },
    "reviews": {
      "rating_value": 4.7,
      "total_count": 100732
    }
  }
}
// PACKAGE_DIMENSION
{
  "country_code": "US",
  "package": {
    "dimensions": {
      "length": 12.95,
      "width": 5.91,
      "height": 4.21,
      "unit": "inches"
    },
    "weight": {
      "value": 1.759,
      "unit": "pounds"
    }
  },
  "product": {
    "asin": "B0F25371FH",
    "brand": "STANLEY",
    "title": "STANLEY Quencher H2.0 Tumbler with Handle and Straw",
    "link": "https://www.amazon.com/dp/B0F25371FH",
    "weight": {
      "value": 1.75,
      "unit": "pounds"
    }
  }
}
// SEARCH
{
  "delivered_to": "Wilmington 19805",
  "pagination": {
    "current_page": 1,
    "current_page_link": "k=car&language=en_US&qid=1791297656&xpid=re54g8dzVxg2Q",
    "last_visible_page": 20,
    "next_page_link": "/s?k=car&page=2&language=en_US&xpid=re54g8dzVxg2Q&qid=1791297656&ref=sr_pg_1",
    "result_count": 22
  },
  "refinements": {
    "department": [
      {
        "heading_id": "n-title",
        "name": "Automotive",
        "refinement_display_name": "Department",
        "value": "n/15684181",
        "link": "/s?k=car&rh=n%3A15684181"
      }
    ]
  },
  "related_searches": [
    {
      "query": "car accessories",
      "link": "/s?k=car+accessories"
    }
  ],
  "result_information": {
    "begin": 1,
    "end": 16,
    "raw": "1-16 of over 100,000 results for 'car'",
    "search_term": "car",
    "total_product_count": 100000
  },
  "search_results": [
    {
      "asin": "B0D4215HCX",
      "position": 2,
      "title": "LISEN Retractable Car Charger, 84W Car Charger USB C Fast Charge,4 in 1",
      "is_prime": true,
      "is_sponsored": false,
      "main_image": {
        "id": "71Ryl5xKbuL",
        "link": "https://m.media-amazon.com/images/I/71Ryl5xKbuL.jpg"
      },
      "price": {
        "currency": "USD",
        "raw": "$15.31",
        "symbol": "$",
        "value": "15.31"
      },
      "prices": [
        { "currency": "USD", "raw": "$15.31", "symbol": "$", "value": "15.31" },
        { "currency": "USD", "is_rrp": true, "raw": "$19.99", "symbol": "$", "value": "19.99" }
      ],
      "bought_activity": {
        "period": "past month",
        "raw": "10K+ bought in past month",
        "symbol": "K",
        "value": 10000
      },
      "rating": "4.5",
      "ratings_total": 25275,
      "source_page": 1
    }
  ]
}
// PRODUCT_LOOKUP (note the extra `result` nesting)
{
  "result": {
    "country_code": "US",
    "search_result": {
      "products": [
        {
          "asin": "B000024D4S",
          "title": "Wish You Were Here",
          "brand": "Parlophone",
          "manufacturer": "Capitol",
          "link": "https://www.amazon.com/dp/B000024D4S",
          "identifiers": [
            {
              "type": "upc",
              "value": "724382975021"
            },
            {
              "type": "ean",
              "value": "0724382975021"
            }
          ]
        }
      ],
      "total_product_count": 2
    }
  }
}
// SELLER_PROFILE
{
  "seller_details": {
    "name": "Amazon Resale",
    "business_name": "Amazon.com Services, Inc",
    "business_address": "410 Terry Avenue North, Seattle, WA, 98109-5210, US",
    "business_country": "US",
    "rating": 0,
    "ratings_total": 0,
    "store_link": "https://www.amazon.com/s?ie=UTF8&me=A2L77EE7U53NWQ"
  },
  "ask_a_question": "https://www.amazon.com/gp/help/contact-us/general-questions.html"
}
// SELLER_PRODUCTS
{
  "seller_products": [
    {
      "asin": "B0XXXXXXXX",
      "position": 1,
      "title": "Example seller product",
      "is_prime": true,
      "price": {
        "symbol": "$",
        "raw": "$19.99",
        "value": "19.99"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "last_visible_page": 3,
    "result_count": 16
  },
  "refinements": {
    "availability": [],
    "condition": []
  },
  "delivered_to": "Wilmington 19805"
}
// SELLER_FEEDBACK
{
  "seller_feedback": [
    {
      "rater": "Blas5455",
      "rating": 5,
      "body": "Their customer service was excellent.",
      "date": {
        "raw": "June 23, 2026",
        "timestamp": 1782172800000
      },
      "has_response": false,
      "profile": {
        "url": "/gp/profile/amzn1.account.AFZ4R6ZW3MPMHMOUBXLPAR3NGISA"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "has_next_page": true,
    "next_page": 2
  }
}
// SIMILAR_PRODUCTS
{
  "product": {
    "asin": "B0G2V8898X",
    "brand": "Spedal",
    "category": "Car & Vehicle Electronics/Vehicle Electronics Accessories/Audio & Video Accessories",
    "image": {
      "id": "41J-WgccuxL",
      "link": "https://m.media-amazon.com/images/I/41J-WgccuxL.jpg",
      "variant": "MAIN"
    },
    "title": "Spedal 2026 2-in-1 Wireless CarPlay & Android Auto Adapter",
    "similar": [
      {
        "asin": "B0G64V3PVR",
        "brand": "OTTOCAST",
        "category": "Car & Vehicle Electronics/Vehicle Electronics Accessories/Audio & Video Accessories",
        "image": {
          "id": "31WBjLekrEL",
          "link": "https://m.media-amazon.com/images/I/31WBjLekrEL.jpg",
          "variant": "MAIN"
        },
        "title": "OTTOCAST Mini Edge 2-in-1 Wireless CarPlay & Android Auto Adapter 2026"
      },
      {
        "asin": "B0HCCY69WS",
        "brand": "LAMTTO",
        "category": "Car & Vehicle Electronics/Vehicle Electronics Accessories/Audio & Video Accessories",
        "image": {
          "id": "41FoFyc2ctL",
          "link": "https://m.media-amazon.com/images/I/41FoFyc2ctL.jpg",
          "variant": "MAIN"
        },
        "title": "LAMTTO Wireless CarPlay and Android Auto Adapter with Gemini AI YouTube"
      }
    ]
  }
}

Errors

CaseWhat you receiveWhat to do
Missing or invalid API keyHTTP 401 or 403Send a valid key in the api-key header.
Unknown or expired queryHTTP 404, or success: false with error_code 3404Check that you sent results[].id (not bulk_request_id or group_id). Results older than 24 hours are no longer available.
Query faileddata.status is failure and json_result.request_info.error_details lists the errors, for example 5002 Something Went Wrong.Read error_details for the reason, then submit the input again in a new bulk request.
Page could not be fetched or parsedjson_result.request_info.status_code is 0Same as a failed query.
Privacy Policy© 2026 Easyparser