PNCP Tender Scraper

Extract PNCP procurement notices for tender discovery, buyer research and procurement monitoring. PNCP Tender Scraper collects public information into one complete dataset table, ready to export as Excel, CSV or JSON.

Use search filters or individual public record links, set how many results you need and start the Actor. Search finds matching records; Details retrieves the available information for records you already know.

At a glance	Details
📥 Input	Search filters or individual public record links
📋 Collection modes	Search tender records; Get tender details
📤 Output	One row per record, or a failed row for an unsuccessful input
📄 Pagination	Automatic, up to maxResults while more records are available
🔐 Website login	Not required
💾 Export	One dataset view with all fields; Excel, CSV and JSON

What the PNCP scraper collects 📋

Mode	What you receive
Search tender records	Matching procurement notices and the fields published in the search results.
Get tender details	Available public information for each supplied record. The full output example below shows its actual fields.

The field table and complete examples below show the information this Actor returns. Optional values depend on what the source publishes for the selected record.

Coverage for this Actor:

• Search covers procurement notices currently accepting proposals.

How to scrape PNCP 🚀

1. Choose Search tender records or Get tender details.
2. Complete the search filters or individual public record links.
3. Set Maximum results. The minimum is 1.
4. Start the Actor and review the saved dataset.
5. Export the results or connect them to your workflow.

Search tender records — input example

{
  "mode": "search",
  "maxResults": 10
}

Get tender details — input example

{
  "mode": "details",
  "recordUrls": [
    "https://pncp.gov.br/app/compras/04696490000163/2026/136"
  ],
  "maxResults": 1
}

maxResults limits all saved rows for each search or supplied record, including a failed row. It does not guarantee that the source has that many matching records. A detail lookup normally returns one record, although sources with multiple revisions or establishments can return more.

PNCP data fields and complete output 📦

Each result stays in one row. Every returned field appears in the same dataset view, including list fields and additional published facts. Fields unavailable for a particular record remain empty.

