ScrapeOps Data API in n8n

The Data API provides direct access to structured data from supported websites without needing to handle HTML scraping. Simply provide product identifiers or search queries, and receive clean, structured JSON data instantly.

Full Documentation

For complete Data API documentation, see the Data APIs docs.

---

Overview

Unlike the Proxy and Parser APIs that require fetching and processing HTML, the Data API:

• Returns data in a single request
• Handles all scraping complexity internally
• Provides consistent, structured responses
• Optimizes for speed and reliability

---

Currently Supported APIs

Amazon APIs

1. Amazon Product API - Get product details by ASIN or URL (Full docs)
2. Amazon Product Search API - Search products by keyword or URL (Full docs)

eBay APIs

1. eBay Product API - Get product details by Item ID or URL (Full docs)
2. eBay Search API - Search products by keyword or URL (Full docs)
3. eBay Category API - Get category listings by Category ID or URL (Full docs)
4. eBay Store API - Get store information by Store Name or URL (Full docs)
5. eBay Feedback API - Get user feedback by Username or URL (Full docs)

Walmart APIs

1. Walmart Product API - Get product details by Product ID or URL (Full docs)
2. Walmart Product Search API - Search products by keyword or URL (Full docs)
3. Walmart Category API - Get category listings by Category ID or URL (Full docs)
4. Walmart Review API - Get product reviews by Product ID or URL (Full docs)
5. Walmart Shop API - Get shop information by Shop ID or URL (Full docs)
6. Walmart Browse API - Get browse page data by Browse Path or URL (Full docs)

More Data APIs coming soon!

---

Amazon Product API

Configuration

To get Amazon product data:

1. Select Data API as the API type
2. Choose Amazon as the domain
3. Select Product API as the Amazon API type
4. Choose input type: ASIN or URL

---

Using ASIN Input

API Type: Data API
Domain: Amazon
Amazon API Type: Product API
Input Type: ASIN
ASIN: B08N5WRWNW

---

Using URL Input

API Type: Data API
Domain: Amazon  
Amazon API Type: Product API
Input Type: URL
Product URL: https://www.amazon.com/dp/B08N5WRWNW

---

Response Structure

{
  "status": "valid",
  "url": "https://www.amazon.com/dp/B08N5WRWNW",
  "data": {
    "title": "Echo Dot (4th Gen) | Smart speaker with Alexa",
    "price": 49.99,
    "rating": 4.7,
    "review_count": 525841,
    "brand": "Amazon",
    "description": "Meet the all-new Echo Dot...",
    "features": [
      "Our most popular smart speaker",
      "Voice control your entertainment"
    ],
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "product_information": {
      "ASIN": "B08N5WRWNW",
      "Best Sellers Rank": "#1 in Smart Speakers",
      "Date First Available": "September 24, 2020"
    },
    "technical_details": {
      "Brand": "Amazon",
      "Model": "Echo Dot (4th Gen)",
      "Color": "Charcoal"
    }
  }
}

---

Amazon Product Search API

Configuration

To search Amazon products:

1. Select Data API as the API type
2. Choose Amazon as the domain
3. Select Product Search API as the Amazon API type
4. Choose input type: Query or URL

---

Using Query Input

API Type: Data API
Domain: Amazon
Amazon API Type: Product Search API
Input Type: Query
Search Query: wireless headphones

---

Using URL Input

API Type: Data API
Domain: Amazon
Amazon API Type: Product Search API
Input Type: URL
Search URL: https://www.amazon.com/s?k=wireless+headphones

---

Response Structure

{
  "status": "valid",
  "url": "https://www.amazon.com/s?k=wireless+headphones",
  "data": {
    "products": [
      {
        "asin": "B08N5WRWNW",
        "title": "Sony WH-1000XM4 Wireless Headphones",
        "price": 348.00,
        "original_price": 399.99,
        "rating": 4.4,
        "review_count": 29821,
        "image_url": "https://m.media-amazon.com/images/I/...",
        "url": "https://www.amazon.com/dp/B08N5WRWNW",
        "is_prime": true,
        "is_best_seller": true
      },
      // More products...
    ],
    "total_results": 50000,
    "pagination": {
      "current_page": 1,
      "total_pages": 20
    }
  }
}

