> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# eBay API

> Durchsuchen Sie den Shop eBay als JSON: Rangfolge mit Preisen, Bewertungen und Bewertungsanzahl, in der Reihenfolge des Shops.

Durchsuchen Sie den Shop eBay (ebay.com) über die asynchrone Task-API. Senden Sie `COMMERCE_SERP` mit `site` `ebay`, um die Produkte einer Suche in der Reihenfolge des Shops zu erhalten. `COMMERCE_PRODUCT` liest die Produktseiten dieses Shops nicht. Eine abgeschlossene Suche kostet **0.5 Credits**.

## Suche

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_SERP", "payload": { "site": "ebay", "query": "wireless earbuds", "limit": 3 } }'
```

Senden Sie den Task und fragen Sie dann `GET /v1/async/task/{id}` ab oder empfangen Sie den Webhook. Siehe [Asynchrone Tasks](https://docs.querying.ai/de/concepts/async-tasks.md).

### Parameter

* `site`: Erforderlich. `ebay`.
* `query`: Erforderlich. Suchbegriff mit 1 bis 500 Zeichen.
* `limit`: Optionale Ganzzahl von 1 bis 40, Standard 20.
* `country`: Optional. Standard ist `US`, das Land des Shops. Jedes andere Land wird mit `422 REGION_UNSUPPORTED` abgelehnt.

Nur die oben aufgeführten Payload-Felder werden akzeptiert. Lassen Sie `include` weg: Auch `include: {}` führt vor der Credit-Reservierung zu `422 VALIDATION_ERROR` für `payload.include`.

### Antwortbeispiel

```json theme={"theme":"css-variables"}
{
  "site": "ebay",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 3,
  "products": [
    {
      "rank": 1,
      "productId": "265983500898",
      "title": "Skullcandy SESH ANC Wireless In-ear Bluetooth Earbuds (Certified Refurb)-BLACK",
      "url": "https://www.ebay.com/itm/265983500898",
      "price": 16.14,
      "currency": "USD",
      "rating": 4.5,
      "reviewCount": 76,
      "imageUrl": "https://i.ebayimg.com/images/g/YmgAAOSwdBRjH640/s-l500.jpg"
    },
    {
      "rank": 2,
      "productId": "377628519624",
      "title": "TWS Bluetooth 5.1 Earbuds Wireless Noise Cancelling Waterproof Headset",
      "url": "https://www.ebay.com/itm/377628519624",
      "price": 6.9,
      "currency": "USD",
      "imageUrl": "https://i.ebayimg.com/images/g/8HkAAeSwYV1q7y3W/s-l500.jpg"
    },
    {
      "rank": 3,
      "productId": "366736231992",
      "title": "Apple AirPods Pro 3rd Wireless Active Noise Cancelling Earbuds - White MFHP4LL/A",
      "url": "https://www.ebay.com/itm/366736231992",
      "price": 136.99,
      "currency": "USD",
      "rating": 5,
      "reviewCount": 13,
      "imageUrl": "https://i.ebayimg.com/images/g/19QAAeSw8KJq9UoX/s-l500.jpg"
    }
  ]
}
```

### Ergebnisfelder

* `site`, `query` und `country` geben die Anfrage wieder. `returnedCount` ist die Anzahl der Einträge in `products`.
* Jedes Produkt enthält `rank`, `productId`, `title` und `url`. `productId` ist die eBay-Artikelnummer. `rank` folgt der Standardreihenfolge des Shops, und Einträge, die der Shop als gesponsert kennzeichnet, werden ausgelassen.
* `price`, `rating`, `reviewCount` und `imageUrl` erscheinen, wenn die Ergebnisseite sie zeigt. `price` ist eine Zahl in der `currency` des Produkts (ISO 4217); haben Größen eigene Preise, ist es der niedrigste.
* `rating` nutzt eine Fünf-Punkte-Skala. Abgekürzte Bewertungszahlen wie 999+ werden ausgelassen.
* Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops.

## Fehler und Abrechnung

* Eine Suche ohne Produkte endet als fehlgeschlagener Task.
* Abgerechnet werden nur abgeschlossene Suchen, je 0.5 Credits.

## Siehe auch

* [Amazon](https://docs.querying.ai/de/engines/amazon.md)
* [Walmart](https://docs.querying.ai/de/engines/walmart.md)
* [Target](https://docs.querying.ai/de/engines/target.md)
* [Alle Commerce-Shops](https://docs.querying.ai/de/engines/overview.md#commerce)
* [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.