{
  "openapi": "3.0.1",
  "info": {
    "title": "Avito Scraper | Listings, Prices and Sellers",
    "description": "Avito scraper that turns avito.ru listings into structured JSON: prices, descriptions, photos, coordinates, seller ratings, and the nearest metro station with walking time. Search by keyword and city, paste a URL, or use listing ids. Detail mode adds vehicle valuation and real estate checks.",
    "version": "1.0",
    "x-build-id": "l3bKWiLXedgVUQKhw"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~avito-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-avito-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/silentflow~avito-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-avito-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/silentflow~avito-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-avito-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": {
          "keywords": {
            "title": "🔎 Keywords",
            "type": "array",
            "description": "What to search for on Avito, one keyword per line: <code>iphone 15</code>, <code>macbook air</code>, <code>2-к квартира</code>. Each keyword is a search of its own in the city, category and filters below, so two keywords give two searches in one run. A listing two keywords both find is saved once. Leave empty to fetch only the URLs below, or to list a whole category.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Avito URLs or listing ids",
            "type": "array",
            "description": "Avito pages, one per line:<ul><li>a search or category page copied from your browser, such as <code>https://www.avito.ru/moskva/noutbuki</code>: every filter you set on Avito (brand, model, rooms, metro) is kept, and each URL is a search of its own;</li><li>a listing URL or a bare listing id, such as <code>7739644389</code>: fetched with its full details, after the searches.</li></ul>Mobile <code>m.avito.ru</code> links work too.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "📍 City",
            "type": "string",
            "description": "Where the keyword searches look. Pick a city, or type any Avito city as it is written in Avito URLs, such as <code>tula</code> or <code>kaliningrad</code>; <code>all</code> searches the whole of Russia. In a city with a metro (Moscow, Saint Petersburg, Novosibirsk, Yekaterinburg, Kazan, Nizhny Novgorod, Samara) most listings also carry the nearest station and the walking time. A pasted URL keeps its own city.",
            "default": "moskva"
          },
          "maxResults": {
            "title": "🔢 Max listings per search",
            "minimum": 1,
            "type": "integer",
            "description": "How many listings each search returns: each keyword and each search URL gets up to this many, and the listing URLs are fetched up to this many. Avito itself shows about 1,500 listings for one search; ask for more and the search is split into price ranges to reach the rest.",
            "default": 100
          },
          "category": {
            "title": "🗂️ Category",
            "type": "string",
            "description": "Pick a category, or type any Avito category as it is written in Avito URLs, such as <code>noutbuki</code>, <code>kvartiry/prodam</code> or <code>gruzoviki_i_spetstehnika</code>. Leave empty to search every category."
          },
          "sellerType": {
            "title": "👤 Seller type",
            "enum": [
              "any",
              "private",
              "company"
            ],
            "type": "string",
            "description": "Private sellers only, or companies only, with Avito's own seller filter. Each row of a filtered search says which in <code>userType</code>.",
            "default": "any"
          },
          "priceMin": {
            "title": "💸 Minimum price (RUB)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings priced at or above this amount, in rubles."
          },
          "priceMax": {
            "title": "💰 Maximum price (RUB)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings priced at or below this amount, in rubles."
          },
          "sort": {
            "title": "↕️ Sort by",
            "enum": [
              "relevance",
              "newest",
              "cheapest",
              "expensive"
            ],
            "type": "string",
            "description": "The order Avito lists the results in. <i>Newest first</i> is the one to schedule for catching new ads early.",
            "default": "relevance"
          },
          "includeDetails": {
            "title": "📑 Full listing details",
            "type": "boolean",
            "description": "Open each listing's own page for the full description, every specification, view counts, the listing status (active, reserved, closed), the seller's company or private status and profile, and category data such as Avito's vehicle valuation or the real estate registry check. Turn off for faster runs with the search-card fields only (price, seller and rating, photos, coordinates, posting date, delivery).",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}