eBay API endpoint
Returns the feedback eBay shows for a seller, identified by the required `seller` username. The response has the total feedback count, positive feedback percentage, overall rating summary, detailed seller ratings, and review cards with buyer, comment, rating, period and verified-purchase flag. Page with `page` (default 1) and `per_page` (24, 48 or 72; default 48), using `has_more` and `next_page`.
/ebay/seller/{seller}/feedbackPath parameters:
seller: eBay seller usernameQuery parameters:
page: feedback page number, defaults to 1per_page: review count per page, one of 24, 48, or 72, defaults to 48Returns seller feedback summaries and recent review cards.
| Field | In the sample | Value in the sample |
|---|---|---|
| seller | Has a value | |
| page | Has a value | |
| per_page | Has a value | |
| has_more | Has a value | false |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| seller (path) | string | Yes | eBay seller username | poloblade | |
| page | integer | No | Feedback page number | ||
| per_page | integer | No | Reviews per page Allowed values: 24, 48, 72. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/ebay/seller/poloblade/feedback?page=1&per_page=24" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"seller": "poloblade",
"store_name": "POLOBLADE COLLECTIBLES",
"total_feedback_count": 291071,
"positive_feedback_percent": 99.9,
"page": 1,
"per_page": 48,
"has_more": true,
"next_page": 2,
"overall_rating_summary": {
"positive": 290000,
"neutral": 500,
"negative": 571
},
"detailed_seller_ratings": {
"Item as described": 4.9,
"Shipping speed": 4.8
},
"reviews": [
{
"buyer": "w***n",
"buyer_feedback": 3426,
"period": "Past 6 months",
"rating": "positive",
"comment": "Fast shipping and exactly as described.",
"verified_purchase": true
}
]
}
}Request schema
No body schema
Response schema
#/definitions/ebay.sellerFeedbackResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | ebay.SellerFeedback | No | ||||
| data.description | string | No | Seller's description of their store. | |||
| data.detailed_seller_ratings | object | No | Seller's detailed ratings, mapping each criterion such as `Communication` to its average score. | |||
| data.followers | integer | No | 13000 | Number of eBay users following the seller. | ||
| data.has_more | boolean | No | true | Whether more feedback pages are available. | ||
| data.items_sold | integer | No | 814000 | Number of items the seller has sold. | ||
| data.next_page | integer | No | 2 | Page number to request next. | ||
| data.overall_rating_summary | object | No | Number of feedback entries by rating type, such as `positive`. | |||
| data.page | integer | No | 1 | Feedback page number returned. | ||
| data.per_page | integer | No | 48 | Number of reviews per page. | ||
| data.positive_feedback_percent | number | No | 99.9 | Share of the seller's feedback that is positive, as a percentage. | ||
| data.reviews | array | No | Buyer feedback entries on this page. | |||
| data.reviews[].buyer | string | No | w***n | Buyer's username, partly masked, such as `w***n`. | ||
| data.reviews[].buyer_feedback | integer | No | 3426 | Feedback score of the buyer who left the review. | ||
| data.reviews[].comment | string | No | Feedback comment left by the buyer. | |||
| data.reviews[].period | string | No | Past 6 months | When the feedback was left, as eBay words it, such as `Past 6 months`. | ||
| data.reviews[].rating | string | No | positive | Rating the buyer gave: `positive`, `neutral` or `negative`. | ||
| data.reviews[].verified_purchase | boolean | No | true | Whether eBay marks the feedback as coming from a verified purchase. | ||
| data.seller | string | No | poloblade | eBay username of the seller. | ||
| data.store_name | string | No | POLOBLADE COLLECTIBLES | Name of the seller's eBay store. | ||
| data.store_url | string | No | https://www.ebay.com/str/poloblade | URL of the seller's eBay store. | ||
| data.total_feedback_count | integer | No | 291071 | Total number of feedback entries the seller has received. | ||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/ebay/seller/poloblade/feedback?page=1&per_page=24" \
-H "x-api-key: $CRAWLORA_API_KEY"