# eBay Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/ebay/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/ebay-search |

## Description

Extract eBay France product details to enhance market insights, pricing strategy, and inventory management.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/ebay/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "products": [
    {
      "id": "1234567890",
      "link": "https://www.ebay.fr/itm/1234567890",
      "price": "€1,119.00",
      "title": "Apple iPhone 13 Pro Max - 256GB - Graphite (Unlocked)",
      "shipping": "Free",
      "condition": "New"
    },
    {
      "id": "0987654321",
      "link": "https://www.ebay.fr/itm/0987654321",
      "price": "€799.00",
      "title": "Samsung Galaxy S21 5G - 128GB - Phantom Gray (Unlocked)",
      "shipping": "€4.99",
      "condition": "Used"
    },
    {
      "id": "1122334455",
      "link": "https://www.ebay.fr/itm/1122334455",
      "price": "€299.99",
      "title": "Sony WH-1000XM4 Wireless Noise-Canceling Headphones",
      "shipping": "Free",
      "condition": "New"
    },
    {
      "id": "2233445566",
      "link": "https://www.ebay.fr/itm/2233445566",
      "price": "€99.95",
      "title": "Fitbit Charge 4 Fitness and Activity Tracker",
      "shipping": "€5.99",
      "condition": "Refurbished"
    },
    {
      "id": "3344556677",
      "link": "https://www.ebay.fr/itm/3344556677",
      "price": "€1,299.00",
      "title": "Dell XPS 13 Laptop - Intel i7, 16GB RAM, 512GB SSD",
      "shipping": "Free",
      "condition": "New"
    }
  ]
}
```

## Documentation

## Overview
Extract eBay France product details to enhance market insights, pricing strategy, and inventory management.

## Quickstart
```
GET https://api.piloterr.com/v2/ebay/search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate eBay Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Ebay without maintaining scrapers
- Power internal dashboards and workflow automations with live Ebay data