AI‑Ready: Complete Integration Guide for LLMs and AI Agents

Quick Start

Get started with Easyparser in under 5 minutes. Perfect for AI agents, automation tools, and intelligent applications.

AI-First Design: Easyparser is built specifically for AI agents and automation. All endpoints return clean, structured JSON perfect for LLM processing.

1. Get Your API Key

Sign up at app.easyparser.com and get your API key from the dashboard. Every new account includes 100 free credits (100 product results).

2. Make Your First Request

Basic Product Request (cURL)

curl -G "https://realtime.easyparser.com/v1/request" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d platform=AMZ \
  -d operation=DETAIL \
  -d asin=B0FB21526X \
  -d domain=.com \
  -d output=json

3. Process the Response

Structured JSON Response

{
  "asin": "B0FB21526X",
  "title": "Echo Dot (5th Gen, 2022 release) | Smart speaker with Alexa",
  "price": 49.99,
  "currency": "USD",
  "rating": 4.7,
  "reviewCount": 89234,
  "availability": "In Stock",
  "image": "https://m.media-amazon.com/images/I/61SUj2aKoEL._AC_SL1000_.jpg",
  "brand": "Amazon",
  "category": "Electronics > Smart Home > Smart Speakers",
  "features": [
    "Improved audio with deeper bass and clearer vocals",
    "Voice control your smart home devices",
    "Built-in Eero Wi-Fi 6 mesh networking"
  ],
  "result_id": "req_abc123def456"
}

At a Glance

A quick snapshot for teams that want to integrate fast and validate assumptions before deep implementation.

Realtime Endpoint GET /v1/request

Use for single-request, low-latency agent calls.

Bulk Endpoint POST /v1/bulk

Use for large jobs and webhook-based async workflows.

Primary Auth Authorization: Bearer

Recommended for AI tools and production integrations.

Operations Available 9

DETAIL, OFFER, SEARCH, LOOKUP, BSR, seller, logistics, and history operations.

Machine-Readable Specifications

Easyparser provides comprehensive machine-readable specifications for seamless AI integration.

OpenAPI 3.0 Specification

Complete API schema with examples

Download OpenAPI

AI Plugin Manifest

ChatGPT and Claude compatible

Plugin Manifest

AI Info JSON

Structured metadata for AI tools

AI Info

Full Documentation

Comprehensive developer guide

GitBook Docs

Authentication & Security

Easyparser supports multiple authentication methods with Bearer token as the recommended approach for AI applications.

Recommended: Use Authorization: Bearer YOUR_API_KEY for all new integrations. This method is preferred by AI platforms and provides the best security.

Method	Format	Use Case
Bearer Token Recommended	`Authorization: Bearer YOUR_API_KEY`	AI agents, modern applications
API Key Header	`api-key: YOUR_API_KEY`	Legacy compatibility, bulk endpoints
Query Parameter	`?api_key=YOUR_API_KEY`	Simple testing, legacy systems

Core Operations & Endpoints

Easyparser provides a complete operation set for AI processing, agent workflows, and automation pipelines.

Naming note: operation values are case-sensitive and should be sent exactly as shown in each card.

DETAIL

Comprehensive product information including pricing, ratings, availability, and specifications.

Input Parameters:

asin or url
domain (marketplace)

Perfect For:

• Price monitoring
• Product analysis
• Competitive intelligence

View operation docs

OFFER

All seller offers for a product including prices, conditions, and shipping information.

Input Parameters:

asin or url
domain (marketplace)

Perfect For:

• Buy Box analysis
• Seller monitoring
• Price comparison

View operation docs

SEARCH

Keyword-based product search with pagination and filtering capabilities.

Input Parameters:

keyword (search query)
page (pagination)
domain (marketplace)

Perfect For:

• Product discovery
• Market research
• Trend analysis

View operation docs

Extended Operations for AI Workflows

SALES_ANALYSIS_HISTORY

Historical trend and demand signals including purchases, views, price, and rank history.

Input Parameters:

asin or url
history_range (months)
domain (marketplace)

Perfect For:

• Demand forecasting
• Lifecycle trend analysis
• Anomaly detection

View operation docs

PRODUCT_LOOKUP

Resolve UPC/EAN/GTIN and product identifiers into ASIN-linked product entities.

Input Parameters:

identifier
identifier_type (ASIN, UPC, EAN, ISBN, JAN, MINSAN, GTIN)
domain (marketplace)

Perfect For:

• Entity resolution
• Catalog normalization
• Identifier matching

View operation docs

BEST_SELLERS_RANK

Category rank intelligence for momentum tracking and competitive positioning.

Input Parameters:

asin or url
domain (marketplace)

Perfect For:

• Trend scoring
• Category benchmarking
• Opportunity discovery

View operation docs

PACKAGE_DIMENSION

