{
  "openapi": "3.0.1",
  "info": {
    "title": "Mexico Vehicle Auctions Scraper: Subastas de Autos",
    "description": "Clean JSON of car, motorcycle and truck auction lots in Mexico from Subastas Ventura, Subastas JJ and INDEP: brand, model, year, VIN, state, current bid and market value in MXN, damage status and photos. Filter by brand, year, price and state. No login, API key or browser needed.",
    "version": "0.1",
    "x-build-id": "XjDMY85zHlWabT9qg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/allanmxr~mexico-vehicle-auctions-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-allanmxr-mexico-vehicle-auctions-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/allanmxr~mexico-vehicle-auctions-scraper/runs": {
      "post": {
        "operationId": "runs-sync-allanmxr-mexico-vehicle-auctions-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/allanmxr~mexico-vehicle-auctions-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-allanmxr-mexico-vehicle-auctions-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 terms",
            "type": "array",
            "description": "Vehicle names, for example \"onix\" or \"hilux sr\". A lot matches when it contains every word of at least one term (accents and case are ignored). Leave empty to list all vehicles, up to Max items.",
            "items": {
              "type": "string"
            }
          },
          "vehicleType": {
            "title": "Vehicle type",
            "enum": [
              "all",
              "car",
              "motorcycle",
              "truck"
            ],
            "type": "string",
            "description": "Keep every type, or only cars (SUVs and pickups included), motorcycles, or trucks and heavy equipment.",
            "default": "all"
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Only lots of these brands. Leave empty for all brands.",
            "items": {
              "type": "string",
              "enum": [
                "ACURA",
                "AUDI",
                "BAIC",
                "BAJAJ",
                "BMW",
                "BUICK",
                "BYD",
                "CADILLAC",
                "CF MOTO",
                "CHANGAN",
                "CHEVROLET",
                "CHIREY",
                "CHRYSLER",
                "DINA",
                "DODGE",
                "DONG FENG",
                "DUCATI",
                "FIAT",
                "FORD",
                "FOTON",
                "FREIGHTLINER",
                "GAC MOTOR",
                "GEELY",
                "GMC",
                "GWM",
                "HINO",
                "HONDA",
                "HUMMER",
                "HYUNDAI",
                "INFINITI",
                "INTERNATIONAL",
                "ISUZU",
                "ITALIKA",
                "JAC",
                "JAECOO",
                "JEEP",
                "KAWASAKI",
                "KENWORTH",
                "KIA",
                "KTM",
                "LAND ROVER",
                "LEXUS",
                "LINCOLN",
                "MACK",
                "MAZDA",
                "MERCEDES-BENZ",
                "MERCURY",
                "MG",
                "MINI",
                "MITSUBISHI",
                "NISSAN",
                "OMODA",
                "PEUGEOT",
                "PONTIAC",
                "PORSCHE",
                "RAM",
                "RENAULT",
                "ROYAL ENFIELD",
                "SCANIA",
                "SEAT",
                "SMART",
                "SUBARU",
                "SUZUKI",
                "TESLA",
                "TOYOTA",
                "TRIUMPH",
                "VENTO",
                "VOLKSWAGEN",
                "VOLVO",
                "XCMG",
                "YAMAHA"
              ]
            }
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of lots in the dataset, shared across the auction houses (each one contributes in turn, so the biggest does not use up the limit). You are charged per lot returned.",
            "default": 100
          },
          "yearMin": {
            "title": "Minimum model year",
            "minimum": 1950,
            "type": "integer",
            "description": "Skip vehicles older than this model year. Lots whose year cannot be read are skipped when a year filter is set."
          },
          "yearMax": {
            "title": "Maximum model year",
            "minimum": 1950,
            "type": "integer",
            "description": "Skip vehicles newer than this model year."
          },
          "priceMin": {
            "title": "Minimum price (MXN)",
            "minimum": 0,
            "type": "integer",
            "description": "Compared with the current bid, or the starting price when there is no bid yet."
          },
          "priceMax": {
            "title": "Maximum price (MXN)",
            "minimum": 0,
            "type": "integer",
            "description": "Compared with the current bid, or the starting price when there is no bid yet."
          },
          "states": {
            "title": "States",
            "type": "array",
            "description": "Only lots located in these Mexican states. Leave empty for the whole country. Lots whose location is unknown are dropped when a state is selected.",
            "items": {
              "type": "string",
              "enum": [
                "Aguascalientes",
                "Baja California",
                "Baja California Sur",
                "Campeche",
                "Chiapas",
                "Chihuahua",
                "Ciudad de México",
                "Coahuila",
                "Colima",
                "Durango",
                "Estado de México",
                "Guanajuato",
                "Guerrero",
                "Hidalgo",
                "Jalisco",
                "Michoacán",
                "Morelos",
                "Nayarit",
                "Nuevo León",
                "Oaxaca",
                "Puebla",
                "Querétaro",
                "Quintana Roo",
                "San Luis Potosí",
                "Sinaloa",
                "Sonora",
                "Tabasco",
                "Tamaulipas",
                "Tlaxcala",
                "Veracruz",
                "Yucatán",
                "Zacatecas"
              ]
            }
          },
          "damage": {
            "title": "Damage history",
            "enum": [
              "all",
              "no_damage",
              "damaged_only"
            ],
            "type": "string",
            "description": "Insurer salvage, recovered-theft, scrap and parts-only lots are flagged isSalvage = true. \"Without damage\" keeps only lots the source explicitly lists as used or like-new (Ventura SEMINUEVAS); lots whose condition is unknown are not kept by either damage option.",
            "default": "all"
          },
          "auctionDateFrom": {
            "title": "Auction date from",
            "type": "string",
            "description": "Only lots whose auction ends on or after this date."
          },
          "auctionDateTo": {
            "title": "Auction date to",
            "type": "string",
            "description": "Only lots whose auction ends on or before this date."
          },
          "sources": {
            "title": "Auction houses",
            "type": "array",
            "description": "Which auction houses to scrape. Leave all selected to search everywhere.",
            "items": {
              "type": "string",
              "enum": [
                "ventura",
                "jj",
                "indep"
              ],
              "enumTitles": [
                "Subastas Ventura (insurers, fleets, used)",
                "Subastas JJ (insurer salvage, live auctions)",
                "INDEP (federal government)"
              ]
            },
            "default": [
              "ventura",
              "jj",
              "indep"
            ]
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. By default the actor connects directly and only climbs to Apify Proxy (Mexico) if a site blocks it. Set this to force a specific proxy."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}