Etsy Scraper

Description

The Etsy Scraper API allows you to extract detailed product information from Etsy.com. This powerful tool enables developers to integrate Etsy product data into their applications, conduct market research, or monitor pricing and trends across various handmade and vintage categories.

How to Use

To use the Etsy Scraper API, you'll need to authenticate your requests using your API key. The API provides two endpoints for retrieving product information:

Endpoints

• POST https://taskagi.net/api/ecommerce/etsy-scraper/products - Retrieve detailed information about specific Etsy products by URL
• POST https://taskagi.net/api/ecommerce/etsy-scraper/products-by-keyword - Discover products by keyword search

Authentication

Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

Request Body

The request body should be a JSON object with the following structure:

// For products endpoint
{
    "url": "https://www.etsy.com/listing/product-id/product-name"
}

// For products-by-keyword endpoint
{
    "keyword": "search term"
}

Rate Limiting

Please note that usage is subject to rate limiting. Refer to your plan details for specific limits.

Sample Response

Here's an example of the data structure you can expect to receive when using the products endpoint:

{
    "product_id": "123456789",
    "url": "https://www.etsy.com/listing/123456789/product-name",
    "title": "Handmade Product Name",
    "description": "Detailed description of the product...",
    "price": {
        "amount": 29.99,
        "currency": "USD"
    },
    "seller": {
        "name": "Etsy Shop Name",
        "id": "seller123",
        "url": "https://www.etsy.com/shop/seller123"
    },
    "category": {
        "name": "Category Name",
        "url": "https://www.etsy.com/c/category-name"
    },
    "images": [
        "https://i.etsystatic.com/image1.jpg",
        "https://i.etsystatic.com/image2.jpg"
    ],
    "tags": ["handmade", "vintage", "custom"],
    "materials": ["wood", "metal", "fabric"],
    "shipping": {
        "price": {
            "amount": 5.99,
            "currency": "USD"
        },
        "destination": "United States"
    },
    "reviews": {
        "average_rating": 4.8,
        "total_reviews": 150
    },
    "variations": [
        {
            "name": "Size",
            "options": ["Small", "Medium", "Large"]
        },
        {
            "name": "Color",
            "options": ["Red", "Blue", "Green"]
        }
    ],
    "created_at": "2023-09-01T12:00:00Z",
    "last_updated": "2023-09-15T14:30:00Z"
}
                            

import requests
import json

# Your API Key
api_key = 'YOUR_API_KEY'

# API Endpoint
url = 'https://taskagi.net/api/ecommerce/etsy-scraper/products'

# Headers
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

# Request Body
data = {
    'url': 'https://www.etsy.com/listing/123456789/product-name'
}

# Send POST request
response = requests.post(url, headers=headers, json=data)

# Check if the request was successful
if response.status_code == 200:
    # Parse the JSON response
    product_data = response.json()
    
    # Print the product information
    print(json.dumps(product_data, indent=2))
else:
    print(f"Error: {response.status_code}")
    print(response.text)