Getting Started

🧭What Is Easyparser?

Easyparser is a flexible and scalable data extraction API designed to turn public ecommerce pages into structured data. It currently focuses on Amazon to help you retrieve detailed product information, search results, and offers through clean and reliable endpoints.

All responses utilize a standardized JSON format regardless of whether you use the Real Time API or the Bulk API. This ensures consistency allows you to easily parse, store, or process the returned data in your applications for both single operations and massive bulk tasks.

With support for both Real Time and bulk processing, Easyparser is built to handle a wide range of use cases, from one off lookups to high volume data pipelines.

Future support for additional marketplaces is also part of the roadmap.

🔄Real-Time vs. Bulk API: Which One Do You Need?

Real-Time API

The Real Time API is designed for instant responses, making it ideal for on demand requests where you need immediate results. It supports all Easyparser operations, offering flexible and fast access to structured data.

This method is best suited for:

  • Live applications and dashboards

  • Trigger-based workflows

  • Time-sensitive use cases

  • Testing and development environments

You send a request and receive the parsed data instantly, making it perfect when low latency is essential

Bulk API

The Bulk API is designed for processing multiple operations in a single asynchronous job. Instead of getting responses instantly, you receive a callback or later fetch the result using job IDs. This is ideal for:

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

  • Automating large-scale operations like scheduled data collection or monitoring

  • Reducing API overhead and improving throughput for heavy workloads

Whether you need speed or scale, Easyparser offers both options. You can use one or combine both depending on your data strategy.

Feature
Real-Time API
Bulk API

Request Type

Synchronous (instant)

Asynchronous (via callback URL)

Ideal For

Low-volume or instant needs

High-volume or scheduled processing

Response

Immediate (inline)

Delivered via webhook

Not sure which one fits your workflow? Start with Real-Time APIarrow-up-right for quick tests, or explore Bulk Integrationarrow-up-right for large-scale data tasks.

📦 Address Targeting Support

Depending on your subscription plan, Easyparser allows you to define one or more delivery addresses through the Address Creation Pagearrow-up-right available in the Easyparser Web Apparrow-up-right. Each added address is assigned a unique address_id, which you can include in your requests

Why does this matter? When sending a request to Amazon, the specified address acts as a delivery location, helping you receive region specific results such as availability, shipping options, and pricing.

For a full walkthrough on how to add and manage delivery addresses, please refer to the Address Management Guide.

⚙️Supported Operations

All operations supported by Easyparser are compatible with both Real-Time and Bulk API integrations. This ensures flexibility depending on your use case — whether you’re looking for instant results with single-item calls or prefer scalable, asynchronous processing for larger tasks.

Below you’ll find a brief overview of the available operation types. These summaries provide a general understanding of what each operation does. For more in depth details, such as payload structures, implementation tips, and sample responses, you can visit the relevant documentation pages for Detail, Offer, Search, and Product Lookup, Sales Analysis & History along with additional operation types covered in the Operations section.

Fetch detailed information about a single product, such as title, brand, images, price, stock status, and more.

✅ Supports both Realtime and Bulk services ✅ Accepts ASIN or URL as input ✅ Ideal for product analysis and enrichment

Use Realtime for single-item queries; use Bulk for batch product lookups.

Get multiple price offers for a product along with seller info, shipping details, and basic product data (title, rating, etc.).

✅ Available via Realtime and Bulk ✅ Input via ASIN

Use it to analyze competition, seller pricing, or availability on a product.

Find general or category-specific products by entering a keyword or phrase, and view product listings with summarized information.

✅ Works with both Realtime and Bulk ✅ Input via keyword or search URL

Ideal for keyword analysis, market research, or product discovery.

🧪Try It Out Quickly!

You can now test the API using sample requests directly from:

Here is the product we’ll use in this sample request:

Real-Time Integration Request – Sample

Real-Time Integration Response

chevron-rightResponsehashtag

Bulk Integration – Sample

Bulk Service Request

Bulk Service Response

Data Service Request

Data Service Response

chevron-rightResponsehashtag

All requests require a valid api-key. You can retrieve your API key from your Easyparser Playgroundarrow-up-right after signing up and logging in.

Navigate to the "Plan"arrow-up-right section to locate your personal API key.

🚀Ready to Dive In?

You're now equipped with the essentials to start integrating Easyparser into your project. Whether you're building real-time product lookups, automating bulk data collection, or running large-scale monitoring workflows — Easyparser gives you the flexibility and scalability to get the job done.

Integration Flow Overview

Here's a typical workflow to help you understand how to integrate Easyparser into your system efficiently:

1

🔐 Get Your API Key

2

📤 Send Your First Request

  • Decide whether to use Real-Time or Bulk API.

  • Choose the operation (e.g., SEARCH, DETAIL, OFFER, PRODUCT_SEARCH)

3

📥 Receive and Process the Response

  • In Real-Time, you get the response immediately.

  • In Bulk, you’ll receive a callback with the response once processing is complete.

4

📊 Use the Data

For Real Time;

Once you send a request via the Real-Time API, you receive the parsed data instantly in the response. This structure allows you to:

  • Display product details or search results immediately in your application

  • Feed offer and pricing data into pricing intelligence or inventory systems

  • Trigger workflows based on live data (e.g., price drop alerts, product availability checks)

  • Directly integrate parsed results into your UI or backend services

No need to track IDs or query again — the data you need is right there in the initial response.

For Bulk;

Bulk processing follows an asynchronous workflow, where data retrieval is split into stages:

triangle-exclamation

Last updated