{
  "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.1",
    "x-build-id": "OH1EzyScMFEaQqy7e"
  },
  "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. Applied as a filter on the results already fetched by the search (Auto.ru's own price filter needs a URL query string, which this Actor avoids to stay compliant with auto.ru's robots.txt for a generic client) - it narrows the one page of results returned, it does not search the full catalog for this price range."
          },
          "maxPrice": {
            "title": "Maximum Price (RUB)",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep listings priced at or below this amount, in Russian rubles. Same client-side filtering behavior as Minimum Price above."
          },
          "minYear": {
            "title": "Minimum Year",
            "minimum": 1950,
            "maximum": 2026,
            "type": "integer",
            "description": "Only keep listings with a model year at or after this value. Applied as a client-side filter on the fetched results, same reasoning as 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. Same client-side filtering behavior as Minimum Year above."
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Datacenter proxy is sufficient for Auto.ru: this session confirmed live that real-Chrome, Googlebot, and empty-User-Agent requests all reach full real content once the regional-consent cookie is set, with no WAF or CAPTCHA signature encountered at the depth tested.",
            "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 can only ever return one page of results (Auto.ru's robots.txt blocks the query-string pagination a generic client would need, and no path-segment pagination exists) - live-confirmed at up to 37 listings per search. Raising this above ~37 only helps when Listing URLs (Sources) also lists more items than that.",
            "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}