{ "openapi": "3.0.1", "info": { "title": "Avito.ma Scraper - Low-cost 💲🔥🎯🛍️", "description": "Scrape Avito product listings with this powerful Apify actor 🎯🌍. \n\nSearch by keyword, category, and city (Morocco) to extract product titles, prices, locations, and more. \n\nHandle pagination easily and get clean, structured datasets for market research, price tracking, and e-commerce analysis 📊🚀", "version": "0.0", "x-build-id": "aIHU6oBH8l9lHCXwK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delectable_incubator~avito-ma-scraper---low-cost/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delectable_incubator-avito-ma-scraper---low-cost", "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/delectable_incubator~avito-ma-scraper---low-cost/runs": { "post": { "operationId": "runs-sync-delectable_incubator-avito-ma-scraper---low-cost", "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/delectable_incubator~avito-ma-scraper---low-cost/run-sync": { "post": { "operationId": "run-sync-delectable_incubator-avito-ma-scraper---low-cost", "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", "required": [ "keywords" ], "properties": { "keywords": { "title": "Keywords to search ✍️🔍 | Mots-clés de recherche ✍️🔍 | كلمات البحث ✍️🔍", "type": "array", "description": "List of keywords to search. Each keyword will be scraped separately up to max_items each.\n\nListe des mots-clés à rechercher. Chaque mot-clé sera scrapé séparément jusqu’à max_items.\n\nقائمة كلمات البحث. سيتم استخراج النتائج لكل كلمة بشكل منفصل حتى الحد الأقصى max_items.", "default": [ "Mercedes", "Toyota" ], "items": { "type": "string" } }, "city": { "title": "Select city 🌍 | Ville 🌍 | اختر المدينة 🌍", "enum": [ "maroc", "khouribga", "safi", "fes", "kenitra", "casablanca", "sale", "el_jadida", "marrakech", "meknes", "oujda", "tetouan", "rabat", "agadir", "beni_mellal", "tanger", "taza", "al_hoceima", "errachidia", "khenifra", "larache", "nador", "ouarzazate", "settat", "ain_aouda", "ain_harrouda", "ait_baha", "ait_melloul", "al_haouz", "aousserd", "arfoud", "assa_zag", "assilah", "azemmour", "azilal", "azrou", "ben_ahmed", "ben_guerir", "benslimane", "berkane", "berrechid", "bin_el_ouidane", "boujdour", "boulmane", "bouskoura", "bouznika", "chefchaouen", "chichaoua", "dakhla", "el_harhoura", "el_mansouria", "es_semara", "essaouira", "figuig", "fnideq", "guelmim", "guercif", "had_soualem", "ifrane", "imouzzer", "inzegan", "kelaat_es-sraghna", "khemisset", "ksar_el-kebir", "ksar_es-seghir", "lagouira", "laayoune", "martil", "mdiq", "midelt", "mohammedia", "moulay_bousselham", "moulay_yaccoub", "nouaceur", "oualidia", "ouazzane", "saidia", "sala_al-jadida" ], "type": "string", "description": "Select city to scrape offers from.\n\nChoisissez la ville pour extraire les annonces.\n\nاختر المدينة لاستخراج الإعلانات منها.", "default": "maroc" }, "language": { "title": "Language 🗣️ | Langue 🗣️ | اللغة 🗣️", "enum": [ "fr", "ar" ], "type": "string", "description": "Choose interface language (French or Arabic).\n\nChoisissez la langue (français ou arabe).\n\nاختر اللغة (الفرنسية أو العربية).", "default": "fr" }, "category": { "title": "Category 🎯 | Catégorie 🎯 | الفئة 🎯", "enum": [ "all", "market", "véhicules", "immobilier", "entreprises" ], "type": "string", "description": "Choose a category.\n\nChoisissez une catégorie.\n\nاختر الفئة.", "default": "all" }, "max_items": { "title": "Max offers per keyword 🔢 | Offres max par mot-clé 🔢 | الحد الأقصى لكل كلمة 🔢", "type": "integer", "description": "Maximum number of offers to fetch per keyword.\n\nNombre maximum d’annonces par mot-clé.\n\nالحد الأقصى لعدد الإعلانات لكل كلمة بحث.", "default": 60 } } }, "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 } } } } } } } } } }