Getting Started
🧭What Is EasyParser?
EasyParser is a flexible and scalable data extraction API designed to turn public e-commerce pages into structured, machine-readable data. It currently focuses on Amazon, enabling you to retrieve detailed product information, search results, offers, and more — all through clean and reliable endpoints.
Regardless of whether you're using the Real-Time API or the Bulk API, all responses are delivered in a standardized JSON format. This ensures consistency and makes it easy to parse, store, or process the returned data in your applications — whether you're handling a single operation or managing thousands of tasks in bulk.
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 — 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 — use one or combine both depending on your data strategy.
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 API for quick tests, or explore Bulk Integration for large-scale data tasks.
⚙️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 Search, 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:
🔐Authentication
All requests require a valid api-key. You can retrieve your API key from your EasyParser Playground after signing up and logging in.
🚀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:
🔐 Get Your API Key
Sign in to EasyParser Playground. Go To The Plan Page.
Copy your API key for authentication.
📤 Send Your First Request
Decide whether to use Real-Time or Bulk API.
Choose the operation (e.g., SEARCH, DETAIL, OFFER, PRODUCT_SEARCH)
📥 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.
📊 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:
After sending a Bulk Service Request, you receive task IDs for each operation from the Bulk Service Response.
Use these IDs to query the Data Service , which returns the parsed results once processing is complete.
In the Data Service Response, you’ll find structured, operation-specific content — ready to be used in:
Analytics dashboards
Large-scale reporting systems
Periodic data collection jobs
Listing creation or enrichment workflows
Data Availability Reminder
The results retrieved via the Data Service are temporarily stored and can be accessed for up to a maximum of 24 hours. However, please note that in some cases, data may be removed earlier due to system operations or storage limits. For this reason, we recommend fetching and storing your results as soon as they become available. Keeping a local copy will help prevent any potential data loss.
Last updated