soldgraph-com · Schema

VintedItemJob

CompanyResaleMarketplacePricingData

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
View JSON Schema on GitHub

JSON Schema

soldgraph-com-vinted-item-job-schema.json Raw ↑
{
  "$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.
All 92 tools →

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.