{ "openapi": "3.0.1", "info": { "title": "Mexico Company Complaints API - PROFECO Buró Comercial", "description": "Official consumer complaints per company in Mexico from PROFECO Buró Comercial: totals, yearly conciliation rate and top reasons for 57k+ firms.", "version": "0.2", "x-build-id": "RV9LPB7bC3rFwxFp5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/timekast~mexico-consumer-complaints-profeco/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-timekast-mexico-consumer-complaints-profeco", "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/timekast~mexico-consumer-complaints-profeco/runs": { "post": { "operationId": "runs-sync-timekast-mexico-consumer-complaints-profeco", "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/timekast~mexico-consumer-complaints-profeco/run-sync": { "post": { "operationId": "run-sync-timekast-mexico-consumer-complaints-profeco", "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": { "companies": { "title": "Companies to look up", "type": "array", "description": "Company names (legal or trade name), e.g. Telcel, Liverpool, Coppel, Elektra, Volaris. Each name returns its best matches, most complaints first. Leave empty to get the national ranking of companies by number of complaints.", "items": { "type": "string" } }, "maxMatchesPerCompany": { "title": "Max matches per name", "minimum": 1, "type": "integer", "description": "How many matching companies to return for each name (PROFECO lists branches and franchises separately).", "default": 5 }, "industry": { "title": "Industry (giro) filter", "type": "string", "description": "Optional. PROFECO industry (giro) text in Spanish; matches companies whose industry list contains it, e.g. \"AEROLÍNEA\", \"TIENDA DEPARTAMENTAL\", \"TIENDAS DE AUTOSERVICIO\". Pick a suggestion or type your own." }, "minComplaints": { "title": "Minimum total complaints", "minimum": 0, "type": "integer", "description": "Skip companies with fewer complaints than this.", "default": 0 }, "includeYearlyStats": { "title": "Include yearly statistics", "type": "boolean", "description": "Adds, per year: complaints received, concluded, conciliated, not conciliated, in progress and conciliation rate (national level).", "default": true }, "includeReasons": { "title": "Include top complaint reasons", "type": "boolean", "description": "Adds the top complaint reasons PROFECO reports for each year (e.g. refusal to honor warranty).", "default": true }, "yearsBack": { "title": "Most recent years", "minimum": 0, "type": "integer", "description": "How many of the most recent years to include (0 = all years since 2019). Ignored when \"Specific years\" is set.", "default": 3 }, "years": { "title": "Specific years (optional)", "type": "array", "description": "Exact years to include, e.g. 2024, 2025.", "items": { "type": "string", "pattern": "^20\\d\\d$" } }, "maxItems": { "title": "Max companies", "minimum": 0, "type": "integer", "description": "Stop after this many companies (0 = no limit). You pay only for companies delivered.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed normally (the source is public and reachable from Apify). Only if the source blocks the run region, enable Apify Proxy (RESIDENTIAL, country MX).", "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 } } } } } } } } } }