Properties
| Name | Type | Description |
|---|---|---|
| request_id | string | ID of this request. Poll it at /v1/jobs/{request_id}. |
| status | string | pending, complete or failed. Always check it, even on HTTP 200. |
| credits | integer | Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed. |
| cached | boolean | True when the result came from the 15-minute cache. |
| poll_url | string | Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL. |
| result | object | |
| error | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/soldgraph-com/json-schema/soldgraph-com-vinted-item-job-schema.json",
"title": "VintedItemJob",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/soldgraph-com-vinted-api-openapi.yml#/components/schemas/VintedItemJob",
"type": "object",
"required": [
"request_id",
"status",
"credits",
"cached"
],
"properties": {
"request_id": {
"type": "string",
"description": "ID of this request. Poll it at /v1/jobs/{request_id}."
},
"status": {
"type": "string",
"description": "pending, complete or failed. Always check it, even on HTTP 200.",
"enum": [
"pending",
"complete",
"failed"
]
},
"credits": {
"type": "integer",
"description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
},
"cached": {
"type": "boolean",
"description": "True when the result came from the 15-minute cache."
},
"poll_url": {
"type": "string",
"description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
},
"result": {
"$ref": "#/$defs/VintedItemPage"
},
"error": {
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"enum": [
"page_mismatch",
"schema",
"network",
"upstream",
"throttled",
"blocked",
"rejected",
"not_found",
"filter_not_supported",
"filter_not_applied",
"location_not_served",
"auth",
"daily_limit",
"deadline_exceeded",
"credential_storage"
],
"description": "Failed job code."
},
"message": {
"type": "string",
"description": "What the code means, in plain words."
}
}
}
},
"$defs": {
"Money": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string",
"description": "ISO 4217 code, like USD."
}
}
},
"VintedItemPage": {
"type": "object",
"required": [
"provider",
"country",
"query",
"page",
"count",
"reported_total",
"next_page",
"collected_at",
"schema_version",
"completeness",
"field_notes",
"data"
],
"properties": {
"provider": {
"type": "string",
"description": "Marketplace ID, like ebay or poshmark."
},
"country": {
"type": "string",
"description": "The country searched: us, or on eBay the country you sent."
},
"query": {
"type": "string",
"description": "The q you sent, with extra spaces removed."
},
"page": {
"type": "integer",
"description": "The page you asked for."
},
"count": {
"type": "integer",
"description": "Rows in result.data on this page."
},
"reported_total": {
"type": "integer",
"description": "Total matches the marketplace reports for the search. It may be rounded or capped."
},
"next_page": {
"type": [
"integer",
"null"
],
"description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
},
"collected_at": {
"type": "string",
"description": "When we collected the page, as an ISO 8601 timestamp."
},
"schema_version": {
"type": "integer",
"description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
},
"completeness": {
"type": "string",
"description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
},
"field_notes": {
"type": "string",
"description": "Plain-text notes on how to read this page's fields."
},
"data": {
"$ref": "#/$defs/VintedItemRow"
}
}
},
"VintedItemRow": {
"type": "object",
"required": [
"id",
"title",
"description",
"link",
"status",
"displayed_price",
"condition",
"brand",
"brand_id",
"size",
"color",
"uploaded_text",
"like_count",
"category",
"photos",
"seller"
],
"properties": {
"id": {
"type": "string",
"description": "Vinted item ID."
},
"title": {
"type": "string",
"description": "The listing's title."
},
"description": {
"type": [
"string",
"null"
],
"description": "Seller description, up to 10,000 characters."
},
"link": {
"type": "string",
"description": "The listing's page on Vinted."
},
"status": {
"type": "string",
"description": "active, reserved or unavailable. unavailable covers sold, hidden and removed items: it is not a verified sale. A deleted listing fails with not_found and costs nothing."
},
"displayed_price": {
"oneOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
],
"description": "Asking price as { amount, currency }, in the currency the seller listed in. That can differ from the site's currency. Before the buyer protection fee and shipping. Null if the page shows no price."
},
"condition": {
"type": [
"string",
"null"
],
"description": "new_with_tags, new_without_tags, very_good, good or satisfactory, as the seller chose."
},
"brand": {
"type": [
"string",
"null"
],
"description": "Brand name."
},
"brand_id": {
"type": [
"integer",
"null"
],
"description": "Vinted brand ID. Use it as brand_id on /v1/vinted/listings."
},
"size": {
"type": [
"string",
"null"
],
"description": "Size as shown. Null for items without sizes."
},
"color": {
"type": [
"string",
"null"
],
"description": "Colours as shown, like Grey, Black."
},
"uploaded_text": {
"type": [
"string",
"null"
],
"description": "When it was listed, in Vinted's own words, like 2 days ago. Vinted shows no exact date."
},
"like_count": {
"type": [
"integer",
"null"
],
"description": "How many members have favourited the listing."
},
"category": {
"type": "object",
"description": "Category id (use it as category_id on /v1/vinted/listings) and path, the category names from the top down."
},
"photos": {
"type": "array",
"items": {
"type": "string"
},
"description": "Photo URLs on Vinted's CDN, in listing order. Signed links that expire."
},
"seller": {
"type": "object",
"description": "Public seller details: name (username), business, review_count and rating out of 5 (null with no reviews)."
}
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/soldgraph-com-vinted-item-job"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.