Package and product size/weight data for logistics and fulfillment quality checks.

Input Parameters:

asin or url
domain (marketplace)

Perfect For:

• Shipping-cost estimation
• FBA fee validation
• Logistics QA

View operation docs

SELLER_PROFILE

Seller-level identity and profile details for trust and risk evaluations.

Input Parameters:

seller_id
domain (marketplace)

Perfect For:

• Seller verification
• Risk scoring
• Compliance review

View operation docs

SELLER_PRODUCTS

Full seller assortment extraction for catalog intelligence and share-of-shelf analysis.

Input Parameters:

seller_id
page (pagination)
domain (marketplace)

Perfect For:

• Portfolio mapping
• Competitor assortment analysis
• Share-of-shelf tracking

View operation docs

Endpoint URLs

Realtime API

GET https://realtime.easyparser.com/v1/request Synchronous requests with immediate response

Bulk API

POST https://bulk.easyparser.com/v1/bulk Asynchronous batch processing with webhooks

AI Integration Patterns

Proven patterns and workflows for integrating Easyparser with AI agents, LLMs, and automation platforms.

Pro Tip: Easyparser's structured JSON responses are optimized for LLM processing. No additional parsing or cleaning required.

Product Research Agent

Workflow: Search → Detail → Analysis → Report

Use SEARCH operation to find products by keywords
Extract ASINs from search results
Use DETAIL operation for comprehensive product data
Analyze pricing, ratings, and features with LLM
Generate structured reports or recommendations

Best For: Market research, competitive analysis, product discovery

Price Monitoring Bot

Workflow: Schedule → Monitor → Alert → Action

Set up scheduled DETAIL requests for target products
Compare current prices with historical data
Use AI to detect significant price changes or trends
Generate alerts or automated responses
Optionally trigger business actions (repricing, notifications)

Best For: Dynamic pricing, inventory management, competitive monitoring

Customer Service Assistant

Workflow: Query → Search → Detail → Response

Parse customer questions about products
Use SEARCH to find relevant products
Get detailed information with DETAIL operation
Use LLM to generate helpful, accurate responses
Provide product recommendations and comparisons

Best For: Chatbots, customer support, product recommendations

Bulk Data Processor

Workflow: Collect → Batch → Process → Analyze

Collect large lists of ASINs or search queries
Submit bulk jobs for parallel processing
Receive webhook notifications when complete
Use AI to analyze patterns across large datasets
Generate insights and business intelligence reports

Best For: Market analysis, catalog management, data science

Trend Intelligence Agent

Workflow: Search -> BSR -> Sales History -> Signal

Use SEARCH to gather ranking candidates for a keyword cluster
Enrich each ASIN with BEST_SELLERS_RANK for category momentum context
Pull SALES_ANALYSIS_HISTORY to validate trend durability over time
Score products by momentum + stability and summarize with AI
Send prioritized opportunities to dashboards or alerts

Best For: Trend scouting, opportunity detection, market monitoring

Catalog Normalization Agent

Workflow: Lookup -> Detail -> Package -> Normalize

Resolve mixed identifiers with PRODUCT_LOOKUP
Fetch canonical listing fields through DETAIL
Attach dimensional attributes via PACKAGE_DIMENSION
Normalize entities and deduplicate records with AI validation rules
Publish clean outputs to ERP, PIM, or analytics stores

Best For: Data standardization, catalog QA, feed enrichment

Code Examples & SDKs

Production-ready examples for common agent patterns: direct detail fetch and identifier resolution.

JavaScript/Node.js Example

class EasyparserClient {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://realtime.easyparser.com/v1/request';
    this.headers = { 'Authorization': 'Bearer ' + apiKey };
  }

  async getProductDetails(asin, domain = '.com') {
    const params = new URLSearchParams({
      platform: 'AMZ',
      operation: 'DETAIL',
      asin: asin,
      domain: domain,
      output: 'json'
    });

    const response = await fetch(this.baseUrl + '?' + params, {
      headers: this.headers
    });

    if (!response.ok) {
      throw new Error('Request failed: ' + response.statusText);
    }

    return await response.json();
  }
}

// Usage
const client = new EasyparserClient('your_api_key_here');
const product = await client.getProductDetails('B0FB21526X');
console.log('Product: ' + product.title);
console.log('Price: $' + product.price);

Python PRODUCT_LOOKUP Example (Identifier + Type)

import requests

params = {
  "api_key": "YOUR_API_KEY",
  "platform": "AMZ",
  "operation": "PRODUCT_LOOKUP",
  "identifier": "0012000809941",
  "identifier_type": "EAN",
  "domain": ".com",
  "output": "json"
}

res = requests.get("https://realtime.easyparser.com/v1/request", params=params)
data = res.json()
print(data.get("request_info", {}).get("id"))

