BrowsableVinted APIs
Vinted item
Fetch a Vinted item page and return normalized item details plus similar items from the same page.
POST
/v1/vinted/itemSend Authorization: Bearer YOUR_API_KEY. Get an API key →
Parameters
Send these fields in a flat JSON body. Add _run to choose execution options.
urlstringOptionalVinted item URL (e.g. https://www.vinted.co.uk/items/8289132552-foo). Preferred name; item_url remains supported.
domainstringOptionalOptional Vinted domain/origin (e.g. vinted.de, www.vinted.fr, or https://www.vinted.co.uk). Used when item_id is provided or to override the default UK domain. Default: "vinted.co.uk".
item_idstringOptionalNumeric Vinted item ID. When used without item_url, the scraper defaults to vinted.co.uk unless domain is provided.
Advanced & compatibility inputs 1
item_urlstringOptionalVinted item URL (e.g. https://www.vinted.co.uk/items/8289132552-foo). You can also use url.
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",
"item_id",
"item_url",
"price",
"price_including_buyer_protection",
"service_fee",
"shipping_price",
"image_urls",
"attributes",
"similar_items"
],
"properties": {
"size": {
"type": "string"
},
"brand": {
"type": "string"
},
"color": {
"type": "string"
},
"likes": {
"type": "number"
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"amount_numeric",
"currency"
],
"properties": {
"amount": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount_numeric": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"views": {
"type": "number"
},
"seller": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"avatar_url": {
"type": "string"
},
"is_business": {
"type": "boolean"
},
"profile_url": {
"type": "string"
},
"feedback_count": {
"type": "number"
},
"feedback_reputation": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"is_sold": {
"type": "boolean"
},
"item_id": {
"type": "string"
},
"success": {
"type": "boolean"
},
"item_url": {
"type": "string"
},
"location": {
"type": "string"
},
"material": {
"type": "string"
},
"promoted": {
"type": "boolean"
},
"condition": {
"type": "string"
},
"is_hidden": {
"type": "boolean"
},
"attributes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string"
},
"value": {
"type": "string"
}
},
"additionalProperties": false
}
},
"catalog_id": {
"type": "string"
},
"created_at": {
"type": "string"
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"updated_at": {
"type": "string"
},
"description": {
"type": "string"
},
"is_reserved": {
"type": "boolean"
},
"service_fee": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"amount_numeric",
"currency"
],
"properties": {
"amount": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount_numeric": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"is_favourite": {
"type": "boolean"
},
"similar_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"page",
"link",
"image_urls",
"price",
"price_including_buyer_protection",
"service_fee"
],
"properties": {
"id": {
"type": "string"
},
"link": {
"type": "string"
},
"name": {
"type": "string"
},
"page": {
"type": "number"
},
"size": {
"type": "string"
},
"brand": {
"type": "string"
},
"color": {
"type": "string"
},
"likes": {
"type": "number"
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"amount_numeric",
"currency"
],
"properties": {
"amount": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount_numeric": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"views": {
"type": "number"
},
"seller": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"avatar_url": {
"type": "string"
},
"is_business": {
"type": "boolean"
},
"profile_url": {
"type": "string"
},
"feedback_count": {
"type": "number"
},
"feedback_reputation": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"location": {
"type": "string"
},
"material": {
"type": "string"
},
"promoted": {
"type": "boolean"
},
"condition": {
"type": "string"
},
"catalog_id": {
"type": "string"
},
"created_at": {
"type": "string"
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
},
"service_fee": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"amount_numeric",
"currency"
],
"properties": {
"amount": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount_numeric": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"is_favourite": {
"type": "boolean"
},
"thumbnail_url": {
"type": "string"
},
"price_including_buyer_protection": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"amount_numeric",
"currency"
],
"properties": {
"amount": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount_numeric": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"thumbnail_url": {
"type": "string"
},
"shipping_price": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"amount_numeric",
"currency"
],
"properties": {
"amount": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount_numeric": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"price_including_buyer_protection": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"amount_numeric",
"currency"
],
"properties": {
"amount": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount_numeric": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": true
}View a polled run response
{
"run_id": "00000000-0000-4000-8000-000000000001",
"task_key": "vinted-item",
"task_name": "Vinted item",
"run_status": "succeeded",
"status_url": "/v1/runs/00000000-0000-4000-8000-000000000001",
"result": {
"size": "sample",
"brand": "sample",
"color": "sample",
"likes": 1.5,
"price": {
"amount": "180",
"currency": "USD",
"amount_numeric": 180
},
"title": "Stylish Shoreditch Loft with Balcony",
"views": 1.5,
"seller": {
"id": "id-1",
"username": "Stylish Shoreditch Loft with Balcony",
"avatar_url": "https://images.example.com/avatar_url-1.jpg",
"is_business": true,
"profile_url": "https://example.com/item-1",
"feedback_count": 1,
"feedback_reputation": 1.5
},
"is_sold": true,
"item_id": "id-1",
"success": true,
"item_url": "https://example.com/item-1",
"location": "London",
"material": "sample",
"promoted": true,
"condition": "sample",
"is_hidden": true,
"attributes": [
{
"code": "sample",
"label": "Stylish Shoreditch Loft with Balcony",
"value": "180"
}
],
"catalog_id": "id-1",
"created_at": "2026-06-14T15:30:00Z",
"image_urls": [
"https://images.example.com/image_urls-1.jpg"
],
"updated_at": "2026-06-14T15:30:00Z",
"description": "Sample description 1",
"is_reserved": true,
"service_fee": {
"amount": "180",
"currency": "USD",
"amount_numeric": 180
},
"is_favourite": true,
"similar_items": [
{
"id": "id-1",
"link": "https://example.com/item-1",
"name": "Stylish Shoreditch Loft with Balcony",
"page": 1,
"size": "sample",
"brand": "sample",
"color": "sample",
"likes": 1.5,
"price": {
"amount": "180",
"currency": "USD",
"amount_numeric": 180
},
"views": 1.5,
"seller": {
"id": "id-1",
"username": "Stylish Shoreditch Loft with Balcony",
"avatar_url": "https://images.example.com/avatar_url-1.jpg",
"is_business": true,
"profile_url": "https://example.com/item-1",
"feedback_count": 1,
"feedback_reputation": 1.5
},
"location": "London",
"material": "sample",
"promoted": true,
"condition": "sample",
"catalog_id": "id-1",
"created_at": "2026-06-14T15:30:00Z",
"image_urls": [
"https://images.example.com/image_urls-1.jpg"
],
"description": "Sample description 1",
"service_fee": {
"amount": "180",
"currency": "USD",
"amount_numeric": 180
},
"is_favourite": true,
"thumbnail_url": "https://images.example.com/thumbnail_url-1.jpg",
"price_including_buyer_protection": {
"amount": "180",
"currency": "USD",
"amount_numeric": 180
}
}
],
"thumbnail_url": "https://images.example.com/thumbnail_url-1.jpg",
"shipping_price": {
"amount": "180",
"currency": "USD",
"amount_numeric": 180
},
"price_including_buyer_protection": {
"amount": "180",
"currency": "USD",
"amount_numeric": 180
}
},
"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/vinted/item" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}')
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/vinted/item" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"_run":{"async":false}}'Canonical & compatibility routes
You can also send the same JSON body to /v1/tasks/vinted-item/runs.