{ "openapi": "3.0.1", "info": { "title": "Chile Company RUT Lookup — SII Company Data", "description": "Look up Chilean companies by RUT or search by name, activity, comuna and size: legal name, start/end dates, SII activity codes, addresses, size bracket, employees and registry capital. Legal entities only, official SII open data. Pay per result, no subscription.", "version": "0.1", "x-build-id": "LhnUbstV8WIU8V3px" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fabrikit~chile-company-rut-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fabrikit-chile-company-rut-lookup", "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/fabrikit~chile-company-rut-lookup/runs": { "post": { "operationId": "runs-sync-fabrikit-chile-company-rut-lookup", "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/fabrikit~chile-company-rut-lookup/run-sync": { "post": { "operationId": "run-sync-fabrikit-chile-company-rut-lookup", "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": { "mode": { "title": "Mode", "enum": [ "lookup", "search" ], "type": "string", "description": "`lookup` = enrich a list of company RUTs (one record per RUT, including not-found ones). `search` = find companies by name, activity, comuna/region, size, entity type and start date.", "default": "lookup" }, "ruts": { "title": "Company RUTs (lookup mode)", "type": "array", "description": "One RUT per line, in any format: `76.123.456-7`, `76123456-7`, `761234567`, `61704000K`, or the number alone (`76123456`). Several RUTs on one line separated by spaces or semicolons also work. The check digit (DV) is validated; RUTs in the natural-person range (below 45,000,000) are rejected without lookup. Up to 100,000 RUTs per run.", "default": [ "90.749.000-9", "93834000-5", "61.704.000-K", "96806980-2", "76086428-5" ], "items": { "type": "string" } }, "nameContains": { "title": "Name contains", "type": "string", "description": "Words that must all appear in the legal name (razón social), in any order; accents and case are ignored. Example: `constructora sur`." }, "activities": { "title": "Economic activities", "type": "array", "description": "A company matches if ANY of its registered SII activities matches ANY entry. Each entry can be a 6-digit SII code (`620100`), a code prefix (`62` = all IT services, `4923` = road freight), Spanish words from the SII description (`transporte carga`), or a plain-language keyword such as `software`, `restaurant`, `construction`, `real estate`, `mining`, `logistics`, `accounting`, `law firm`, `marketing`, `health`, `education`, `ecommerce`. The run log shows which codes each entry matched.", "items": { "type": "string" } }, "comunas": { "title": "Comunas", "type": "array", "description": "Comuna of the head office (e.g. `Las Condes`, `Providencia`, `Viña del Mar`, `Ñuñoa`). Accents and case are ignored. A company matches if it is in ANY of the listed comunas.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Region of the head office. A company matches if it is in ANY selected region.", "items": { "type": "string", "enum": [ "15", "1", "2", "3", "4", "5", "13", "6", "7", "16", "8", "9", "14", "10", "11", "12" ], "enumTitles": [ "XV Arica y Parinacota", "I Tarapacá", "II Antofagasta", "III Atacama", "IV Coquimbo", "V Valparaíso", "RM Metropolitana de Santiago", "VI O'Higgins", "VII Maule", "XVI Ñuble", "VIII Biobío", "IX La Araucanía", "XIV Los Ríos", "X Los Lagos", "XI Aysén", "XII Magallanes" ] } }, "matchBranchComunas": { "title": "Also match branch locations", "type": "boolean", "description": "When on, the comuna/region filters also match companies that have a current branch (sucursal) there, not only the head office.", "default": false }, "entityTypes": { "title": "Entity types", "type": "array", "description": "Legal form groups (from the SII subtype). Leave empty for all legal entities.", "items": { "type": "string", "enum": [ "spa", "ltda", "eirl", "sa", "other_commercial", "financial", "foreign", "public", "international", "nonprofit" ], "enumTitles": [ "SpA (sociedad por acciones)", "Ltda. (responsabilidad limitada)", "EIRL", "S.A. (open, closed, special)", "Other commercial partnerships", "Banks, insurers, pension funds, investment & mutual funds", "Foreign entities & branches", "Public bodies & municipalities", "International organizations & embassies", "Non-profits (foundations, corporations, unions, cooperatives...)" ] } }, "companySizes": { "title": "Company size", "type": "array", "description": "SII size category from annual sales (latest commercial year published, currently 2024). `unknown` = the company is not in the SII size list (e.g. created after that year or not classified as a company).", "items": { "type": "string", "enum": [ "micro", "small", "medium", "large", "no_sales_info", "unknown" ], "enumTitles": [ "Micro (up to 2,400 UF/yr)", "Small (2,400–25,000 UF/yr)", "Medium (25,000–100,000 UF/yr)", "Large (over 100,000 UF/yr)", "Classified, but no sales information", "Not in the size list" ] } }, "minEmployees": { "title": "Min. employees", "minimum": 0, "type": "integer", "description": "Minimum number of dependent workers reported to the SII (latest commercial year). Companies without size data are excluded when this is set." }, "maxEmployees": { "title": "Max. employees", "minimum": 0, "type": "integer", "description": "Maximum number of dependent workers reported to the SII (latest commercial year)." }, "startDateFrom": { "title": "Started activities from", "type": "string", "description": "Earliest start-of-activities date (inicio de actividades), YYYY-MM-DD. Use with `Newest first` to get recently created companies." }, "startDateTo": { "title": "Started activities until", "type": "string", "description": "Latest start-of-activities date, YYYY-MM-DD." }, "status": { "title": "Status", "enum": [ "active", "closed", "any" ], "type": "string", "description": "`active` = no termination of business (término de giro) registered. `closed` = término de giro registered.", "default": "active" }, "sortBy": { "title": "Sort by", "enum": [ "rut", "newest", "oldest", "employees" ], "type": "string", "description": "`rut` is fastest (stops as soon as Max results is reached). The other orders scan all ~3.2 million companies first (about a minute).", "default": "rut" }, "maxItems": { "title": "Max results (search mode)", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many companies in search mode. Lookup mode always returns one record per unique input RUT.", "default": 50 }, "includeBranches": { "title": "Include branch addresses", "type": "boolean", "description": "Add the list of current branches (sucursales) registered with the SII to each record (up to 200 per company; `branchCount` always has the total).", "default": true }, "dataSource": { "title": "Data source", "enum": [ "auto", "snapshot", "live" ], "type": "string", "description": "`auto` answers from the snapshot bundled with the actor and, for lookups, switches to the live SII files automatically if the SII has published a newer version. `snapshot` never downloads anything (fastest). `live` always streams the current SII files for lookups (~190 MB download, 1–2 minutes); search mode always uses the snapshot.", "default": "auto" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Only used when the actor downloads the live SII files. The SII serves these files to any client, so no proxy is needed by default.", "default": { "useApifyProxy": 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 } } } } } } } } } }