{
"openapi": "3.0.1",
"info": {
"title": "Ouedkniss Boutiques Scraper",
"description": "Collect Ouedkniss boutique (shop) profiles with location, categories and contact details.",
"version": "0.1",
"x-build-id": "QYcM3zSVFxymOVMof"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/harpoon~ouedkniss-boutiques-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-harpoon-ouedkniss-boutiques-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/harpoon~ouedkniss-boutiques-scraper/runs": {
"post": {
"operationId": "runs-sync-harpoon-ouedkniss-boutiques-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/harpoon~ouedkniss-boutiques-scraper/run-sync": {
"post": {
"operationId": "run-sync-harpoon-ouedkniss-boutiques-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": {
"ai_prompt": {
"title": "Your request",
"type": "string",
"description": "e.g. real estate agencies in Alger, car showrooms in Oran, or top 50 electronics shops. When set, it overrides the manual search fields below."
},
"search_query": {
"title": "Search keyword",
"type": "string",
"description": "Match boutique names and descriptions. Keep it short for the best capture rate, e.g. immobilier or meuble. Leave empty to browse all boutiques in the chosen category and wilayas."
},
"category": {
"title": "Category",
"enum": [
"",
"agences_immobilieres",
"promotions_immobilieres",
"showroom_automobiles",
"showroom_moto",
"camions_engins",
"pieces_accessoires_vehicules",
"location_de_voitures",
"reparation_services_vehicules",
"telephones_accessoires",
"magasin_dinformatique",
"magasin_delectromenager",
"equipements_de_securite",
"audiovisuel",
"electronique",
"vetements_accessoires_de_mode",
"cosmetiques_beaute",
"maison_meubles",
"meubles_de_bureau",
"vaisselles",
"puericultures_jouets",
"jardinage",
"fournitures_articles_scolaires",
"articles_de_sport",
"consoles_jeux_video",
"librairie_papeterie",
"instruments_de_musique",
"chasse_peche",
"outillages_quincaillerie",
"materiaux_de_construction",
"materiel_professionnel",
"matieres_premieres",
"agences_de_voyages",
"animalerie",
"alimentaire",
"transport_demenagement",
"travaux_de_construction_damenagement",
"ecoles_formations",
"publicite_communication",
"service_de_nettoyage_entretien",
"froid_climatisation",
"traiteur_gateaux",
"hotels",
"restaurants_salles_des_fetes",
"services_de_sante",
"etudes_consulting",
"logiciel_web_services",
"esthetique_bien_etre",
"comptabilite_finance",
"couture_confection",
"reparation_electronique_electromenager"
],
"type": "string",
"description": "Restrict results to one shop category. All categories searches the full directory.",
"default": ""
},
"regions": {
"title": "Wilayas",
"uniqueItems": true,
"type": "array",
"description": "Optional. Pick one or more Algerian wilayas (provinces). Nothing selected means the whole country.",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"30",
"31",
"32",
"33",
"34",
"35",
"36",
"37",
"38",
"39",
"40",
"41",
"42",
"43",
"44",
"45",
"46",
"47",
"48",
"49",
"50",
"51",
"52",
"53",
"54",
"55",
"56",
"57",
"58"
],
"enumTitles": [
"Adrar",
"Chlef",
"Laghouat",
"Oum El Bouaghi",
"Batna",
"Béjaïa",
"Biskra",
"Béchar",
"Blida",
"Bouira",
"Tamanrasset",
"Tébessa",
"Tlemcen",
"Tiaret",
"Tizi Ouzou",
"Alger",
"Djelfa",
"Jijel",
"Sétif",
"Saïda",
"Skikda",
"Sidi Bel Abbès",
"Annaba",
"Guelma",
"Constantine",
"Médéa",
"Mostaganem",
"M'Sila",
"Mascara",
"Ouargla",
"Oran",
"El Bayadh",
"Illizi",
"Bordj Bou Arreridj",
"Boumerdès",
"El Tarf",
"Tindouf",
"Tissemsilt",
"El Oued",
"Khenchela",
"Souk Ahras",
"Tipaza",
"Mila",
"Aïn Defla",
"Naâma",
"Aïn Témouchent",
"Ghardaïa",
"Relizane",
"Timimoun",
"Bordj Badji Mokhtar",
"Ouled Djellal",
"Béni Abbès",
"In Salah",
"In Guezzam",
"Touggourt",
"Djanet",
"El Meghaier",
"El Menia"
]
},
"default": []
},
"max_results": {
"title": "Max boutiques",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Hard cap on the number of boutiques returned. Higher values take longer and increase cost.",
"default": 100
},
"language": {
"title": "Result language",
"enum": [
"en",
"fr",
"ar"
],
"type": "string",
"description": "Language used for wilayah/city names and text. Choose the language you want the data in.",
"default": "en"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}