Overview

The Bulk API is designed for processing multiple Amazon operations in a single request. Whether you need to perform a search, fetch product details, or retrieve offers across different regions, the Bulk API allows you to submit batch jobs with various parameters in a scalable and asynchronous manner.

This workflow is ideal for:

• Running multi-product or multi-operation tasks in a single API call

• Automating large-scale operations such as daily data collection, analytics, or product monitoring

• Reducing latency and minimizing API overhead for heavy workloads

🔁 High-Level Flow

1

Create a Bulk Job

You send a JSON request containing your operations (e.g., SEARCH, DETAIL, OFFER) along with parameters like marketplace domain and product URLs/ASINs. You must also provide a callback_url to receive the results.

2

Job is Processed Asynchronously

Once accepted, each input line generates a unique result ID. These IDs are returned in the response. The system processes the data in the background.

3

Webhook Notification

When processing is complete, Easyparser sends a webhook POST request to your callback_url, including the result IDs.

4

Fetch Final Results

Using the returned IDs, you can query the Data Service API to retrieve detailed structured data (in JSON or raw format) for each processed item.

🧠 Key Concepts

• callback_url: Your system endpoint that will receive a webhook call after processing.

• result ID: A unique identifier for each processed item. Use it to fetch results from the Data Service.

• Data Service API: The final source to access structured Amazon data using the returned IDs.

👉 Example Flow

1

POST /bulk/create with:

{
  "platform": "AMZ",
  "operation": "SEARCH",
  "domain": ".ca",
  "payload": {
    "urls": ["https://www.amazon.ca/s?k=mouse", "https://www.amazon.ca/s?k=table+tennis"]
  },
  "callback_url": "https://yourdomain.com/webhook"
}

2

✅ Response contains result IDs:

{
  "data": {
    "accepted": [
      {
        "results": [
          { "link": "...", "id": "250f..." },
          { "link": "...", "id": "cd4b..." }
        ]
      }
    ]
  }
}

3

📬 Webhook hits your callback_url once the job is complete.

4

🔍 Use each id to get results via:

💡 This structure allows you to fully decouple job creation and result consumption, making it perfect for asynchronous, large-scale data operations.

🔗 For full details on the request/response format, see Bulk Create and Data Service.

📤 Fetching Results

You can retrieve each result using the id via the Data Service:

curl --location 'https://data.easyparser.com/v1/queries/{id}/results' \
--header 'api-key: YOUR_API_KEY'

⚠️ Notes

• Each id corresponds to a single unit of work.

• Only supported operations and platforms will be accepted.

• Ensure your callback_url is reachable and returns HTTP 200 OK for successful delivery.