{ "openapi": "3.0.1", "info": { "title": "Latin America Company Database & Leads — 7 Official Registries", "description": "Search 19.8M 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.3", "x-build-id": "ylDsUdeJiJjxb7U4S" }, "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 and Mexico; 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 }, "only_with_public_contact": { "title": "Only with a public company contact (Brazil, Mexico, Colombia)", "type": "boolean", "description": "Keep companies with a role e-mail (contato@, ventas@...), a company phone or a social profile published on their own website (the same contact layers as the Brazil, Mexico and Colombia finders). Other countries have no contact layer and are left out when this is on.", "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: a date filter leaves Peru out (see OUTPUT.date_filter_note)." }, "registered_before": { "title": "Registered on or before", "type": "string", "description": "YYYY-MM-DD, on registration_date." }, "registered_in_last_days": { "title": "Registered in the last N days", "minimum": 1, "type": "integer", "description": "Companies registered in the N days up to each country's data as-of date (OUTPUT.data_as_of_by_country), not up to today: each registry is refreshed on its own schedule. Use it in a schedule for new-company lists. Peru has no date and is left out; Mexico's date is the month the establishment entered DENUE." }, "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 25 when called via API without this field (set it for more).", "default": 25 } } }, "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 } } } } } } } } } }