Field	Included data
result_type	Selected collection mode.
input	Submitted search settings, record link or record number.
status	Success or failed outcome.
error_code	Failure category for an unsuccessful input.
error_message	Readable explanation for an unsuccessful input.
title	Title, when published.
description	Description, when published.
document_type	Document type, when published.
created_at	Created at, when published.
numero	Numero, when published.
ano	Ano, when published.
numero_sequencial	Numero sequencial, when published.
numero_sequencial_compra_ata	Numero sequencial compra ata, when published.
numero_controle_pncp	Numero controle pncp, when published.
orgao_id	Orgao id, when published.
orgao_cnpj	Orgao cnpj, when published.
orgao_nome	Orgao nome, when published.
orgao_subrogado_id	Orgao subrogado id, when published.
orgao_subrogado_nome	Orgao subrogado nome, when published.
unidade_id	Unidade id, when published.
unidade_codigo	Unidade codigo, when published.
unidade_nome	Unidade nome, when published.
esfera_id	Esfera id, when published.
esfera_nome	Esfera nome, when published.
poder_id	Poder id, when published.
poder_nome	Poder nome, when published.
municipio_id	Municipio id, when published.
municipio_nome	Municipio nome, when published.
uf	Uf, when published.
modalidade_licitacao_id	Modalidade licitacao id, when published.
modalidade_licitacao_nome	Modalidade licitacao nome, when published.
situacao_id	Situacao id, when published.
situacao_nome	Situacao nome, when published.
data_publicacao_pncp	Data publicacao pncp, when published.
data_atualizacao_pncp	Data atualizacao pncp, when published.
data_assinatura	Data assinatura, when published.
data_inicio_vigencia	Data inicio vigencia, when published.
data_fim_vigencia	Data fim vigencia, when published.
cancelado	Cancelado, when published.
valor_global	Valor global, when published.
tem_resultado	Tem resultado, when published.
tipo_id	Tipo id, when published.
tipo_nome	Tipo nome, when published.
tipo_contrato_id	Tipo contrato id, when published.
tipo_contrato_nome	Tipo contrato nome, when published.
fonte_orcamentaria	Fonte orcamentaria, when published.
fonte_orcamentaria_id	Fonte orcamentaria id, when published.
fonte_orcamentaria_nome	Fonte orcamentaria nome, when published.
exigencia_conteudo_nacional	Exigencia conteudo nacional, when published.
permite_adesao	Permite adesao, when published.
possui_emenda_parlamentar	Possui emenda parlamentar, when published.
tipo_margem_preferencia	Tipo margem preferencia, when published.
tipo_margem_preferencia_id	Tipo margem preferencia id, when published.
tipo_margem_preferencia_nome	Tipo margem preferencia nome, when published.
tipo_item_irp	Tipo item irp, when published.
prazo_manifestacao_interesse	Prazo manifestacao interesse, when published.
aplicabilidade_margem_preferencia	Aplicabilidade margem preferencia, when published.
record_id	Stable identifier for the source record.
url	Public source link when the website provides one.
additional_fields.name	Names of additional published fields, when present.
additional_fields.value	Their corresponding values in the same order.
valor_total_estimado	Valor total estimado, when published.
valor_total_homologado	Valor total homologado, when published.
orcamento_sigiloso_codigo	Orcamento sigiloso codigo, when published.
orcamento_sigiloso_descricao	Orcamento sigiloso descricao, when published.
link_sistema_origem	Link sistema origem, when published.
link_processo_eletronico	Link processo eletronico, when published.
ano_compra	Ano compra, when published.
sequencial_compra	Sequencial compra, when published.
numero_compra	Numero compra, when published.
processo	Processo, when published.
orgao_entidade.cnpj	Orgao entidade / cnpj, when published.
orgao_entidade.razao_social	Orgao entidade / razao social, when published.
orgao_entidade.poder_id	Orgao entidade / poder id, when published.
orgao_entidade.esfera_id	Orgao entidade / esfera id, when published.
unidade_orgao.uf_nome	Unidade orgao / uf nome, when published.
unidade_orgao.uf_sigla	Unidade orgao / uf sigla, when published.
unidade_orgao.municipio_nome	Unidade orgao / municipio nome, when published.
unidade_orgao.codigo_ibge	Unidade orgao / codigo ibge, when published.
unidade_orgao.codigo_unidade	Unidade orgao / codigo unidade, when published.
unidade_orgao.nome_unidade	Unidade orgao / nome unidade, when published.
orgao_sub_rogado	Orgao sub rogado, when published.
unidade_sub_rogada	Unidade sub rogada, when published.
modalidade_id	Modalidade id, when published.
modalidade_nome	Modalidade nome, when published.
justificativa_presencial	Justificativa presencial, when published.
modo_disputa_id	Modo disputa id, when published.
modo_disputa_nome	Modo disputa nome, when published.
tipo_instrumento_convocatorio_codigo	Tipo instrumento convocatorio codigo, when published.
tipo_instrumento_convocatorio_nome	Tipo instrumento convocatorio nome, when published.
amparo_legal.nome	Amparo legal / nome, when published.
amparo_legal.codigo	Amparo legal / codigo, when published.
amparo_legal.descricao	Amparo legal / descricao, when published.
objeto_compra	Objeto compra, when published.
informacao_complementar	Informacao complementar, when published.
srp	Srp, when published.
fontes_orcamentarias.codigo	Fontes orcamentarias / codigo, when published.
fontes_orcamentarias.nome	Fontes orcamentarias / nome, when published.
fontes_orcamentarias.descricao	Fontes orcamentarias / descricao, when published.
fontes_orcamentarias.data_inclusao	Fontes orcamentarias / data inclusao, when published.
emenda_parlamentar	Emenda parlamentar, when published.
data_abertura_proposta	Data abertura proposta, when published.
data_encerramento_proposta	Data encerramento proposta, when published.
situacao_compra_id	Situacao compra id, when published.
situacao_compra_nome	Situacao compra nome, when published.
existe_resultado	Existe resultado, when published.
data_inclusao	Data inclusao, when published.
data_atualizacao	Data atualizacao, when published.
data_atualizacao_global	Data atualizacao global, when published.
usuario_nome	Usuario nome, when published.

The complete result below is included for every mode. Text and lists are not shortened. These are examples from validation runs; the source can change.

Search tender records — complete JSON result