---

Amazon API Options

Both Amazon APIs support additional options:

---

Country Parameter

Specify the Amazon marketplace:

Amazon API Options:
  - Country: us

Available countries:

• us - United States
• uk - United Kingdom
• ca - Canada
• de - Germany
• fr - France
• it - Italy
• es - Spain
• jp - Japan
• And more...

---

TLD (Top Level Domain) Parameter

Alternatively, specify the exact Amazon domain:

Amazon API Options:
  - TLD: co.uk

Available TLDs:

• com - Amazon.com
• co.uk - Amazon.co.uk
• ca - Amazon.ca
• de - Amazon.de
• fr - Amazon.fr
• co.jp - Amazon.co.jp
• And more...

---

eBay Product API

Configuration

To get eBay product data:

1. Select Data API as the API type
2. Choose eBay as the domain
3. Select Product API as the eBay API type
4. Choose input type: Item ID or URL

---

Using Item ID Input

API Type: Data API
Domain: eBay
eBay API Type: Product API
Input Type: Item ID
Item ID: 123456789

---

Using URL Input

API Type: Data API
Domain: eBay
eBay API Type: Product API
Input Type: URL
Product URL: https://www.ebay.com/itm/127458377630

---

Response Structure

{
  "status": "valid",
  "url": "https://www.ebay.com/itm/127458377630",
  "data": {
    "title": "Apple iPhone 13 Pro Max 128GB",
    "price": 999.99,
    "original_price": 1099.99,
    "condition": "New",
    "seller": {
      "username": "seller123",
      "rating": 4.8,
      "feedback_count": 1250
    },
    "shipping": {
      "cost": 0.00,
      "method": "Free shipping"
    },
    "images": [
      "https://i.ebayimg.com/images/g/..."
    ],
    "description": "Brand new iPhone 13 Pro Max...",
    "specifications": {
      "Storage": "128GB",
      "Color": "Graphite",
      "Network": "Unlocked"
    },
    "item_id": "127458377630",
    "listing_type": "Buy It Now",
    "quantity_available": 5
  }
}

---

eBay Search API

Configuration

To search eBay products:

1. Select Data API as the API type
2. Choose eBay as the domain
3. Select Search API as the eBay API type
4. Choose input type: Query or URL

---

Using Query Input

API Type: Data API
Domain: eBay
eBay API Type: Search API
Input Type: Query
Search Query: laptop

---

Using URL Input

API Type: Data API
Domain: eBay
eBay API Type: Search API
Input Type: URL
Search URL: https://www.ebay.com/sch/i.html?_nkw=laptop

---

Response Structure

{
  "status": "valid",
  "url": "https://www.ebay.com/sch/i.html?_nkw=laptop",
  "data": {
    "products": [
      {
        "item_id": "123456789",
        "title": "Dell XPS 13 Laptop",
        "price": 899.99,
        "original_price": 1099.99,
        "condition": "New",
        "seller": {
          "username": "seller123",
          "rating": 4.9
        },
        "shipping": {
          "cost": 0.00,
          "method": "Free shipping"
        },
        "image_url": "https://i.ebayimg.com/images/g/...",
        "url": "https://www.ebay.com/itm/123456789",
        "listing_type": "Buy It Now",
        "watchers": 15
      },
      // More products...
    ],
    "total_results": 50000,
    "pagination": {
      "current_page": 1,
      "total_pages": 500
    }
  }
}

---

Other eBay APIs

eBay Category API

Browse products by category:

API Type: Data API
Domain: eBay
eBay API Type: Category API
Input Type: Category ID or URL

See full documentation for details.

---

eBay Store API

Get store information and listings:

API Type: Data API
Domain: eBay
eBay API Type: Store API
Input Type: Store Name or URL

