{
  "openapi": "3.0.1",
  "info": {
    "title": "🚀 Avito Scraper · 5,000 Free Listings/Month",
    "description": "Avito Scraper gets you avito.ru listing data ⚡ fast, 🎯 100% accurate and 🔍 ridiculously detailed — prices, market estimates, specs, photos and sellers from any search or ad link. 💰 $1.00 per 1,000 listings, no start fee. Scrape your first 5,000 listings free every month 🚀",
    "version": "0.0",
    "x-build-id": "wUGXFfOmpg3FiMYp3"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/omkar-cloud~avito-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-omkar-cloud-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/omkar-cloud~avito-scraper/runs": {
      "post": {
        "operationId": "runs-sync-omkar-cloud-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/omkar-cloud~avito-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-omkar-cloud-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": {
          "searchQueries": {
            "title": "🔍 Search keywords",
            "type": "array",
            "description": "Words you would type into Avito's search box, one per line, in Russian or English. Each keyword is searched separately.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Avito links or ad IDs",
            "type": "array",
            "description": "avito.ru links, one per line: a category page (/moskva/avtomobili), a search page (/sankt-peterburg/kvartiry?q=студия) or an ad (…_7726049894). A bare ad ID works too. A category or search link brings its city, category and search words; set prices and other filters below. Ad links always come back as full rows. For seller profiles use the Avito Seller Scraper.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Maximum listings per keyword or link",
            "minimum": 1,
            "maximum": 1500,
            "type": "integer",
            "description": "Stop after this many listings for each keyword / link. Avito pages hold 50 listings and serve at most 1,500 per search. Keeps your cost predictable.",
            "default": 100
          },
          "location": {
            "title": "📍 Location",
            "type": "string",
            "description": "Where to search for your keywords: a city or region in Russian (Москва, Казань), its Avito slug (moskva, sankt-peterburg) or an avito.ru link. Leave empty for all of Russia. Links bring their own location."
          },
          "category": {
            "title": "Category",
            "type": "string",
            "description": "Limit your keywords to one Avito category: its slug (avtomobili, kvartiry, telefony, vakansii), its ID (9 for cars) or an avito.ru category link. Links bring their own category."
          },
          "sort": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "price_asc",
              "price_desc",
              "newest"
            ],
            "type": "string",
            "description": "Order of the results, as on Avito.",
            "default": "relevance"
          },
          "fullDetails": {
            "title": "📦 Full details",
            "type": "boolean",
            "description": "Add the full ad page to every row: every spec, the description, Avito's market-price estimate, price history, view counts, the Rosreestr property check, salary and employer for jobs, and the seller's rating, reply time and years on Avito. Billed as the Full listing details add-on.",
            "default": false
          },
          "minPrice": {
            "title": "Minimum price (₽)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings at or above this price, in rubles. Filters apply to every keyword and link."
          },
          "maxPrice": {
            "title": "Maximum price (₽)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings at or below this price, in rubles."
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "private",
              "company"
            ],
            "type": "string",
            "description": "Only listings from private sellers or only from companies. Leave empty for both."
          },
          "radius": {
            "title": "Radius (km)",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Also include listings within this many km of the location."
          },
          "withPhotosOnly": {
            "title": "With photos only",
            "type": "boolean",
            "description": "Only listings that have photos.",
            "default": false
          },
          "deliveryOnly": {
            "title": "Avito Delivery only",
            "type": "boolean",
            "description": "Only listings that ship with Avito Delivery.",
            "default": false
          },
          "titleOnly": {
            "title": "Search in titles only",
            "type": "boolean",
            "description": "Match your keywords in listing titles only, not in descriptions.",
            "default": false
          },
          "filters": {
            "title": "Attribute filters",
            "type": "string",
            "description": "Avito's own attribute filters as <attribute id>:<value> pairs, comma-separated, e.g. 2687:-50000 for mileage up to 50,000 km. Join several values with | and give ranges as min-max. Applies to every keyword and link."
          },
          "onlyNewListings": {
            "title": "🔔 Only new listings",
            "type": "boolean",
            "description": "For scheduled runs: return only listings you have not received from an earlier run with the same keywords, links and filters. The first run returns everything.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}