{ "openapi": "3.0.1", "info": { "title": "Panama Emprende Scraper | Company Registry RUC API", "description": "Scrape the Panama Emprende business registry (aviso de operacion) by name, owner, RUC or notice number. Get company name, RUC, legal representative, activity, invested capital, status, province, district and address for KYB and B2B leads. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "vLqwdVh9zaYXkXP2M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~panama-emprende-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-panama-emprende-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~panama-emprende-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-panama-emprende-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~panama-emprende-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-panama-emprende-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", "required": [ "query" ], "properties": { "searchType": { "title": "Search By", "enum": [ "razon_comercial", "razon_social_dueno", "cedula_ruc", "numero_aviso" ], "type": "string", "description": "Which field to search the registry by. Pick the one that matches the value you provide below.", "default": "razon_comercial" }, "query": { "title": "Query", "type": "string", "description": "The text to search for. For 'Commercial name' or 'Owner name' use words like SUPER or a surname. For 'ID or RUC' use a value like 8-355-654. For 'Operation notice number' use a value like 8-355-654-2007-51." }, "personType": { "title": "Person Type", "enum": [ "any", "natural", "juridica" ], "type": "string", "description": "Restrict results to natural persons or legal entities. Use 'Any' to include both.", "default": "any" }, "maxCompanies": { "title": "Max companies", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of company records to collect. Free Apify plans are capped at 10 per run." }, "withDetails": { "title": "Fetch Details", "type": "boolean", "description": "When enabled, the scraper opens each company's detail page to add owner / legal representative, RUC, activity, capital, province / district / corregimiento, full address, cancellation date and reason. When disabled, only the fast listing-level fields are returned. Detail extraction is available on paid Apify plans.", "default": true }, "filterStatus": { "title": "Filter: status", "type": "string", "description": "Optional. Keep only records whose status matches this text, for example Vigente or Cancelado. Case and accent insensitive. Leave blank to keep all." }, "filterProvince": { "title": "Filter: province", "type": "string", "description": "Optional. Keep only records located in this province, for example PANAMA or CHIRIQUI. Case and accent insensitive." }, "filterActivity": { "title": "Filter: activity contains", "type": "string", "description": "Optional. Keep only records whose declared activity contains this text, for example FARMACIA or IMPORTACION. Case and accent insensitive." }, "startDateFrom": { "title": "Filter: start date from", "type": "string", "description": "Optional. Keep only records with an operation start date on or after this date (YYYY-MM-DD)." }, "startDateTo": { "title": "Filter: start date to", "type": "string", "description": "Optional. Keep only records with an operation start date on or before this date (YYYY-MM-DD)." } } }, "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 } } } } } } } } } }