{ "openapi": "3.0.1", "info": { "title": "LATAM Company Finder: 7 Countries, ISIC, English Labels", "description": "Search 19.7M companies from the official registries of Brazil, Mexico, Chile, Colombia, Peru, Argentina and Ecuador in one English schema: ISIC Rev.4 industry, region, city, size, status, websites and corporate e-mail domains. Company data only.", "version": "0.1", "x-build-id": "7Yhvnnc3jIZvA1PA9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/latsouth~latam-company-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-latsouth-latam-company-finder", "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/latsouth~latam-company-finder/runs": { "post": { "operationId": "runs-sync-latsouth-latam-company-finder", "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/latsouth~latam-company-finder/run-sync": { "post": { "operationId": "run-sync-latsouth-latam-company-finder", "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": { "countries": { "title": "Countries", "type": "array", "description": "Leave empty for all 7 countries. Selecting countries makes runs faster.", "items": { "type": "string", "enum": [ "BR", "MX", "CL", "CO", "PE", "AR", "EC" ], "enumTitles": [ "BR - Brazil (Receita Federal CNPJ)", "MX - Mexico (INEGI DENUE, legal entities)", "CL - Chile (RES + SII)", "CO - Colombia (RUES + Supersociedades)", "PE - Peru (SUNAT Padron RUC)", "AR - Argentina (Registro Nacional de Sociedades)", "EC - Ecuador (SRI Catastro RUC)" ] } }, "isic_sections": { "title": "Industry sections (ISIC Rev.4)", "type": "array", "description": "ISIC Rev.4 sections (the UN industry standard every country's code was mapped to). Combined with divisions using OR.", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U" ], "enumTitles": [ "A - Agriculture, forestry and fishing", "B - Mining and quarrying", "C - Manufacturing", "D - Electricity, gas, steam and air conditioning supply", "E - Water supply; sewerage, waste management and remediation activities", "F - Construction", "G - Wholesale and retail trade; repair of motor vehicles and motorcycles", "H - Transportation and storage", "I - Accommodation and food service activities", "J - Information and communication", "K - Financial and insurance activities", "L - Real estate activities", "M - Professional, scientific and technical activities", "N - Administrative and support service activities", "O - Public administration and defence; compulsory social security", "P - Education", "Q - Human health and social work activities", "R - Arts, entertainment and recreation", "S - Other service activities", "T - Activities of households as employers; undifferentiated goods- and services-producing activities of households for own use", "U - Activities of extraterritorial organizations and bodies" ] } }, "isic_divisions": { "title": "Industry divisions (ISIC Rev.4, 2-digit)", "type": "array", "description": "ISIC Rev.4 divisions, e.g. 62 = computer programming and IT consultancy, 70 = management consultancy, 46 = wholesale trade.", "items": { "type": "string", "enum": [ "01", "02", "03", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "35", "36", "37", "38", "39", "41", "42", "43", "45", "46", "47", "49", "50", "51", "52", "53", "55", "56", "58", "59", "60", "61", "62", "63", "64", "65", "66", "68", "69", "70", "71", "72", "73", "74", "75", "77", "78", "79", "80", "81", "82", "84", "85", "86", "87", "88", "90", "91", "92", "93", "94", "95", "96", "97", "98", "99" ], "enumTitles": [ "01 - Crop and animal production, hunting and related service activities", "02 - Forestry and logging", "03 - Fishing and aquaculture", "05 - Mining of coal and lignite", "06 - Extraction of crude petroleum and natural gas", "07 - Mining of metal ores", "08 - Other mining and quarrying", "09 - Mining support service activities", "10 - Manufacture of food products", "11 - Manufacture of beverages", "12 - Manufacture of tobacco products", "13 - Manufacture of textiles", "14 - Manufacture of wearing apparel", "15 - Manufacture of leather and related products", "16 - Manufacture of wood and of products of wood and cork, except furniture; manufacture of articles of straw and plaiting materials", "17 - Manufacture of paper and paper products", "18 - Printing and reproduction of recorded media", "19 - Manufacture of coke and refined petroleum products", "20 - Manufacture of chemicals and chemical products", "21 - Manufacture of basic pharmaceutical products and pharmaceutical preparations", "22 - Manufacture of rubber and plastics products", "23 - Manufacture of other non-metallic mineral products", "24 - Manufacture of basic metals", "25 - Manufacture of fabricated metal products, except machinery and equipment", "26 - Manufacture of computer, electronic and optical products", "27 - Manufacture of electrical equipment", "28 - Manufacture of machinery and equipment n.e.c.", "29 - Manufacture of motor vehicles, trailers and semi-trailers", "30 - Manufacture of other transport equipment", "31 - Manufacture of furniture", "32 - Other manufacturing", "33 - Repair and installation of machinery and equipment", "35 - Electricity, gas, steam and air conditioning supply", "36 - Water collection, treatment and supply", "37 - Sewerage", "38 - Waste collection, treatment and disposal activities; materials recovery", "39 - Remediation activities and other waste management services", "41 - Construction of buildings", "42 - Civil engineering", "43 - Specialized construction activities", "45 - Wholesale and retail trade and repair of motor vehicles and motorcycles", "46 - Wholesale trade, except of motor vehicles and motorcycles", "47 - Retail trade, except of motor vehicles and motorcycles", "49 - Land transport and transport via pipelines", "50 - Water transport", "51 - Air transport", "52 - Warehousing and support activities for transportation", "53 - Postal and courier activities", "55 - Accommodation", "56 - Food and beverage service activities", "58 - Publishing activities", "59 - Motion picture, video and television programme production, sound recording and music publishing activities", "60 - Programming and broadcasting activities", "61 - Telecommunications", "62 - Computer programming, consultancy and related activities", "63 - Information service activities", "64 - Financial service activities, except insurance and pension funding", "65 - Insurance, reinsurance and pension funding, except compulsory social security", "66 - Activities auxiliary to financial service and insurance activities", "68 - Real estate activities", "69 - Legal and accounting activities", "70 - Activities of head offices; management consultancy activities", "71 - Architectural and engineering activities; technical testing and analysis", "72 - Scientific research and development", "73 - Advertising and market research", "74 - Other professional, scientific and technical activities", "75 - Veterinary activities", "77 - Rental and leasing activities", "78 - Employment activities", "79 - Travel agency, tour operator, reservation service and related activities", "80 - Security and investigation activities", "81 - Services to buildings and landscape activities", "82 - Office administrative, office support and other business support activities", "84 - Public administration and defence; compulsory social security", "85 - Education", "86 - Human health activities", "87 - Residential care activities", "88 - Social work activities without accommodation", "90 - Creative, arts and entertainment activities", "91 - Libraries, archives, museums and other cultural activities", "92 - Gambling and betting activities", "93 - Sports activities and amusement and recreation activities", "94 - Activities of membership organizations", "95 - Repair of computers and personal and household goods", "96 - Other personal service activities", "97 - Activities of households as employers of domestic personnel", "98 - Undifferentiated goods- and services-producing activities of private households for own use", "99 - Activities of extraterritorial organizations and bodies" ] } }, "keyword": { "title": "Keyword", "type": "string", "description": "Case- and accent-insensitive substring searched in the English and local activity labels and in the legal and trade names (e.g. software, logistica, clinic)." }, "regions": { "title": "Regions (state / department / province)", "type": "array", "description": "Region names, accents optional (Sao Paulo, Jalisco, Antioquia, Lima, Cordoba, Pichincha, Metropolitana de Santiago), or ISO 3166-2 codes (BR-SP, MX-JAL, CO-ANT, PE-LMA, AR-X, EC-P, CL-RM).", "items": { "type": "string" } }, "cities": { "title": "Cities / municipalities", "type": "array", "description": "City as each registry publishes it, accents optional: BR municipio, MX municipio, CL comuna, CO municipio, PE province, AR localidad, EC canton (e.g. Sao Paulo, Monterrey, Providencia, Medellin, Lima, Rosario, Guayaquil).", "items": { "type": "string" } }, "size_class": { "title": "Company size class", "type": "array", "description": "Harmonized size (rule per country in the README: revenue bands in BR/CL/CO, employees in MX/PE). Argentina and Ecuador publish no size.", "items": { "type": "string", "enum": [ "micro", "small", "medium", "large", "unknown" ], "enumTitles": [ "Micro", "Small", "Medium", "Large", "Unknown (no size in the source)" ] } }, "only_active": { "title": "Only active companies", "type": "boolean", "description": "Keep companies the registry reports as active. Argentina publishes no status: there it keeps companies with at least one active tax activity.", "default": true }, "exclude_public_sector": { "title": "Exclude public sector", "type": "boolean", "description": "Leave out government bodies, state-owned companies and international organizations.", "default": true }, "exclude_sole_owner": { "title": "Exclude sole-owner / person-named entities", "type": "boolean", "description": "Leave out sole-owner companies (EIRL, unipersonal, EIRELI) and entities whose name is a person's name. Their names are masked (***) anyway.", "default": true }, "only_headquarters": { "title": "Only headquarters (Brazil)", "type": "boolean", "description": "Brazil lists branches as separate CNPJs; keep only the head office. Other countries are already one row per company.", "default": false }, "only_with_website": { "title": "Only with a website (declared or guessed)", "type": "boolean", "description": "Keep companies with a `website` (declared to the registry, or HTTP-verified in Brazil) OR a `website_guess` (a domain derived from the company's registered corporate e-mail, NOT checked over HTTP). Brazil, Mexico and Colombia only; free-mail, ISP and placeholder domains (gmail, prodigy.net.mx, contacto.com, ...) never count.", "default": false }, "only_with_verified_website": { "title": "Only with an HTTP-verified website", "type": "boolean", "description": "Stricter: keep only companies whose `website` answered an HTTP check (2xx/3xx, not parked, for sale or a hosting default page). Brazil only today; other countries return no rows with this on.", "default": false }, "only_with_corporate_email_domain": { "title": "Only with a corporate e-mail domain", "type": "boolean", "description": "Keep companies whose registered e-mail uses their own domain (not Gmail/Hotmail/ISP/placeholder). Only the domain is returned, never the e-mail address. Brazil, Mexico and Colombia publish e-mails.", "default": false }, "registered_after": { "title": "Registered on or after", "type": "string", "description": "YYYY-MM-DD, on registration_date (opening/incorporation date; see registration_date_basis per country). Peru has no date." }, "registered_before": { "title": "Registered on or before", "type": "string", "description": "YYYY-MM-DD, on registration_date." }, "sort_by": { "title": "Sort by", "enum": [ "size_desc", "registration_date_desc", "registration_date_asc", "country_tax_id" ], "type": "string", "description": "Order of results.", "default": "size_desc" }, "max_results_per_country": { "title": "Max results per country", "minimum": 1, "type": "integer", "description": "Optional cap per country, for a balanced multi-country sample (e.g. 2 per country x 7 countries = 14 rows)." }, "max_results": { "title": "Max results", "minimum": 1, "maximum": 500000, "type": "integer", "description": "You pay per company returned (US$0.004 each: 1,000 companies = US$4). The run also stops at your spending limit. Default 1,000 when called via API without this field.", "default": 1000 } } }, "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 } } } } } } } } } }