Skip to main content
POST /v1/data/mercadolibre/listings/run Pricing: $0.003 per listing ($3.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
required
Search Query.
string
required
The MercadoLibre country marketplace to search.Allowed values: MX (🇲🇽 Mexico), AR (🇦🇷 Argentina), BR (🇧🇷 Brazil), EC (🇪🇨 Ecuador), CL (🇨🇱 Chile), CO (🇨🇴 Colombia), PE (🇵🇪 Peru), UY (🇺🇾 Uruguay), VE (🇻🇪 Venezuela).
integer
default:"100"
How many listings to return in total. Defaults to 100; use 0 for all.
string
default:"any"
Only new, used or refurbished listings. Any (default) keeps all.Allowed values: any (Any (default)), new (New), used (Used), refurbished (Refurbished).
string
default:"relevance"
Sort By to use. Relevance (default) by default.Allowed values: relevance (Relevance (default)), price_asc (Price: low to high), price_desc (Price: high to low).

Example

Response fields

Each row in data is one listing, keyed by these fields.

Example response

Abridged: long text and lists are shortened.