# Easyparser Docs

> Easyparser documentation: real-time and bulk Amazon data extraction API across 22 marketplaces.

Full content in one file: https://docs.easyparser.com/llms-full.txt

## Getting Started

- [Getting Started](https://docs.easyparser.com/getting-started.md): Get an Easyparser API key, send your first Real-Time API request and choose between the Real-Time API and the Bulk API.

## Essentials

- [Supported Marketplaces](https://docs.easyparser.com/essentials/supported-marketplaces.md): Amazon marketplaces Easyparser supports, the domain value for each, and the languages, currencies and address options per marketplace.
- [Credit Consumption](https://docs.easyparser.com/essentials/credit-consumption.md): How Easyparser charges credits per request and per operation in the Real-Time API and Bulk API, with pagination, A+ content and sales history costs.
- [Operation Versioning](https://docs.easyparser.com/essentials/operation-versioning.md): How Easyparser versions operation responses, how to select a version with operation_version, and which operations have more than one version.
- [Address Management](https://docs.easyparser.com/essentials/address-management.md): Set a delivery address for Easyparser requests with a saved address_id or inline zip_code, city, district and country_code fields.

## Real-Time API

- [Overview](https://docs.easyparser.com/real-time-integration/overview.md): How the Easyparser Real-Time API works: endpoint, authentication, the shared response envelope, timeouts, rate limits and errors.
- [Common Request Fields](https://docs.easyparser.com/real-time-integration/common-required-request-fields.md): Parameters shared by every Easyparser Real-Time API request: required fields, operation identifiers, shared options, pagination and formatting rules.
- [Detail](https://docs.easyparser.com/real-time-integration/detail.md): The Detail operation (DETAIL) returns full Amazon product page data for one ASIN or product URL: price, Buy Box, images, variants, specs and reviews.
- [Detail Request](https://docs.easyparser.com/real-time-integration/detail/request.md): Request parameters for the Easyparser Detail operation (DETAIL): ASIN or URL, A+ content, seller, address, language and currency, with a cURL example.
- [Detail Response](https://docs.easyparser.com/real-time-integration/detail/response.md): Response fields of the Easyparser Detail operation (DETAIL): result.detail with Buy Box, images, variants, specifications, ratings and reviews.
- [Offer](https://docs.easyparser.com/real-time-integration/offer.md): Get every seller offer for an Amazon ASIN with price, condition, delivery, seller details and the Buy Box winner.
- [Offer Request](https://docs.easyparser.com/real-time-integration/offer/request.md): Parameters, credit cost and a cURL example for the Easyparser Offer (OFFER) Real-Time API request.
- [Offer Response](https://docs.easyparser.com/real-time-integration/offer/response.md): Response fields of the Easyparser Offer (OFFER) operation: product summary, seller offers, Buy Box flag and available filters.
- [Sales Analysis and History](https://docs.easyparser.com/real-time-integration/sales-analysis-and-history.md): Get an Amazon product's views, purchases, price, fees, offers, reviews and BSR, plus up to 12 months of weekly history, by ASIN.
- [Sales Analysis and History Request](https://docs.easyparser.com/real-time-integration/sales-analysis-and-history/request.md): Request parameters, credit cost and a cURL example for the Easyparser SALES_ANALYSIS_HISTORY operation.
- [Sales Analysis and History Response](https://docs.easyparser.com/real-time-integration/sales-analysis-and-history/response.md): Response fields and sample JSON for the Easyparser SALES_ANALYSIS_HISTORY operation: product metrics, fees, offers, BSR and weekly history.
- [Best Sellers Rank](https://docs.easyparser.com/real-time-integration/best-sellers-rank.md): Get an Amazon product's Best Sellers Rank in its main category and subcategories with one Real-Time API request by ASIN.
- [Best Sellers Rank Request](https://docs.easyparser.com/real-time-integration/best-sellers-rank/request.md): Request parameters, credit cost and a cURL example for the Easyparser BEST_SELLERS_RANK Real-Time API operation.
- [Best Sellers Rank Response](https://docs.easyparser.com/real-time-integration/best-sellers-rank/response.md): Response fields of the Easyparser BEST_SELLERS_RANK operation for version 2 and legacy version 1, with sample JSON and a migration table.
- [Package Dimension](https://docs.easyparser.com/real-time-integration/package-dimension.md): Get an Amazon product's package and item dimensions, weights, fee category and basic product data by ASIN with the PACKAGE_DIMENSION operation.
- [Package Dimension Request](https://docs.easyparser.com/real-time-integration/package-dimension/request.md): Request parameters, credit cost and an example for the PACKAGE_DIMENSION operation of the Easyparser Real-Time API.
- [Package Dimension Response](https://docs.easyparser.com/real-time-integration/package-dimension/response.md): Response fields and a sample JSON response for the PACKAGE_DIMENSION operation: package and item dimensions, weights and product data.
- [Search](https://docs.easyparser.com/real-time-integration/search.md): Search Amazon by keyword or search URL and get ranked product listings, filters and related searches with the Easyparser Real-Time API.
- [Search Request](https://docs.easyparser.com/real-time-integration/search/request.md): Request parameters, pagination rules, credit cost and a cURL example for the Easyparser SEARCH Real-Time API operation.
- [Search Response](https://docs.easyparser.com/real-time-integration/search/response.md): Response fields of the Easyparser SEARCH operation: ranked search results, prices, refinements, related searches and pagination, with sample JSON.
- [Product Lookup](https://docs.easyparser.com/real-time-integration/product-lookup.md): Map product identifiers to Amazon listings and back with the PRODUCT_LOOKUP operation: UPC, EAN, GTIN, ISBN, JAN, MINSAN or ASIN.
- [Product Lookup Request](https://docs.easyparser.com/real-time-integration/product-lookup/request.md): Request parameters and a cURL example for the Easyparser PRODUCT_LOOKUP operation: identifier_type, identifier and the common fields.
- [Product Lookup Response](https://docs.easyparser.com/real-time-integration/product-lookup/response.md): Response fields of the Easyparser PRODUCT_LOOKUP operation: matching Amazon listings, ASINs, identifiers, brand, manufacturer and images.
- [Seller Profile](https://docs.easyparser.com/real-time-integration/seller-profile.md): Get an Amazon seller's business name, business address, ratings, star distribution and recent feedback with the SELLER_PROFILE operation.
- [Seller Profile Request](https://docs.easyparser.com/real-time-integration/seller-profile/request.md): Request parameters and a cURL example for the Easyparser SELLER_PROFILE operation: seller_id or url, language, associate_id and common fields.
- [Seller Profile Response](https://docs.easyparser.com/real-time-integration/seller-profile/response.md): Response fields of the Easyparser SELLER_PROFILE operation: business identity, ratings, feedback summary by timeframe and recent feedback.
- [Seller Products](https://docs.easyparser.com/real-time-integration/seller-products.md): List the products an Amazon seller offers, with prices, ratings and filters, using the SELLER_PRODUCTS operation of the Easyparser Real-Time API.
- [Seller Products Request](https://docs.easyparser.com/real-time-integration/seller-products/request.md): Request parameters, credit cost and a cURL example for the SELLER_PRODUCTS operation of the Easyparser Real-Time API.
- [Seller Products Response](https://docs.easyparser.com/real-time-integration/seller-products/response.md): Response fields of the Easyparser SELLER_PRODUCTS operation: product listings, prices, refinements, pagination and a sample JSON response.
- [Seller Feedback](https://docs.easyparser.com/real-time-integration/seller-feedback.md): Get an Amazon seller's customer feedback entries, filtered by star rating and time range, with the SELLER_FEEDBACK operation.
- [Seller Feedback Request](https://docs.easyparser.com/real-time-integration/seller-feedback/request.md): Request parameters, credit cost and an example for the SELLER_FEEDBACK operation of the Easyparser Real-Time API.
- [Seller Feedback Response](https://docs.easyparser.com/real-time-integration/seller-feedback/response.md): Response fields and a sample JSON response for the SELLER_FEEDBACK operation: feedback entries, ratings, dates and pagination.
- [Similar Products](https://docs.easyparser.com/real-time-integration/similar-products.md): Get 10, 50 or 100 products similar to an Amazon ASIN, with brand, category path, image and title, using the SIMILAR_PRODUCTS operation.
- [Similar Products Request](https://docs.easyparser.com/real-time-integration/similar-products/request.md): Request parameters, credit cost and an example for the SIMILAR_PRODUCTS operation of the Easyparser Real-Time API.
- [Similar Products Response](https://docs.easyparser.com/real-time-integration/similar-products/response.md): Response fields and a sample JSON response for the SIMILAR_PRODUCTS operation: the source product and its list of similar products.

## Bulk API

- [Overview](https://docs.easyparser.com/bulk-integration/overview.md): How the Easyparser Bulk API works: submit batch jobs, receive webhooks, verify signatures and fetch results from the Data Service.
- [Bulk Service Request](https://docs.easyparser.com/bulk-integration/bulk-service-request.md): Create a Bulk API job with one POST request: endpoint, headers, request body, payload keys per operation, examples and limits.
- [Bulk Service Response](https://docs.easyparser.com/bulk-integration/bulk-service-response.md): The Bulk API submit response: accepted and rejected items, result IDs, batch counts, outcome arrays, sample responses and errors.
- [Data Service Request](https://docs.easyparser.com/bulk-integration/data-service-request.md): Retrieve the parsed result of a bulk query from the Easyparser Data Service with a GET request and your query ID.
- [Data Service Response](https://docs.easyparser.com/bulk-integration/data-service-response.md): Fields, status values, samples and errors of the query record that the Easyparser Data Service returns for a bulk query.

## Account

- [Account API](https://docs.easyparser.com/account/account-api.md): Get your Easyparser plan, credit balance, per-minute credit limits, address quota and daily usage history with one GET request.

## Integrations

- [MCP Server](https://docs.easyparser.com/integrations/mcp-server.md): Connect Claude, Cursor, VS Code, Manus or any MCP client to Easyparser Amazon data through the hosted MCP server or a local npx server.
- [n8n](https://docs.easyparser.com/integrations/n8n.md): Use Easyparser Amazon data in n8n workflows with the verified Easyparser node or the HTTP Request node, including credentials, a scheduled price check and Bulk API webhooks.