{
  "openapi": "3.0.1",
  "info": {
    "title": "Auto.ru Scraper: Парсер Авто.ру with Price & Delisting Alerts",
    "description": "Scrape Auto.ru (Авто.ру) used-car listings: price, mileage, year, specs, seller trust signal, and Auto.ru's own predicted price range. Includes a price-drop and delisting tracker plus new-listing alerts for a saved search. No login required. Export to Sheets, Zapier, Make. $0.0045/listing.",
    "version": "0.5",
    "x-build-id": "t3U5UiARAr9lVxoJd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/getascraper~autoru-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-getascraper-autoru-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/getascraper~autoru-scraper/runs": {
      "post": {
        "operationId": "runs-sync-getascraper-autoru-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/getascraper~autoru-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-getascraper-autoru-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": {
          "citySlug": {
            "title": "City Slug",
            "type": "string",
            "description": "Auto.ru city URL path segment to search within, e.g. moskva, sankt-peterburg, novosibirsk. Matches sibling actor avito-auto-scraper's citySlug field name, so datasets from both actors can be merged directly.",
            "default": "moskva"
          },
          "makeSlug": {
            "title": "Make Slug",
            "type": "string",
            "description": "Auto.ru make (brand) URL path segment, e.g. bmw, mercedes, toyota. Leave empty to search all makes in the city. Matches sibling actor drom-ru-cars-scraper's makeSlug field name.",
            "default": ""
          },
          "modelSlug": {
            "title": "Model Slug",
            "type": "string",
            "description": "Auto.ru model URL path segment, e.g. x5, camry. Only applied when Make Slug is also set; ignored otherwise. Matches sibling actor drom-ru-cars-scraper's modelSlug field name.",
            "default": ""
          },
          "listingUrls": {
            "title": "Listing URLs",
            "type": "array",
            "description": "Specific Auto.ru listing detail-page URLs to scrape, instead of running a City/Make/Model search. When set, this replaces the search entirely. This is also the required source for the Listing tracker monitor mode below (Advanced section): give it the shortlist of listings you want to watch for price drops or delisting over time.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "minPrice": {
            "title": "Minimum Price (RUB)",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep listings priced at or above this amount, in Russian rubles. The search asks Auto.ru for this price range across its whole catalog, and every returned listing is checked against it again, so the output only holds listings whose asking price is in range."
          },
          "maxPrice": {
            "title": "Maximum Price (RUB)",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep listings priced at or below this amount, in Russian rubles. Works like Minimum Price above: Auto.ru is searched for the range and every returned listing is checked again."
          },
          "minYear": {
            "title": "Minimum Year",
            "minimum": 1950,
            "maximum": 2026,
            "type": "integer",
            "description": "Only keep listings with a model year at or after this value. Auto.ru is searched for the year range across its whole catalog, like Minimum Price above."
          },
          "maxYear": {
            "title": "Maximum Year",
            "minimum": 1950,
            "maximum": 2026,
            "type": "integer",
            "description": "Only keep listings with a model year at or before this value. Works like Minimum Year above."
          },
          "bodyTypes": {
            "title": "Body Type",
            "type": "array",
            "description": "Only keep listings whose body type is one of these. Checked on each page of results; the search keeps reading further pages until it has Maximum Listings matching cars or runs out of results.",
            "items": {
              "type": "string",
              "enum": [
                "sedan",
                "suv",
                "hatchback",
                "wagon",
                "liftback",
                "coupe",
                "minivan",
                "van",
                "pickup",
                "cabrio"
              ],
              "enumTitles": [
                "Sedan",
                "SUV / Crossover",
                "Hatchback",
                "Wagon / Estate",
                "Liftback",
                "Coupe",
                "Minivan",
                "Van",
                "Pickup",
                "Cabriolet"
              ]
            },
            "default": []
          },
          "engineTypes": {
            "title": "Engine / Fuel Type",
            "type": "array",
            "description": "Only keep listings with one of these engine (fuel) types. Checked page by page, same behavior as Body Type above.",
            "items": {
              "type": "string",
              "enum": [
                "gasoline",
                "diesel",
                "hybrid",
                "electro",
                "lpg"
              ],
              "enumTitles": [
                "Gasoline (Petrol)",
                "Diesel",
                "Hybrid",
                "Electric",
                "LPG / Gas"
              ]
            },
            "default": []
          },
          "transmissions": {
            "title": "Transmission",
            "type": "array",
            "description": "Only keep listings with one of these transmission types. Checked page by page, same behavior as Body Type above.",
            "items": {
              "type": "string",
              "enum": [
                "automatic",
                "mechanical",
                "robot",
                "variator"
              ],
              "enumTitles": [
                "Automatic",
                "Manual",
                "Robot (automated / DSG)",
                "Variator (CVT)"
              ]
            },
            "default": []
          },
          "driveTypes": {
            "title": "Drive Type",
            "type": "array",
            "description": "Only keep listings with one of these drivetrains. Checked page by page, same behavior as Body Type above.",
            "items": {
              "type": "string",
              "enum": [
                "front",
                "rear",
                "all"
              ],
              "enumTitles": [
                "Front-wheel drive",
                "Rear-wheel drive",
                "All-wheel drive"
              ]
            },
            "default": []
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Keep Apify Proxy switched on: Auto.ru shows a captcha to requests that do not use a proxy. The datacenter proxy (the default) works. Do not set a country on it, because that pool has no country addresses and requests fail; choose the RESIDENTIAL group if you need a country.",
            "default": {
              "useApifyProxy": true
            }
          },
          "scrapeDetails": {
            "title": "Scrape Detail Pages",
            "type": "boolean",
            "description": "Visit each listing's own detail page to add its full free-text description, private-seller account age (a trust signal not shown on the search page), full photo set, and generation name. Roughly doubles requests and run time, so it defaults to off.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum Listings",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum number of listings to return. A City/Make/Model search reads as many Auto.ru result pages (37 listings each) as it needs to reach this number, or stops when the search has no more results. Each listing appears once.",
            "default": 20
          },
          "onlyChangedListings": {
            "title": "Track Price & Listing Changes",
            "type": "boolean",
            "description": "Listing-tracker mode: re-checks every URL in Listing URLs (Sources) for a price change or delisting since the last run that used the same State Name below, and outputs only the change events found (newly tracked, price dropped, price rose, delisted, relisted) instead of plain listing rows. Requires Listing URLs to be non-empty. Mutually exclusive with Alert on New Listings below.",
            "default": false
          },
          "onlyNewListings": {
            "title": "Alert on New Listings",
            "type": "boolean",
            "description": "Saved-search mode: re-runs the City/Make/Model search (or Search Filters) and outputs only listings not seen in a previous run that used the same State Name below - a standing-search \"new listing\" alert. Mutually exclusive with Track Price & Listing Changes above.",
            "default": false
          },
          "stateName": {
            "title": "State Name",
            "type": "string",
            "description": "Identifies which watchlist or saved search this run's monitor state belongs to. Use a different value for each independent watchlist or search you want to track in parallel (e.g. \"bmw-x5-moscow\" vs \"family-suv-budget\"). Shared by both monitor modes above.",
            "default": "default"
          },
          "resetState": {
            "title": "Reset State",
            "type": "boolean",
            "description": "Clears the persisted monitor state for State Name before this run, so the next run treats every result as new or newly tracked again. Use this to start a watchlist or saved search over from scratch.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}