BrowsableeBay APIs
eBay Seller Feedback API
Read paginated feedback received as an ebay.com seller, including comments, rating, displayed date, item reference and available seller replies. Supports positive, neutral or negative feedback filters; filtered pages may contain fewer results, so follow next_cursor even when count is zero. Feedback prices are displayed references, not a sold-listings price history.
POST
/v1/ebay/seller-feedbackSend Authorization: Bearer YOUR_API_KEY. Get an API key →
Parameters
Send these fields in a flat JSON body. Add _run to choose execution options.
Provide at least one of: username; url.
urlstringOptionalPublic page URL. Minimum length: 1. Maximum length: 2000. Pattern: ^https://(?:www\.)?ebay\.com/(?:usr|fdbk/feedback_profile)/[a-zA-Z0-9_.-]{1,64}/?(?:[?#].*)?$.
usernamestringOptionalPublic username, without a profile URL. Minimum length: 1. Maximum length: 2000. Pattern: ^[a-zA-Z0-9_.-]{1,64}$.
limitintegerOptionalMaximum results in this response. Default: 25. Minimum: 1. Maximum: 50.
cursorstringOptionalnext_cursor from the previous response. Keep all other inputs unchanged. Expires after 30 minutes. Maximum length: 131072.
ratingstringOptionalFilter by the allowed feedback rating below. Default: "all". Allowed: "all", "positive", "neutral", "negative".
sortstringOptionalSort order. Choose an allowed value below. Default: "recent". Allowed: "recent", "relevant".
Response
Every response describes a run. Read result once run_status is succeeded.
run_id- The run to track. Keep it when contacting support.
run_status- Queued, running, waiting for sign-in, succeeded, or failed. Check this even after an HTTP 200.
status_url- Poll this URL while the run is pending. Keep the same run instead of starting another request.
result- The endpoint’s returned data. The example is illustrative; actual fields may be empty or unavailable.
error- On failure, inspect its code, message, retryable and action fields.
View the complete output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"success",
"source",
"query",
"url",
"results",
"count",
"data",
"max_results_requested",
"pagination"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"data": {
"type": "object",
"required": [
"seller"
],
"properties": {
"seller": {
"type": "object",
"required": [
"username",
"url",
"feedback_score",
"positive_feedback_percent",
"member_since",
"country",
"top_rated",
"feedback_ratings",
"detailed_ratings"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"username": {
"type": [
"string",
"null"
]
},
"top_rated": {
"type": [
"boolean",
"null"
]
},
"member_since": {
"type": [
"string",
"null"
]
},
"feedback_score": {
"type": [
"number",
"null"
]
},
"detailed_ratings": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"rating",
"count"
],
"properties": {
"count": {
"type": [
"number",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
},
"rating": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"feedback_ratings": {
"type": "array",
"items": {
"type": "object",
"required": [
"rating",
"one_month",
"six_months",
"twelve_months"
],
"properties": {
"rating": {
"type": [
"string",
"null"
]
},
"one_month": {
"type": [
"number",
"null"
]
},
"six_months": {
"type": [
"number",
"null"
]
},
"twelve_months": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"positive_feedback_percent": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"count": {
"type": "integer",
"minimum": 0
},
"query": {
"type": [
"string",
"null"
]
},
"source": {
"const": "ebay-seller-feedback"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"rating",
"comment",
"item_id",
"item_title",
"item_url",
"buyer",
"price",
"when",
"verified_purchase",
"automated",
"seller_response"
],
"properties": {
"id": {
"type": "string"
},
"when": {
"type": [
"string",
"null"
]
},
"buyer": {
"type": [
"string",
"null"
]
},
"price": {
"type": [
"string",
"null"
]
},
"rating": {
"enum": [
"positive",
"neutral",
"negative",
null
]
},
"comment": {
"type": [
"string",
"null"
]
},
"item_id": {
"type": [
"string",
"null"
]
},
"item_url": {
"type": [
"string",
"null"
]
},
"automated": {
"type": "boolean"
},
"item_title": {
"type": [
"string",
"null"
]
},
"seller_response": {
"type": [
"string",
"null"
]
},
"verified_purchase": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"success": {
"const": true
},
"pagination": {
"type": "object",
"required": [
"cursor",
"next_cursor",
"has_next_page",
"count",
"strategy"
],
"properties": {
"count": {
"type": "integer"
},
"cursor": {
"type": [
"string",
"null"
]
},
"strategy": {
"type": [
"string",
"null"
]
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"has_next_page": {
"type": "boolean"
}
},
"additionalProperties": false
},
"max_results_requested": {
"type": "integer"
}
},
"additionalProperties": false
}View a polled run response
{
"run_id": "00000000-0000-4000-8000-000000000001",
"task_key": "ebay-seller-feedback",
"task_name": "eBay Seller Feedback API",
"run_status": "succeeded",
"status_url": "/v1/runs/00000000-0000-4000-8000-000000000001",
"result": {
"url": "https://example.com/item-1",
"data": {
"seller": {
"url": "https://example.com/item-1",
"country": "London",
"username": "Stylish Shoreditch Loft with Balcony",
"top_rated": true,
"member_since": "sample",
"feedback_score": 1.5,
"detailed_ratings": [
{
"count": 1,
"label": "Stylish Shoreditch Loft with Balcony",
"rating": 4.91
}
],
"feedback_ratings": [
{
"rating": "sample",
"one_month": 1.5,
"six_months": 1.5,
"twelve_months": 1.5
}
],
"positive_feedback_percent": 1.5
}
},
"count": 1,
"query": "London",
"source": "ebay-seller-feedback",
"results": [
{
"id": "id-1",
"when": "sample",
"buyer": "sample",
"price": "180",
"rating": "positive",
"comment": "sample",
"item_id": "id-1",
"item_url": "https://example.com/item-1",
"automated": true,
"item_title": "Stylish Shoreditch Loft with Balcony",
"seller_response": "sample",
"verified_purchase": true
}
],
"success": true,
"pagination": {
"count": 1,
"cursor": "cursor-page-1",
"strategy": "sample",
"next_cursor": "cursor-page-1",
"has_next_page": true
},
"max_results_requested": 1
},
"error": null
}Errors & retries
400Fix the fields listed inerrorsbefore retrying.428Connect the requested website account using the returned sign-in link.429Wait for the duration inRetry-After.5xxRetry transient failures with backoff. Keep the request ID.
A failed run has its own error inside the response. Retry it only when error.retryable is true.
More examples
Async request with polling
RUN=$(curl -s -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/ebay/seller-feedback" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.ebay.com/usr/example-seller"}')
RUN_ID=$(echo "$RUN" | jq -er '.run_id // empty') || { echo "$RUN" >&2; exit 1; }
POLL_DELAY=3
while true; do
RESULT=$(curl -s -H "Authorization: Bearer YOUR_API_KEY" "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/runs/$RUN_ID")
STATUS=$(echo "$RESULT" | jq -r '.run_status')
if [[ "$STATUS" =~ ^(succeeded|failed|errored|cancelled|canceled|expired)$ ]]; then
echo "$RESULT"
break
fi
sleep "$(awk "BEGIN { print $POLL_DELAY * (0.9 + ($RANDOM % 21) / 100) }")"
POLL_DELAY=$((POLL_DELAY < 30 ? POLL_DELAY * 2 : 30))
[ "$POLL_DELAY" -gt 30 ] && POLL_DELAY=30
doneWait-for-results request
curl -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/ebay/seller-feedback" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.ebay.com/usr/example-seller","_run":{"async":false}}'Canonical & compatibility routes
You can also send the same JSON body to /v1/tasks/ebay-seller-feedback/runs.