See full documentation for details.

---

eBay Feedback API

Get user feedback and ratings:

API Type: Data API
Domain: eBay
eBay API Type: Feedback API
Input Type: Username or URL

See full documentation for details.

---

eBay API Options

All eBay APIs support additional options:

---

Country Parameter

Specify the eBay marketplace:

eBay API Options:
  - Country: us

Available countries:

• us - United States
• uk - United Kingdom
• ca - Canada
• de - Germany
• fr - France
• it - Italy
• es - Spain
• au - Australia
• And more...

---

TLD (Top Level Domain) Parameter

Alternatively, specify the exact eBay domain:

eBay API Options:
  - TLD: co.uk

Available TLDs:

• com - eBay.com
• co.uk - eBay.co.uk
• ca - eBay.ca
• de - eBay.de
• fr - eBay.fr
• com.au - eBay.com.au
• And more...

---

Walmart Product API

Configuration

To get Walmart product data:

1. Select Data API as the API type
2. Choose Walmart as the domain
3. Select Product API as the Walmart API type
4. Choose input type: Product ID or URL

---

Using Product ID Input

API Type: Data API
Domain: Walmart
Walmart API Type: Product API
Input Type: Product ID
Product ID: 405234096

---

Using URL Input

API Type: Data API
Domain: Walmart
Walmart API Type: Product API
Input Type: URL
Product URL: https://www.walmart.com/ip/405234096

---

Response Structure

{
  "status": "valid",
  "url": "https://www.walmart.com/ip/405234096",
  "data": {
    "title": "Apple Watch Series 9 GPS 45mm",
    "price": 399.00,
    "previous_price": 429.00,
    "in_stock": true,
    "seller": "Walmart",
    "rating": 4.7,
    "review_count": 1824,
    "images": [
      "https://i5.walmartimages.com/asr/..."
    ],
    "product_id": "405234096",
    "upc": "194253651978",
    "department": "Electronics",
    "shipping": {
      "method": "Free shipping",
      "estimated_delivery": "2025-01-12"
    }
  }
}

---

Walmart Product Search API

Configuration

To search Walmart products:

1. Select Data API as the API type
2. Choose Walmart as the domain
3. Select Product Search API as the Walmart API type
4. Choose input type: Query or URL

---

Using Query Input

API Type: Data API
Domain: Walmart
Walmart API Type: Product Search API
Input Type: Query
Search Query: wireless headphones

---

Using URL Input

API Type: Data API
Domain: Walmart
Walmart API Type: Product Search API
Input Type: URL
Search URL: https://www.walmart.com/search?q=wireless+headphones

---

Response Structure

{
  "status": "valid",
  "url": "https://www.walmart.com/search?q=wireless+headphones",
  "data": {
    "products": [
      {
        "product_id": "123456789",
        "title": "Sony WH-1000XM5 Wireless Noise-Canceling Headphones",
        "price": 398.00,
        "previous_price": 449.99,
        "rating": 4.8,
        "review_count": 945,
        "seller": "Sony",
        "in_stock": true,
        "image_url": "https://i5.walmartimages.com/asr/...",
        "url": "https://www.walmart.com/ip/123456789",
        "shipping": "Free 2-day shipping"
      }
      // More products...
    ],
    "total_results": 2150,
    "pagination": {
      "current_page": 1,
      "total_pages": 20
    }
  }
}

---

Walmart Category API

Configuration

To get Walmart category data:

1. Select Data API as the API type
2. Choose Walmart as the domain
3. Select Category API as the Walmart API type
4. Choose input type: Category ID or URL

---

Using Category ID Input

API Type: Data API
Domain: Walmart
Walmart API Type: Category API
Input Type: Category ID
Category ID: 1007039

---

Using URL Input

API Type: Data API
Domain: Walmart
Walmart API Type: Category API
Input Type: URL
Category URL: https://www.walmart.com/browse/electronics/3944

---

See full documentation for details.

---

Walmart Review API