{
  "result_type": "search",
  "input": "{\"keywords\": null}",
  "title": "Edital nº 009/2026",
  "description": "[LICITANET] - Registro de Preços, consignado em Ata, pelo prazo de 12 (doze) meses, objetivando à eventual contratação de empresa especializada para o fornecimento parcelado de materiais de limpeza, destinados a atender às necessidades do Fundo Municipal de Assistência Social de Orobó/PE",
  "document_type": "edital",
  "created_at": "2026-09-29T12:16:23.256137",
  "numero": null,
  "ano": "2026",
  "numero_sequencial": "11",
  "numero_sequencial_compra_ata": null,
  "numero_controle_pncp": "15212323000116-1-000011/2026",
  "orgao_id": "67615",
  "orgao_cnpj": "15212323000116",
  "orgao_nome": "FUNDO MUNICIPAL DE ASSISTENCIA SOCIAL",
  "orgao_subrogado_id": null,
  "orgao_subrogado_nome": null,
  "unidade_id": "2436878",
  "unidade_codigo": "2585",
  "unidade_nome": "FMAS-FUNDO MUNICIPAL DE ASSISTÊNCIA SOCIAL DE OROBÓ/PE",
  "esfera_id": "M",
  "esfera_nome": "Municipal",
  "poder_id": "E",
  "poder_nome": "Executivo",
  "municipio_id": "1577",
  "municipio_nome": "Orobó",
  "uf": "PE",
  "modalidade_licitacao_id": "6",
  "modalidade_licitacao_nome": "Pregão - Eletrônico",
  "situacao_id": "1",
  "situacao_nome": "Divulgada no PNCP",
  "data_publicacao_pncp": "2026-09-29T12:16:22.446869972",
  "data_atualizacao_pncp": "2026-09-29T12:16:22.446869972",
  "data_assinatura": null,
  "data_inicio_vigencia": "2026-09-29T12:16:15",
  "data_fim_vigencia": "2026-10-13T09:00",
  "cancelado": false,
  "valor_global": null,
  "tem_resultado": false,
  "tipo_id": "1",
  "tipo_nome": "Edital",
  "tipo_contrato_id": null,
  "tipo_contrato_nome": null,
  "fonte_orcamentaria": null,
  "fonte_orcamentaria_id": null,
  "fonte_orcamentaria_nome": null,
  "exigencia_conteudo_nacional": false,
  "permite_adesao": null,
  "possui_emenda_parlamentar": null,
  "tipo_margem_preferencia": null,
  "tipo_margem_preferencia_id": null,
  "tipo_margem_preferencia_nome": null,
  "tipo_item_irp": null,
  "prazo_manifestacao_interesse": null,
  "aplicabilidade_margem_preferencia": null,
  "status": "success",
  "record_id": "15212323000116-1-000011/2026",
  "url": "https://pncp.gov.br/app/compras/15212323000116/2026/11",
  "additional_fields.name": [],
  "additional_fields.value": []
}

Get tender details — complete JSON result

{
  "result_type": "details",
  "input": "https://pncp.gov.br/app/compras/04696490000163/2026/136",
  "valor_total_estimado": 397548.0,
  "valor_total_homologado": null,
  "orcamento_sigiloso_codigo": 1,
  "orcamento_sigiloso_descricao": "Compra sem sigilo",
  "numero_controle_pncp": "04696490000163-1-000136/2026",
  "link_sistema_origem": "https://cnetmobile.estaleiro.serpro.gov.br/comprasnet-web/public/compras/acompanhamento-compra?compra=92537305001672026",
  "link_processo_eletronico": "https://sei.sistemas.ro.gov.br/sei/controlador.php?acao=procedimento_trabalhar&acao_origem=procedimento_controlar&acao_retorno=procedimento_controlar&id_procedimento=74650248&infra_sistema=100000100&infra_unidade_atual=110000764&infra_hash=7b5d9e2cc431e9d08bf8c4d6ca9df7bdd4082901ef81eb67e55a1fae80dfe707",
  "ano_compra": 2026,
  "sequencial_compra": 136,
  "numero_compra": "167",
  "processo": "0033.014237/2026-38",
  "orgao_entidade.cnpj": "04696490000163",
  "orgao_entidade.razao_social": "SUP. EST. DE LICITACAO",
  "orgao_entidade.poder_id": "E",
  "orgao_entidade.esfera_id": "E",
  "unidade_orgao.uf_nome": "Rondônia",
  "unidade_orgao.uf_sigla": "RO",
  "unidade_orgao.municipio_nome": "Porto Velho",
  "unidade_orgao.codigo_ibge": "1100205",
  "unidade_orgao.codigo_unidade": "925373",
  "unidade_orgao.nome_unidade": "SUPERINTEND.ESTAD.DE COMPRAS E LICITAÇÕES-RO",
  "orgao_sub_rogado": null,
  "unidade_sub_rogada": null,
  "modalidade_id": 6,
  "modalidade_nome": "Pregão - Eletrônico",
  "justificativa_presencial": null,
  "modo_disputa_id": 1,
  "modo_disputa_nome": "Aberto",
  "tipo_instrumento_convocatorio_codigo": 1,
  "tipo_instrumento_convocatorio_nome": "Edital",
  "amparo_legal.nome": "Lei 14.133/2021, Art. 28, I",
  "amparo_legal.codigo": 1,
  "amparo_legal.descricao": "pregão: modalidade de licitação obrigatória para aquisição de bens e serviços comuns",
  "objeto_compra": "Registro de Preços de Material de Gêneros de Alimentação Tipo: (Café e Açúcar), o qual atenderá a demanda mensal dos Setores Administrativos e Unidades Prisionais desta Secretaria de Estado da Justiça - SEJUS, pelo período de 12 (Doze) meses.",
  "informacao_complementar": null,
  "srp": true,
  "fontes_orcamentarias.codigo": [
    3
  ],
  "fontes_orcamentarias.nome": [
    "Estadual"
  ],
  "fontes_orcamentarias.descricao": [
    "Recurso orçamentário estadual disponível e devidamente vinculado à despesa que será realizada."
  ],
  "fontes_orcamentarias.data_inclusao": [
    "2026-09-29T11:18:27"
  ],
  "emenda_parlamentar": null,
  "data_publicacao_pncp": "2026-09-29T11:18:26",
  "data_abertura_proposta": "2026-09-30T08:00:00",
  "data_encerramento_proposta": "2026-10-13T08:00:00",
  "situacao_compra_id": 1,
  "situacao_compra_nome": "Divulgada no PNCP",
  "existe_resultado": false,
  "data_inclusao": "2026-09-29T11:18:26",
  "data_atualizacao": "2026-09-29T11:18:26",
  "data_atualizacao_global": "2026-09-29T11:20:38",
  "usuario_nome": "Compras.gov.br",
  "status": "success",
  "record_id": "04696490000163-1-000136/2026",
  "url": "https://pncp.gov.br/app/compras/04696490000163/2026/136",
  "additional_fields.name": [],
  "additional_fields.value": []
}

