{ "openapi": "3.0.1", "info": { "title": "Encuentra24 Scraper - Central America Classifieds & Autos API", "description": "Scrape Encuentra24 classifieds across Panama, Costa Rica, Nicaragua, El Salvador and Guatemala: cars, real estate, jobs and goods. Get price, currency, condition, make/model/year/mileage, beds/baths/area, location, seller and photos. Export JSON, CSV, Excel. No login or API key.", "version": "0.2", "x-build-id": "ZWt07gEJpIqRhaRzG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~encuentra24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-encuentra24-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/scrapers_lat~encuentra24-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-encuentra24-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/scrapers_lat~encuentra24-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-encuentra24-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": { "startUrl": { "title": "Search URL", "type": "string", "description": "A full Encuentra24 search results URL for any category (cars, real estate, jobs, goods), for example https://www.encuentra24.com/panama-es/autos-usados or https://www.encuentra24.com/panama-es/bienes-raices-venta-de-propiedades or any filtered search. All filters encoded in the URL (operation, type, location, price, area, bedrooms) are respected automatically. Works across every Encuentra24 country site (Panama, Costa Rica, Nicaragua, El Salvador, Guatemala)." }, "startUrls": { "title": "Search URLs (batch)", "type": "array", "description": "Optional. Multiple Encuentra24 search URLs to scrape in one run. Each item is a URL string or an object { \"url\": \"...\" }. Combine countries and categories in a single run.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "panama", "costa-rica", "nicaragua", "el-salvador", "guatemala" ], "type": "string", "description": "Optional convenience selector used only when no Search URL is given. Builds a search URL for the chosen country plus the Category below." }, "category": { "title": "Category path", "type": "string", "description": "Optional. Category path used with Country when no Search URL is given, for example autos-usados, bienes-raices-venta-de-propiedades, bienes-raices-alquiler-de-propiedades, empleos, compra-y-venta. Defaults to real estate for sale." }, "maxListings": { "title": "Max listings", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of listings to collect. Leave empty to collect all listings the search returns (paid plans). Free plans are capped at 10 per run." }, "withDetails": { "title": "Fetch listing details", "type": "boolean", "description": "When enabled, the actor emits enriched records with the full description, image gallery, typed attributes, seller identity and coordinates. When disabled, only listing-level fields are returned. Add-on for paid plans.", "default": true }, "withSummary": { "title": "AI Listing Summary", "type": "boolean", "description": "Add-on (paid plans, requires listing details). Uses AI to write a concise 2-3 sentence buyer-facing summary from the description. Billed per listing only on success.", "default": false }, "withExtract": { "title": "AI Features Extract", "type": "boolean", "description": "Add-on (paid plans, requires listing details). Uses AI to extract structured features from the description (furnished, pets allowed, amenities, condition, warranty, included services). Billed per listing only on success.", "default": false }, "keyword": { "title": "Keyword", "type": "string", "description": "Optional. Only return listings whose title, description, make, model or subcategory contain this text. Also appended to the search query when possible." }, "condition": { "title": "Condition", "type": "string", "description": "Optional. Only return listings whose condition contains this text (for example nuevo or usado)." }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Optional. Only return listings priced at or above this amount (listing currency). Leave empty for no minimum." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Optional. Only return listings priced at or below this amount. Leave empty for no maximum." }, "minBedrooms": { "title": "Min bedrooms", "minimum": 0, "type": "integer", "description": "Optional (real estate). Only return listings with at least this many bedrooms." }, "minArea": { "title": "Min area (m2)", "minimum": 0, "type": "integer", "description": "Optional (real estate). Only return listings with at least this much area in square meters." }, "minYear": { "title": "Min year", "minimum": 1900, "type": "integer", "description": "Optional (vehicles). Only return vehicles from this model year or newer." }, "maxMileage": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Optional (vehicles). Only return vehicles with at most this many kilometers." } } }, "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 } } } } } } } } } }