Search

Performs an item search in MercadoLibre returning basic item information.

collapse allexpand all

{
  "site_id": "MLB",
  "seller": {
    "id": 184179803,
    "seller_reputation": {
      "power_seller_status": null
    },
    "real_estate_agency": false,
    "car_dealer": false,
    "tags": [
    ]
  },
  "paging": {
    "total": 0,
    "offset": 0,
    "limit": 50,
    "primary_results": 0
  },
  "results": [
  ],
  "secondary_results": [
  ],
  "related_results": [
  ],
  "sort": {
    "id": "relevance",
    "name": "More relevant"
  },
  "available_sorts": [
    {
      "id": "price_asc",
      "name": "Lower price"
    },
    {
      "id": "price_desc",
      "name": "Higher price"
    }
  ],
  "filters": [
    {
      "id": "adult_content",
      "name": "Adult content filter",
      "type": "boolean",
      "values": [
        {
          "id": "yes",
          "name": "Adult content"
        }
      ]
    }
  ],
  "available_filters": [
  ]
}
Allowed methods
Performs a search by query
GET
/sites/MLA/search?q=
Performs a search by category
GET
/sites/MLA/search?category=
Performs a search by seller_id
GET
/sites/MLA/search?seller_id=
Performs a search by nickname
GET
/sites/MLA/search?nickname=
Performs a search by special filters
GET
/sites/MLA/search?special_filter=
Performs a search with a specific sorting method
GET
/sites/MLA/search?q=ipod&sort=sortId=
Performs a search applying filters
GET
/sites/MLA/search?q=ipod&FilterID=FilterValue
Attributes
site_id
ID of MercaodLibres site where the search took place
query
Search query
results
List of items resulting of a search. Includes data obtained from Items API
billboard_results
Retorna los items que tienen contratado un paquete especial de destaque
paging
Information about paging
Attributes
total
Total items found
offset
Position from which this page begins
limit
Number of results per page
sort
Applied sort
Attributes
id
Sort ID
name
Sort description
available_sorts
Available sorts
Attributes
id
Sort ID
name
Sort description
filters
Applied filters
Attributes
id
Filter ID
values
List of applied filter values
Attributes
id
Filter value ID
results
Number of items matching the filter
available_filters
Available filters
Attributes
id
Filter ID
name
Filter description
values
Number of available filter values
Attributes
id
Filter value ID
name
Filter value name
results
Number of items matching search criteria
Related resources
/items
/categories
/users
/location
/sites
/sites/MLX/search_configurations
/sites/MLX/related_searches
/sites/MLX/searchUrl