Skip to main content
POST
Search by image
Find active listings from one image URL or base64 photo. See the image-search guide for local files, filters and client examples.
Send exactly one of image_url or image_base64. JPEG, PNG and WebP images can be up to 5 MiB decoded. Authenticate with your x-api-key header.

Authorizations

x-api-key
string
header
required

Body

application/json

Search by exactly one public image URL or base64-encoded image.

image_url
string | null

Public HTTP(S) image URL. Supply exactly one of image_url or image_base64.

Maximum string length: 4096
image_base64
string | null

JPEG, PNG or WebP, at most 5 MiB decoded. Bare base64 or a data:image/...;base64 URL.

Maximum string length: 7100000
market
string
default:fr

Vinted market code; uk aliases gb

page
integer
default:1
Required range: x >= 1
per_page
integer
default:20
Required range: 1 <= x <= 96
price_from
number | null
Required range: x >= 0
price_to
number | null
Required range: x >= 0
brand_ids
string | null

Comma-separated brand IDs

Maximum string length: 1000
Pattern: ^[1-9][0-9]*(,[1-9][0-9]*)*$
catalog_ids
string | null

Comma-separated category IDs

Maximum string length: 1000
Pattern: ^[1-9][0-9]*(,[1-9][0-9]*)*$
color_ids
string | null

Comma-separated color IDs

Maximum string length: 1000
Pattern: ^[1-9][0-9]*(,[1-9][0-9]*)*$
size_ids
string | null

Comma-separated size IDs

Maximum string length: 1000
Pattern: ^[1-9][0-9]*(,[1-9][0-9]*)*$
material_ids
string | null

Comma-separated material IDs

Maximum string length: 1000
Pattern: ^[1-9][0-9]*(,[1-9][0-9]*)*$
status_ids
string | null

Comma-separated condition IDs

Maximum string length: 1000
Pattern: ^[1-9][0-9]*(,[1-9][0-9]*)*$
time
integer | null

Pagination time from the preceding page

Required range: x >= 0
search_session_id
string | null

Reuse across pages of one search

Maximum string length: 100

Response

Successful search

items
object[]
pagination
object
market
string

Echo of the market that was searched.

seller_country
string | null

Echo of the normalized seller_country filter that was applied (uppercase, comma-separated ISO-2 codes, e.g. "FR,BE"), or null when no filter was requested.