GET/v1/results

Get Results

Retrieve scraped Vinted product listings with pricing and seller information

Retrieve scraped product listings from Vinted including product details, pricing breakdown, and seller information.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes

Product Information

integer

Unique result identifier

Example: 2220866

object

string

Always "result"

Example: result

squid

string

Squid that produced this result

Example: 2eea95bc41594fb5898e86e671e4bb3f

run

string

Run that produced this result

Example: c52de994a19544de9c729b2e4b428255

title

string

Product title/headline

Example: Nike Air Max 90 - Size 42

description

stringnull

Product description if provided

Example: Great condition, worn only a few times

brand_title

stringnull

Brand name of the item

Example: Nike

size_title

stringnull

Size label

Example: S / 36 / 8

badge

stringnull

Special badge (e.g., "New", "Sale")

Example: null

status

stringnull

Listing status (e.g., "sold", "reserved")

Example: null

url

string

Direct URL to the Vinted listing

Example: https://www.vinted.fr/items/5729689121-...

image_url

stringnull

URL of the product image

Example: https://images.vinted.net/...

internal_id

string

Vinted's internal listing identifier

Example: 5729689121

Pricing Information

price

number

Listing price in specified currency

Example: 45

service_fee

number

Platform service fee

Example: 4.5

total_item_price

number

Sum of price + service_fee

Example: 49.5

currency

stringnull

Currency code

Example: EUR

discount

numbernull

Discount percentage if applicable

Example: null

Engagement Metrics

favourite_count

integer

Number of users who favorited this item

Example: 12

view_count

integer

Number of times listing was viewed

Example: 89

is_favourite

boolean

Whether current user favorited this item

Example: false

promoted

boolean

Whether listing is promoted (paid placement)

Example: false

is_visible

boolean

Whether listing is publicly visible

Example: true

is_for_swap

booleannull

Whether item is available for swap

Example: false

Seller Information

user_id

string

Unique identifier of the seller

Example: 209950955

user_login

string

Seller's Vinted username

Example: sneaker_collector

user_profile_url

string

URL to seller's profile page

Example: https://www.vinted.fr/member/209950955-...

user_photo_url

stringnull

URL of seller's profile photo

Example: https://images.vinted.net/...

user_business

boolean

Whether seller is a registered business

Example: false

user_is_hidden

booleannull

Whether seller's identity is hidden

Example: null

user_is_sus

booleannull

Whether seller is flagged as suspicious

Example: null

Parameters

squidstring

Required

Hash of the squid to get results from

Example: 2eea95bc41594fb5898e86e671e4bb3f

runstring

Optional

Hash of a specific run (optional, filters to that run only)

Example: c52de994a19544de9c729b2e4b428255

pageinteger

Optional

Page number (default: 1)

Example: 1

page_sizeinteger

Optional

Results per page (default: 50, max: 100)

Example: 50

Pro Tip

Use the `next` URL in the response to paginate through all results.

Pro Tip

Check `user_business` to identify professional sellers vs. private individuals.

Note

The `total_item_price` includes the platform service fee that buyers pay.