{
  "openapi": "3.0.1",
  "info": {
    "title": "Mercado Libre Scraper | Stores, Products & Categories",
    "description": "Collect Mercado Libre and Mercado Livre store identities, product grids and category data across Latin American country sites. Export JSON, CSV or Excel; pay per delivered row plus a start fee.",
    "version": "0.1",
    "x-build-id": "b9S1lhPDbWCzebhDg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lentic_clockss~mercadolibre-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lentic_clockss-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/lentic_clockss~mercadolibre-scraper/runs": {
      "post": {
        "operationId": "runs-sync-lentic_clockss-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/lentic_clockss~mercadolibre-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-lentic_clockss-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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "auto",
              "ofertas",
              "category",
              "search",
              "product",
              "categories",
              "tienda",
              "tiendas",
              "perfil",
              "landing",
              "nav",
              "api",
              "storefront"
            ],
            "type": "string",
            "description": "Auto selects a mode from the target you supply; empty input selects one example store. Choose target-free modes explicitly; search, product, ofertas and category can return no data because of login restrictions.",
            "default": "auto"
          },
          "countrySite": {
            "title": "Country site",
            "enum": [
              "mercadolibre.com.ar",
              "mercadolibre.com.mx",
              "mercadolivre.com.br",
              "mercadolibre.cl",
              "mercadolibre.com.co",
              "mercadolibre.com.pe",
              "mercadolibre.com.uy",
              "mercadolibre.com.ve",
              "mercadolibre.com.ec",
              "mercadolibre.com.bo",
              "mercadolibre.com.gt",
              "mercadolibre.com.cr",
              "mercadolibre.com.pa",
              "mercadolibre.com.do",
              "mercadolibre.com.hn",
              "mercadolibre.com.ni",
              "mercadolibre.com.sv",
              "mercadolibre.com.py"
            ],
            "type": "string",
            "description": "Choose a Mercado Libre or Mercado Livre country host. A recognized siteId, such as MLA, MLM or MLB, overrides this selection; availability varies by country and mode.",
            "default": "mercadolibre.com.ar"
          },
          "storeSlug": {
            "title": "Store URL name",
            "type": "string",
            "description": "Use the store name from a /tienda/ URL, or /loja/ in Brazil, such as 2bambu. Auto selects tienda; specify storefront explicitly to request its item identifiers."
          },
          "nickname": {
            "title": "Seller nickname",
            "type": "string",
            "description": "Seller nickname for perfil mode. A matching profile returns a seller identifier; an unresolved nickname produces no seller row."
          },
          "storefrontId": {
            "title": "Storefront identifier",
            "type": "string",
            "description": "Identifier for storefront mode. Alternatively, select storefront and supply storeSlug to look up the identifier from that store."
          },
          "categorySlug": {
            "title": "Category slug",
            "type": "string",
            "description": "Category URL name for category mode, such as celulares-y-telefonos in Argentina. Category listings can be unavailable because of login restrictions."
          },
          "keyword": {
            "title": "Search keyword",
            "type": "string",
            "description": "One term for search mode, or for api with resource set to domain_discovery. Product search may return no rows because of login restrictions."
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "List of search terms; each is a separate input with its own maxResults limit. Product search may be unavailable because of login restrictions.",
            "items": {
              "type": "string"
            }
          },
          "productUrl": {
            "title": "Product URL",
            "pattern": "^https?://([A-Za-z0-9-]+\\.)*(mercadolibre|mercadolivre)\\.[A-Za-z.]+(/.*)?$",
            "type": "string",
            "description": "Full Mercado Libre or Mercado Livre product link for product mode. The requested page may be unavailable because of login restrictions."
          },
          "productId": {
            "title": "Catalog product ID",
            "type": "string",
            "description": "Catalog product identifier for product mode, such as MLA64352063 from a /p/ link. Product access may be restricted."
          },
          "itemId": {
            "title": "Item ID",
            "type": "string",
            "description": "Listing identifier for product mode, such as MLA1917258137. Product access may be restricted."
          },
          "userProductId": {
            "title": "User product ID",
            "type": "string",
            "description": "User-product identifier for product mode, such as MLAU3818396667 from a /up/ link. Product access may be restricted."
          },
          "maxResults": {
            "title": "Max rows per keyword or target",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum rows per keyword or selected target: default 70, maximum 500, with larger requests collected in parts of 70 and spending capped across the run. Free Apify plan: 200 rows per run and 10 runs of this Actor; the example store produces one row.",
            "default": 70
          },
          "siteId": {
            "title": "Site ID",
            "type": "string",
            "description": "Optional marketplace identifier, such as MLA for Argentina, MLM for Mexico or MLB for Brazil. A recognized identifier overrides countrySite."
          },
          "categoryId": {
            "title": "Category ID",
            "type": "string",
            "description": "Category identifier for categories mode, or a category filter for ofertas. In categories mode, it must match the selected country prefix; the default is the country site ID followed by 1055."
          },
          "containerId": {
            "title": "Deals collection identifier",
            "type": "string",
            "description": "Optional collection identifier from a deals page for ofertas mode. It does not remove page-access restrictions."
          },
          "price": {
            "title": "Deals price range",
            "type": "string",
            "description": "Optional ofertas price range, such as 65000.0-250000.0, using the selected market currency."
          },
          "installments": {
            "title": "Deals installment filter",
            "type": "string",
            "description": "Optional installment filter value taken from a deals page for ofertas mode."
          },
          "page": {
            "title": "Deals page",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Starting deals page for ofertas mode, from 1 to 100. Defaults to 1.",
            "default": 1
          },
          "landing": {
            "title": "Product grid",
            "enum": [
              "importados",
              "market"
            ],
            "type": "string",
            "description": "Product grid for landing mode: importados selects international shopping and market selects the supermarket. Availability varies by country.",
            "default": "importados"
          },
          "resource": {
            "title": "Metadata resource",
            "enum": [
              "countries",
              "classified_locations",
              "payment_methods",
              "domain_discovery",
              "categories",
              "attributes"
            ],
            "type": "string",
            "description": "Resource for api mode: country information, classified locations, payment methods, category suggestions, category records or attributes. For domain_discovery, also supply keyword.",
            "default": "countries"
          },
          "resourceId": {
            "title": "Metadata resource identifier",
            "type": "string",
            "description": "Country code for countries or classified_locations, or category ID for categories or attributes. Defaults to the selected country or its category ID ending in 1055."
          },
          "enrichDetails": {
            "title": "Add matching seller information",
            "type": "boolean",
            "description": "Enabled by default: with storeSlug, eligible listing rows receive store information only when their seller identity matches that store. It adds no separate rows and does not provide private phone numbers or email addresses.",
            "default": true
          },
          "workerBaseUrl": {
            "title": "Developer test option",
            "type": "string",
            "description": "Leave empty. Used only by the developer for testing."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}