Configuration

To get Walmart product reviews:

1. Select Data API as the API type
2. Choose Walmart as the domain
3. Select Review API as the Walmart API type
4. Choose input type: Product ID or URL

---

Using Product ID Input

API Type: Data API
Domain: Walmart
Walmart API Type: Review API
Input Type: Product ID
Product ID: 1833409885

---

Using URL Input

API Type: Data API
Domain: Walmart
Walmart API Type: Review API
Input Type: URL
Product URL: https://www.walmart.com/ip/405234096

---

See full documentation for details.

---

Walmart Shop API

Configuration

To get Walmart shop data:

1. Select Data API as the API type
2. Choose Walmart as the domain
3. Select Shop API as the Walmart API type
4. Choose input type: Shop ID or URL

---

Using Shop ID Input

API Type: Data API
Domain: Walmart
Walmart API Type: Shop API
Input Type: Shop ID
Shop ID: 10027886

---

Using URL Input

API Type: Data API
Domain: Walmart
Walmart API Type: Shop API
Input Type: URL
Shop URL: https://www.walmart.com/brand/example-shop

---

See full documentation for details.

---

Walmart Browse API

Configuration

To get Walmart browse page data:

1. Select Data API as the API type
2. Choose Walmart as the domain
3. Select Browse API as the Walmart API type
4. Choose input type: Browse Path or URL

---

Using Browse Path Input

API Type: Data API
Domain: Walmart
Walmart API Type: Browse API
Input Type: Browse Path
Browse Path: 3944_1060825_447913

---

Using URL Input

API Type: Data API
Domain: Walmart
Walmart API Type: Browse API
Input Type: URL
Browse URL: https://www.walmart.com/browse/electronics/3944_1060825_447913

---

See full documentation for details.

---

Walmart API Options

All Walmart APIs support additional options:

---

Country Parameter

Specify the Walmart marketplace:

Walmart API Options:
  - Country: us

Available countries:

• us - United States
• ca - Canada
• mx - Mexico

---

TLD (Top Level Domain) Parameter

Alternatively, specify the exact Walmart domain:

Walmart API Options:
  - TLD: com

Available TLDs:

• com - Walmart.com (United States)
• ca - Walmart.ca (Canada)
• com.mx - Walmart.com.mx (Mexico)

---

Workflow Examples

Price Tracking Workflow

Monitor product prices across different Amazon marketplaces:

1. [Schedule Trigger] - Run daily
2. [Set Node] - Define ASINs to track
3. [Loop] - For each ASIN:
   - [ScrapeOps Data API] - Get US price
   - [ScrapeOps Data API] - Get UK price
   - [Compare Prices]
4. [Google Sheets] - Update price history
5. [IF Node] - Check for price drops
6. [Email] - Send price alerts

---

Product Research Workflow

Search and analyze products:

1. [Manual Trigger] - Start with keywords
2. [ScrapeOps Data API] - Search products
3. [Filter Products] - Rating > 4.0
4. [Loop] - For each product:
   - [ScrapeOps Data API] - Get full details
   - [Calculate Metrics]
5. [Aggregate Results]
6. [Export to CSV]

---

Inventory Monitoring

Track product availability:

1. [Schedule Trigger] - Every hour
2. [Database] - Get products to monitor
3. [ScrapeOps Data API] - Check availability
4. [Compare] - Previous vs current status
5. [Slack] - Alert on status changes
6. [Update Database] - Save new status

---

Best Practices

1. Use Appropriate Input Types

ASIN is preferred when you have it:

• More reliable
• Faster processing
• Direct product access

URL for flexibility:

• Works with any Amazon product URL
• Handles URL variations
• Extracts ASIN automatically

For eBay:

• Item ID is preferred when you have it - more reliable, faster processing, direct product access
• URL for flexibility - works with any eBay product URL, handles URL variations

For Walmart:

• Product ID is preferred when you have it - more reliable, faster processing, direct product access
• URL for flexibility - works with any Walmart product URL, handles URL variations

