{ "openapi": "3.0.1", "info": { "title": "Brazil Public Tenders (PNCP) Scraper", "description": "Search open Brazilian government tenders (licitações) by keyword, state and contract value. Reads the official PNCP registry, which has no keyword search of its own. Returns buyer, city, estimated value, proposal deadline and a direct link — ready for daily bid monitoring.", "version": "0.1", "x-build-id": "KiDGB6VAbFYd9iEfA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dankhael~brazil-tenders-pncp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dankhael-brazil-tenders-pncp", "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/dankhael~brazil-tenders-pncp/runs": { "post": { "operationId": "runs-sync-dankhael-brazil-tenders-pncp", "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/dankhael~brazil-tenders-pncp/run-sync": { "post": { "operationId": "run-sync-dankhael-brazil-tenders-pncp", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Only return tenders whose object, description or buyer name contains at least one of these terms. Accent- and case-insensitive, so 'ambulancia' also matches 'ambulância'. Leave empty to return every open tender.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Discard tenders containing any of these terms. Useful for filtering out recurring false positives such as 'locacao' or 'manutencao'.", "items": { "type": "string" } }, "matchAllKeywords": { "title": "Match ALL keywords (AND)", "type": "boolean", "description": "When enabled, a tender must contain every keyword instead of just one. Use for narrow searches like ['software', 'gestao'].", "default": false }, "states": { "title": "States (UF)", "type": "array", "description": "Restrict results to these Brazilian states. Leave empty to search the whole country.", "items": { "type": "string", "enum": [ "AC", "AL", "AP", "AM", "BA", "CE", "DF", "ES", "GO", "MA", "MT", "MS", "MG", "PA", "PB", "PR", "PE", "PI", "RJ", "RN", "RS", "RO", "RR", "SC", "SP", "SE", "TO" ] } }, "modalities": { "title": "Procurement modalities", "type": "array", "description": "Which procurement modalities to search, as defined by Lei 14.133/2021. Defaults to Pregão Eletrônico (6), which covers the large majority of open tenders.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13" ], "enumTitles": [ "1 - Leilão (Eletrônico)", "2 - Diálogo Competitivo", "3 - Concurso", "4 - Concorrência (Eletrônica)", "5 - Concorrência (Presencial)", "6 - Pregão (Eletrônico)", "7 - Pregão (Presencial)", "8 - Dispensa de Licitação", "9 - Inexigibilidade", "10 - Manifestação de Interesse", "11 - Pré-qualificação", "12 - Credenciamento", "13 - Leilão (Presencial)" ] }, "default": [ "6" ] }, "minValueBRL": { "title": "Minimum estimated value (BRL)", "type": "integer", "description": "Skip tenders below this estimated value. Note: many PNCP tenders publish no value (shown as 0); setting a minimum excludes those." }, "maxValueBRL": { "title": "Maximum estimated value (BRL)", "type": "integer", "description": "Skip tenders above this estimated value. Tenders with no published value are kept." }, "daysAhead": { "title": "Proposal window (days ahead)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Include tenders whose proposal deadline falls within this many days from today.", "default": 90 }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after exporting this many matching tenders. Protects you from an unexpectedly broad keyword set.", "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 } } }, "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 } } } } } } } } } }