{
"openapi": "3.0.1",
"info": {
"title": "Mapa de Preços BR: pesquisa de preços (PNCP, IN 65/2021)",
"description": "Lista de itens → mapa de preços pronto: preços homologados no PNCP, análise crítica, média, mediana, preço estimado, memória de cálculo e planilha XLSX.",
"version": "0.7",
"x-build-id": "o0W23a2yT5uHRHONQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/peposimao~mapa-precos-br/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-peposimao-mapa-precos-br",
"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/peposimao~mapa-precos-br/runs": {
"post": {
"operationId": "runs-sync-peposimao-mapa-precos-br",
"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/peposimao~mapa-precos-br/run-sync": {
"post": {
"operationId": "run-sync-peposimao-mapa-precos-br",
"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": {
"itens": {
"title": "Itens do processo",
"type": "array",
"description": "Clique em + Add para incluir um item por vez. Só a descrição é obrigatória. Para muitos itens, use o campo abaixo e cole a lista direto do Excel. Os itens do formulário e da lista colada se somam.",
"items": {
"type": "object",
"properties": {
"descricao": {
"title": "Descrição do item",
"type": "string",
"editor": "textfield",
"description": "Como o produto costuma ser escrito em licitações. Ex.: papel A4, notebook core i5, café torrado e moído.",
"minLength": 2
},
"unidade": {
"title": "Unidade",
"type": "string",
"editor": "textfield",
"description": "Unidade em que você quer o preço. Ex.: UN, KG, L, RESMA, CX, M2. Vazio = a mais comum nos resultados."
},
"quantidade": {
"title": "Quantidade",
"type": "integer",
"editor": "number",
"description": "Quantidade a comprar (usada só no valor total). Padrão: 1.",
"minimum": 1
},
"excluir": {
"title": "Palavras para excluir",
"type": "string",
"editor": "textfield",
"description": "Separadas por vírgula. Itens licitados com essas palavras são descartados. Ex.: locação, suporte, reciclado."
},
"unidadesEquivalentes": {
"title": "Unidades equivalentes",
"type": "string",
"editor": "textfield",
"description": "Opcional, separadas por vírgula. Unidades que valem o mesmo que a pedida no seu caso. Ex.: papel A4 registrado como UN = 1 resma: informe UN."
},
"termoBusca": {
"title": "Termo de busca (opcional)",
"type": "string",
"editor": "textfield",
"description": "Use se quiser buscar no PNCP com palavras diferentes da descrição."
}
},
"required": [
"descricao"
]
}
},
"itensColados": {
"title": "Ou cole a lista do Excel",
"type": "string",
"description": "Substitua o exemplo pela sua lista. Uma linha por item, nas colunas: descrição · unidade · quantidade · palavras para excluir · unidades equivalentes. Só a descrição é obrigatória. Copie as colunas direto do Excel ou do Google Planilhas, ou separe por ponto e vírgula. Ex.:
papel A4; RESMA; 100; colorido, kraft; UN
caneta esferográfica azul; UN; 500
Cada linha é um item e é cobrada se tiver preço estimado conclusivo."
},
"nomeProcesso": {
"title": "Título do relatório",
"type": "string",
"description": "Aparece na planilha e no relatório. Ex.: \"Processo 123/2026 – Material de escritório\"."
},
"orgaoSolicitante": {
"title": "Órgão ou empresa",
"type": "string",
"description": "Opcional. Aparece no cabeçalho da planilha e do relatório."
},
"ufs": {
"title": "Estados (UF)",
"type": "array",
"description": "Siglas dos estados a considerar, ex.: SP, MG. Vazio = Brasil todo.",
"items": {
"type": "string"
}
},
"mesesAtras": {
"title": "Período (meses)",
"minimum": 1,
"maximum": 36,
"type": "integer",
"description": "Considera compras publicadas nos últimos N meses. O padrão de 12 meses acompanha o parâmetro de contratações similares do art. 5º, II, da IN 65/2021.",
"default": 12
},
"correspondencia": {
"title": "Correspondência do texto",
"enum": [
"inicio",
"proximo",
"todas_palavras"
],
"type": "string",
"description": "\"Começa com o produto\" (recomendado): a descrição do item licitado começa pelo produto pesquisado (ignorando prefixos como '[COTA RESERVADA] -' e aberturas como 'Aquisição de'), o que corta 'Envelope para papel A4' e 'Suporte para notebook'. \"Nas primeiras palavras\": as palavras aparecem no começo da descrição, em qualquer ordem. \"Em qualquer ponto\": mais resultados, mas entram itens que só citam o termo.",
"default": "inicio"
},
"analiseCritica": {
"title": "Critério de análise crítica",
"enum": [
"media_dos_demais",
"quartis",
"nenhuma"
],
"type": "string",
"description": "Como descartar preços inexequíveis e excessivamente elevados (art. 6º da IN 65/2021).",
"default": "media_dos_demais"
},
"limiteInexequivelPct": {
"title": "Inexequível abaixo de (% da média dos demais)",
"minimum": 1,
"maximum": 99,
"type": "integer",
"description": "Preço abaixo deste percentual da média dos demais é considerado inexequível. Padrão: 70.",
"default": 70
},
"limiteExcessivoPct": {
"title": "Excessivo acima de (% da média dos demais)",
"minimum": 101,
"maximum": 1000,
"type": "integer",
"description": "Preço acima deste percentual da média dos demais é considerado excessivamente elevado. Padrão: 130.",
"default": 130
},
"metodo": {
"title": "Método do preço estimado",
"enum": [
"automatico",
"media",
"mediana",
"menor"
],
"type": "string",
"description": "\"Automático\" usa a média quando a amostra é homogênea (coeficiente de variação até o limite abaixo) e a mediana quando não é.",
"default": "automatico"
},
"cvLimitePct": {
"title": "Limite do coeficiente de variação (%)",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Usado no método automático. Padrão: 25.",
"default": 25
},
"cvMaximoPct": {
"title": "Dispersão máxima aceita (CV %)",
"minimum": 5,
"maximum": 1000,
"type": "integer",
"description": "Se, após a análise crítica, o coeficiente de variação dos preços válidos passar deste valor, o item sai como 'revisar' e não é cobrado: provavelmente há produtos ou unidades misturados. Padrão: 50.",
"default": 50
},
"minPrecos": {
"title": "Mínimo de preços válidos por item",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "Abaixo disso o item sai como 'preços insuficientes' e não é cobrado. O art. 6º da IN 65/2021 pede 3 ou mais.",
"default": 3
},
"maxPrecosPorItem": {
"title": "Máximo de preços por item",
"minimum": 3,
"maximum": 200,
"type": "integer",
"description": "Para a coleta quando atingir este número de preços. Compras mais recentes vêm primeiro.",
"default": 30
},
"maxPrecosPorCompra": {
"title": "Máximo de preços por compra",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "Quantos preços uma mesma licitação pode contribuir para um item. Evita que um único pregão com vários lotes domine a amostra. Padrão: 3.",
"default": 3
},
"maxComprasPorItem": {
"title": "Máximo de compras lidas por item",
"minimum": 5,
"maximum": 500,
"type": "integer",
"description": "Limite de segurança do tempo de execução. Cada compra leva alguns segundos para ser lida no PNCP.",
"default": 60
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Opcional. Use apenas se o PNCP começar a bloquear as requisições.",
"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
}
}
}
}
}
}
}
}
}
}