Input settings ⚙️

Setting	What to enter
What to collect (mode)	Choose the information you need.
Maximum results per search or link (maxResults)	Collect up to this many saved results for each search or record link. Minimum: 1.
Keywords (keywords)	Words in notices currently accepting proposals. Leave empty to browse those notices.
Tender links (recordUrls)	Paste one individual public record link per line. Use this field in Details mode.

PNCP scraping use cases 🎯

Build a tender or contract shortlist

Search the supported procurement collection and export matching records. Keep deadlines, buyer names and original references together when reviewing opportunities.

Research public buyers

Compare available buyer, supplier and contract information across records. Preserve the published currency and value type when working with amounts.

Monitor published procurement records

Schedule repeated exports and compare stable record IDs to identify newly published notices and changes. A search result is not confirmation that bidding remains open.

Pricing and saved-result behavior 💰

See the Actor’s Pricing tab for the current rate. Under dataset-item pricing:

• Each saved record is one result. Lists and additional details attached to it do not create extra rows.
• A saved failed row is also one billable dataset item. This includes invalid inputs, unavailable records, empty searches and exhausted retries.
• At most one failed row is saved per input. Retry attempts do not create additional dataset rows.
• maxResults caps all saved rows for the input. Duplicate copies of the same input are processed once.

PNCP scraper API and integrations 🔌

Replace $ACTOR_ID with the ID shown in the Actor’s API tab and $APIFY_TOKEN with your Apify token.

curl -X POST "https://api.apify.com/v2/acts/$ACTOR_ID/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"search","maxResults":10}'

Use Apify schedules for recurring collection, webhooks for completion notifications, and integrations for Google Sheets, Make, Zapier, cloud storage or your own application.

Reliability and public-data limits ⚠️

Temporary request failures are retried up to five total attempts. Invalid record inputs save a failed row without a website request. Confirmed missing records are not retried unnecessarily. If a later request fails, records already saved remain in the dataset. Normal pagination completion does not add a failed row. Collection stops after two consecutive pages return no new records. Configuration, data-saving or request-scheduling failures stop the run.

PNCP controls the available records and fields. Search records can contain less information than a full public card. The Actor preserves published values and does not fill missing facts with estimates.

Frequently asked questions ❓

Do I need a PNCP account?

No. This Actor collects the supported public information without your website login.

Which search filters can I use?

The input form supports keywords. Only the displayed filters are supported.

How many records can I collect?

Set maxResults to the maximum saved rows you want for each input. The minimum is 1. Collection can finish earlier when the source runs out of results or stops returning new records.

Why are some fields empty?

The source may not publish a value for that record or mode. Optional information remains empty.

Can I export all the fields?

Yes. All returned fields are included in one dataset view. Nested lists remain attached to their parent record.

Support 🛟

For a reproducible issue, share the run ID, selected mode and a safe public example through the Actor’s support channel. Keep tokens, passwords and proxy credentials private.