AI Platform Integrations

Ready-to-use integrations with popular AI platforms and frameworks.

LangChain

Custom tool for LangChain agents to access Amazon product data.

• Product lookup by ASIN
• Search functionality
• Price monitoring
• Competitive analysis

OpenAI GPT

Function calling integration for GPT models to access product data.

• Function definitions
• Error handling
• Response formatting
• Context optimization

Claude Tools

Anthropic Claude tool integration for Amazon data access.

• Tool schema definitions
• Parameter validation
• Response parsing
• Safety guidelines

Webhooks

Webhook handlers for AI workflow automation and data processing.

• Bulk job completion
• Real-time notifications
• Error handling
• Retry mechanisms

Advanced Features & Performance

Powerful capabilities designed for enterprise AI applications and high-volume automation.

Geo-Targeting

Access data from 20+ Amazon marketplaces with region-specific pricing and availability.

Supported Domains:

.com .de .co.uk .fr .it .es .ca .com.au .com.mx .com.br .nl .se .pl .at .ch .co.jp .in .com.sg .com.tr .sa .ae .com.eg

Bulk Processing

Process up to 5,000 requests in a single asynchronous job with webhook notifications.

Key Benefits:

• 10x faster than sequential requests
• Automatic retry handling
• Webhook notifications
• Cost-effective pricing

Smart Retry Logic

Built-in exponential backoff and intelligent retry mechanisms for maximum reliability.

Features:

• Automatic rate limit handling
• Network error recovery
• Configurable retry policies
• Detailed error reporting

Data Quality

Consistent, clean JSON output with standardized field names and data types.

Quality Guarantees:

• Structured data validation
• Consistent field naming
• Type safety
• Real-time data freshness

Support & Resources

Get help, access resources, and understand the legal framework for using Easyparser in your AI applications.

Technical Support

Get help with integration, troubleshooting, and optimization.

[email protected]

Documentation

Comprehensive guides, tutorials, and API reference.

View Docs

API Playground

Interactive testing interface with real-time response preview.

Open Playground

Legal & Compliance

Terms of Service

Legal terms and conditions for using Easyparser API

Privacy Policy

How we collect, use, and protect your data

Compliance Notice: Easyparser accesses only publicly available web information. We do not support accessing areas behind logins, paywalled content, or bypassing robots.txt, rate limits, or other technical protections. Users are responsible for complying with applicable third-party terms (e.g., Amazon’s terms). “Amazon” and related marks are trademarks of Amazon.com, Inc. and its affiliates; Easyparser is not affiliated with Amazon.

Enterprise Support: Need dedicated support, custom rate limits, or SLA guarantees? Contact our enterprise team for tailored solutions.

Quick Test

Test Your API Key

# Test API connectivity
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://realtime.easyparser.com/v1/request?platform=AMZ&operation=DETAIL&asin=B0FB21526X&domain=.com"

# Expected response: JSON with product details
# If you get 401: Check your API key
# If you get 429: You've hit rate limits

AI‑Ready: Easyparser Integration Guide

Quick Start

1. Get Your API Key

2. Make Your First Request

Basic Product Request (cURL)

3. Process the Response

Structured JSON Response

At a Glance

Machine-Readable Specifications

OpenAPI 3.0 Specification

AI Plugin Manifest

AI Info JSON

Full Documentation

Authentication & Security

Core Operations & Endpoints

DETAIL

Input Parameters:

Perfect For:

OFFER

Input Parameters:

Perfect For:

SEARCH

Input Parameters:

Perfect For:

Extended Operations for AI Workflows

SALES_ANALYSIS_HISTORY

Input Parameters:

Perfect For:

PRODUCT_LOOKUP

Input Parameters:

Perfect For:

BEST_SELLERS_RANK

Input Parameters:

Perfect For:

PACKAGE_DIMENSION

Input Parameters:

Perfect For:

SELLER_PROFILE

Input Parameters:

Perfect For:

SELLER_PRODUCTS

Input Parameters:

Perfect For:

Endpoint URLs

Realtime API

Bulk API

AI Integration Patterns

Product Research Agent

Price Monitoring Bot

Customer Service Assistant

Bulk Data Processor

Trend Intelligence Agent

Catalog Normalization Agent

Code Examples & SDKs

JavaScript/Node.js Example

Python PRODUCT_LOOKUP Example (Identifier + Type)

AI Platform Integrations

LangChain

OpenAI GPT

Claude Tools

Webhooks

Advanced Features & Performance

Geo-Targeting

Supported Domains:

Bulk Processing

Key Benefits:

Smart Retry Logic

Features:

Data Quality

Quality Guarantees:

Support & Resources

Technical Support

Documentation

API Playground

Legal & Compliance

Terms of Service

Privacy Policy

Quick Test

Test Your API Key