---

2. Handle Response Data

Always check for valid responses:

// Check if request succeeded
{{ $json.status === 'valid' }}

// Safely access nested data
{{ $json.data?.price || 'Price not available' }}

// Handle missing products
{{ $json.data?.products?.length > 0 }}

---

3. Optimize API Calls

• Cache responses when appropriate
• Batch similar requests
• Use webhooks for real-time needs
• Implement exponential backoff for retries

---

4. Regional Considerations

Different regions may have:

• Different product availability
• Varying prices and currencies
• Region-specific features
• Unique product identifiers

---

Error Handling

Common Errors and Solutions

Error	Cause	Solution
Invalid ASIN	ASIN doesn't exist	Verify ASIN format (10 chars)
Invalid Item ID	Item ID doesn't exist	Verify Item ID format
Invalid Product ID	Product ID doesn't exist	Verify Product ID format
Product Not Found	Product unavailable	Check region/marketplace
Invalid URL	Malformed URL	Encode URL properly
Rate Limited	Too many requests	Implement delays

---

Error Response Example

{
  "status": "error",
  "message": "Product not found",
  "error_code": "PRODUCT_NOT_FOUND",
  "details": "ASIN B123456789 not found in US marketplace"
}

Or for eBay:

{
  "status": "error",
  "message": "Item not found",
  "error_code": "ITEM_NOT_FOUND",
  "details": "Item ID 123456789 not found in US marketplace"
}

Or for Walmart:

{
  "status": "error",
  "message": "Product not found",
  "error_code": "PRODUCT_ID_NOT_FOUND",
  "details": "Product ID 405234096 not found in US marketplace"
}

---

Advanced Integration Patterns

Multi-Region Price Comparison

// Define regions to check
const regions = ['us', 'uk', 'de', 'fr'];
const asin = 'B08N5WRWNW';

// Loop through regions
for (const region of regions) {
  // Configure Data API with region
  // Compare prices
  // Find best deal
}

---

Dynamic Product Monitoring

// Get search terms from database
const searchTerms = $node["Database"].json;

// Search each term
for (const term of searchTerms) {
  // Search products
  // Filter by criteria
  // Track new products
  // Alert on matches
}

---

Competitive Analysis

// Get competitor ASINs
const competitorProducts = $node["Competitors"].json;

// Analyze each product
for (const asin of competitorProducts) {
  // Get product details
  // Extract pricing
  // Calculate price position
  // Generate insights
}

---

Debugging Data API Issues

1. Verify Input Parameters

// Log the actual request
console.log({
  asin: $node["ScrapeOps"].parameter.amazonProductAsin,
  itemId: $node["ScrapeOps"].parameter?.ebayProductItemId,
  productId: $node["ScrapeOps"].parameter?.walmartProductId,
  country: $node["ScrapeOps"].parameter?.amazonApiOptions?.country
});

---

2. Check Response Status

// Examine the full response
if ($json.status !== 'valid') {
  console.error('API Error:', $json.message);
}

---

3. Validate Data Completeness

// Ensure expected fields exist (Amazon)
const amazonRequired = ['title', 'price', 'asin'];
const amazonMissing = amazonRequired.filter(
  field => !$json.data[field]
);

// Ensure expected fields exist (eBay)
const ebayRequired = ['title', 'price', 'item_id'];
const ebayMissing = ebayRequired.filter(
  field => !$json.data[field]
);

// Ensure expected fields exist (Walmart)
const walmartRequired = ['title', 'price', 'product_id'];
const walmartMissing = walmartRequired.filter(
  field => !$json.data[field]
);

---

Future Data APIs

Coming soon:

• Google Shopping API - Product comparisons
• Target Data API - Products and inventory
• Best Buy Data API - Electronics focus

---

Next Steps

• See practical examples of complete Data API workflows
• Learn about Proxy API for custom scraping
• Explore Parser API for HTML parsing

Questions? Contact support@scrapeops.io for Data API assistance.