hexadatalabs/mexico-business-directory-denue
hexadatalabs--mexico-business-directory-denueDestructive
This tool calls the Actor "hexadatalabs/mexico-business-directory-denue" and retrieves its output results. Actor description: Search Mexico's official business directory DENUE (INEGI) by keyword, state, municipality, SCIAN activity code or geographic radius. Returns 5+ million establishments with activity, employee size, full address and coordinates via INEGI's official API. Pay per result.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "hexadatalabs--mexico-business-directory-denue"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Two-digit INEGI state code. 00 = whole country. Example values: "00" | 00 |
| keyword | No | Word(s) to search in Spanish, used by the keyword and radius modes. INEGI matches them against the business name, legal name, street, neighborhood, activity class, state, municipality and locality (for example "dentista", "restaurantes", "ferreteria", "hotel", "farmacia"); separate several words with a comma ("consultorios,dentales"). Use "todos" for everything. [Description truncated] Example values: "dentista" | todos |
| latitude | No | Center of a radius search, e.g. 19.4326 (decimal degrees; a decimal comma is accepted). Set latitude, longitude and radiusMeters to search around a point instead of by area; both coordinates are required. | |
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| longitude | No | e.g. -99.1332 (decimal degrees, negative for Mexico). Required together with latitude. | |
| inegiToken | No | Your own free DENUE API token from https://www.inegi.org.mx/app/desarrolladores/generatoken/Usuarios/token_Verify . Leave empty to use the Actor's shared token, which all users of this Actor share and INEGI rate-limits; for large or scheduled jobs request your own. | |
| maxResults | No | Stop after this many establishments. You are charged per result, so this caps the cost. Example values: 500 | |
| nameFilter | No | Substring of the establishment's trade name, e.g. "oxxo". Setting it switches to area mode (state + optional municipality / activityCode / employeeStratum), so "state" 19 + nameFilter "oxxo" returns every OXXO in Nuevo León. Cannot be combined with keyword or with a radius search. | |
| activityCode | No | North American Industry Classification (SCIAN/NAICS) code with 2 to 6 digits: 2 = sector (e.g. 72 food services), 3 = subsector, 4 = industry group (rama), 6 = class (e.g. 722511 full-service restaurants). Narrows the search to that activity. | |
| municipality | No | Three-digit INEGI municipality code inside the selected state (for example 039 = Monterrey in Nuevo León 19, 015 = Cuauhtémoc in Ciudad de México 09). Requires a state. Find codes at https://www.inegi.org.mx/app/ageeml/ | |
| radiusMeters | No | Radius around the point for the radius search (only used when latitude and longitude are set). INEGI allows up to 5000 m. Example values: 1000 | |
| employeeStratum | No | Filter by number of employees (INEGI stratum). Only applies to area searches (state / municipality / activity code). | |
| includeContactFields | No | DENUE publishes the establishment's phone, email and website. They are omitted by default; turn this on only if you have a lawful basis to use business contact data. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Advisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key | |
| runId | Yes | Actor run ID | |
| stats | No | Run statistics | |
| status | Yes | Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED | |
| actorId | Yes | Stable Apify Actor ID from the run record | |
| summary | Yes | Past-tense summary of the run state | |
| exitCode | No | Actor process exit code; populated for terminal states (especially FAILED) | |
| nextStep | Yes | One primary follow-up action with identifiers interpolated | |
| storages | Yes | Dataset and key-value store metadata, keyed by alias. "default" is always the primary entry. | |
| actorName | No | "username/actor-name" | |
| startedAt | No | ISO timestamp when the run started | |
| finishedAt | No | ISO timestamp when the run finished (terminal states only) | |
| statusMessage | No | Pass-through from Apify run.statusMessage | |
| apifyConsoleUrl | No | Personalized Apify Console link to the run; present only for Console sessions |