{
  "openapi": "3.0.1",
  "info": {
    "title": "MercadoLibre Scraper: Products, Prices, Sellers & Deals",
    "description": "MercadoLibre API and scraper for products and prices in Argentina, Mexico and Colombia: search, category lists, sellers, official stores, deals (ofertas) and best sellers (mas vendidos). Price, discount, sold count, rating, seller, shipping; product pages on request. No login. Misses free.",
    "version": "0.1",
    "x-build-id": "31xmyD8nAqyOaz52z"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/hyperbach~mercadolibre-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-hyperbach-mercadolibre-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/hyperbach~mercadolibre-scraper/runs": {
      "post": {
        "operationId": "runs-sync-hyperbach-mercadolibre-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/hyperbach~mercadolibre-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-hyperbach-mercadolibre-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchTerms": {
            "title": "Search words",
            "maxItems": 1000,
            "type": "array",
            "description": "Words as you would type them in MercadoLibre's search box, one search per line (for example zapatillas deportivas). Each search is read on the site you pick below, page by page, to the end of the list or your limits.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "MercadoLibre list or product links",
            "maxItems": 1000,
            "type": "array",
            "description": "Links copied from MercadoLibre Argentina, Mexico or Colombia: a search or category list (listado.mercadolibre.com.ar/...), a filtered or sorted list, a seller's list (..._CustId_<id>), an official store (/tienda/<name>), the deals (/ofertas), the best sellers (/mas-vendidos, or a category's /mas-vendidos/MLA1055), or a product (www.mercadolibre.com.ar/<name>/p/MLA..., articulo.mercadolibre.com.mx/MLM-...-_JM): a product's link gives one row from its own page. Each link is read on its own site.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sellerIds": {
            "title": "Sellers' ids",
            "maxItems": 1000,
            "type": "array",
            "description": "Sellers' numeric ids (the digits after _CustId_ in a seller's list link): every product the seller lists on the site you pick.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "officialStores": {
            "title": "Official stores",
            "maxItems": 1000,
            "type": "array",
            "description": "Official stores by the name in their link (for example topper for mercadolibre.com.ar/tienda/topper): every product the store lists on the site you pick.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "site": {
            "title": "Country (MercadoLibre site)",
            "enum": [
              "ar",
              "mx",
              "co"
            ],
            "type": "string",
            "description": "The MercadoLibre site the search words, sellers and stores are read on: Argentina, Mexico or Colombia. Links are always read on their own site. The other Spanish-language sites are not read yet.",
            "default": "ar"
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "relevance",
              "price_asc",
              "price_desc"
            ],
            "type": "string",
            "description": "The order MercadoLibre lists the products in (searches, sellers and stores).",
            "default": "relevance"
          },
          "minPrice": {
            "title": "Min price",
            "minimum": 0,
            "type": "integer",
            "description": "Only products from this price, in the site's own currency. Empty or 0 = no minimum."
          },
          "maxPrice": {
            "title": "Max price",
            "minimum": 0,
            "type": "integer",
            "description": "Only products up to this price, in the site's own currency. Empty or 0 = no maximum."
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "any",
              "new",
              "used",
              "refurbished",
              "open_box"
            ],
            "type": "string",
            "description": "Only new, used, refurbished or open-box products, as MercadoLibre's own condition filter applies it.",
            "default": "any"
          },
          "freeShipping": {
            "title": "Free shipping only",
            "type": "boolean",
            "description": "Only products with free shipping.",
            "default": false
          },
          "fullShipping": {
            "title": "FULL only",
            "type": "boolean",
            "description": "Only products shipped by MercadoLibre's FULL fulfilment.",
            "default": false
          },
          "officialStoresOnly": {
            "title": "Official stores only",
            "type": "boolean",
            "description": "Only products sold by official stores.",
            "default": false
          },
          "minDiscount": {
            "title": "Min discount (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Only products discounted at least this much. The list is asked at MercadoLibre's own step at or under it (5, 10, 15, 20, 25, 30, 40, 50, 60, 70, 80; under 5 the step 5), and a product under your minimum is left out, free. 0 = any.",
            "default": 0
          },
          "includeSponsored": {
            "title": "Include sponsored products",
            "type": "boolean",
            "description": "Sponsored cards (ads) are left out by default. On: they come too, each with sponsored true and no position.",
            "default": false
          },
          "productDetails": {
            "title": "Product details",
            "type": "boolean",
            "description": "Off by default. On: each card's own product page is read too, and its fields are added to the card's row: the description, the pictures, the specs, the stock, the seller's reputation, the warranty, the buy box's offers and the first reviews (details_status served). Charged at the product-page price instead of the card's; a page that cannot be read leaves the card's row as the list showed it, at the card's price.",
            "default": false
          },
          "maxItems": {
            "title": "Max results (whole run)",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "The most product rows of the whole run, shared evenly by its searches, links, sellers and stores (an input whose list ends short leaves the rest of its share to the others); 0 = no cap beyond your charge limit.",
            "default": 0
          },
          "maxPages": {
            "title": "Max pages per list",
            "minimum": 0,
            "maximum": 42,
            "type": "integer",
            "description": "The most pages read of each search or list (48 products a page; MercadoLibre lists at most 42 pages of a list). 0 = to the end of the list.",
            "default": 0
          },
          "feedback": {
            "title": "Feedback to the maintainers",
            "maxLength": 2000,
            "type": "string",
            "description": "A note to the people who maintain this Actor: what you needed and did not get. For example a missing field, a wrong or empty result, or the Actor you switch from or to, and why. The run does not read it: the rows and the charges stay the same. A person reads every note."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}