# eBay Seller Feedback

Feedback received by an eBay member, newest first, with page pagination (25 to 200 per page), filters for role, period, rating and automated feedback, the total count and the four detailed seller ratings. Each feedback has its id, rating, masked buyer, buyer score, relative time text (eBay gives only text such as Past month), comment, image count, verified-purchase flag and the item (id, link, title, price). The rating filter needs a period other than all, otherwise the request is rejected with 422. A page past the last returns an empty page with has_next false. Costs 1 credit. Typical latency 1 to 3 seconds.

- **Documentation:** [https://scrappa.co/docs/ebay-api/ebay_seller_feedback](https://scrappa.co/docs/ebay-api/ebay_seller_feedback)
- **API group:** eBay API
- **Endpoint:** `GET https://scrappa.co/api/ebay/seller/feedback`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `username` | string | Yes | eBay seller username, e.g. dell. |
| `page` | integer | No | Result page, 1-based. Default: 1. |
| `per_page` | integer | No | Feedback per page. Allowed: 25, 50, 100, 200. Default: 25. |
| `role` | string | No | received_as_seller (default), received_as_buyer, left_for_others or all. |
| `period` | string | No | all (default), one_month, six_months or twelve_months. |
| `rating` | string | No | positive, neutral or negative. Needs a period other than all. |
| `include_automated` | boolean | No | Include eBay automated feedback. Default: true. |
| `sort` | string | No | recent (default) or relevant. |
| `site` | string | No | eBay marketplace: com, co.uk, de or com.au. Default: com. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/ebay/seller/feedback?username=dell&page=1&per_page=25"
```

## Example response

```json
{
    "success": true,
    "data": {
        "username": "dell",
        "site": "com",
        "page": 1,
        "per_page": 25,
        "total_feedback": 35040,
        "has_next": true,
        "feedback": [
            {
                "id": "3105134264021",
                "rating": "positive",
                "buyer": "u***5",
                "buyer_feedback_score": 704,
                "automated": false,
                "time_text": "Past month",
                "comment": "First Rate !!!",
                "image_count": 0,
                "verified_purchase": true,
                "item": {
                    "id": "227553266695",
                    "title": "Dell S 27 4K USB-C Monitor - S2725QC",
                    "url": "https://www.ebay.com/itm/227553266695",
                    "price": {
                        "raw": "US $329.99",
                        "extracted": 329.99,
                        "currency": "USD"
                    }
                }
            }
        ]
    },
    "meta": {
        "endpoint_family": "seller_feedback"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | eBay has no result for this request. This response is not billable. |  |
|  | A public parameter is invalid. This response is not billable. |  |
|  | eBay did not return usable data for this request. This response is not billable. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)