Portugal Company Search API and MCP — Find a NIPC by Company Name
Send an entity name, or part of one, and get matching companies from the Registo Comercial publications portal: name, NIF/NIPC, municipality, and the date and type of each company's newest publication. Use the NIPC with Portugal company for the full record.
- You send
- an entity name or part of one, plus optional max_items and start_page
- You get back
- Name, NIF/NIPC, municipality and the date and type of the newest publication
- Coverage
- Portugal — entities on Registo Comercial publications portal.
- Price
- 2 points per returned record — $2 per 1,000
- Billed per record actually returned, capped by max_items. A request that returns nothing costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Registo Comercial publications portal directly | Type the name into Registo Comercial publications portal and read the results | Usually free, sometimes per-document | A different interface, language and data shape for every country you add |
| Collecting it yourself | Build and host a crawler per register, then keep each one alive | Infrastructure and maintenance | Registers change their pages without warning, and nobody is on the hook when yours breaks |
| NeuralVerge | One request, the same shape as every other source in the catalog | $2 per 1,000, misses not billed | Covers Portugal — other countries are separate sources with the same request format |
What you get back
Every field in the example response below.
| Field | Type | Description |
|---|---|---|
total_items | number | How many records are in this response. |
first_item | object | The first record, repeated from items. |
items | array | The matching companies. |
items[].registration_number | string | NIF/NIPC. |
items[].name | string | Company name as published. |
items[].address | string | Municipality of the company. |
items[].latest_publication_date | string | Date of the newest publication. |
items[].latest_publication_type | string | Type of the newest publication. |
items[].url | string | Link to the company on the portal. |
items[].status, items[].company_type, items[].incorporation_date | null | Null in the sample: the search list does not carry them. |
total_found | null | Null in the sample: the portal gave no total for this query. |
page_count | number | How many result pages were read. |
blocked | boolean | True if the portal could not be read; false on a normal run. |
proxy_traffic_bytes | number | Traffic used by the run, in bytes. |
session_id | string | Id of this run, for tracing. |
kind | string | The source that produced the response. |
human | string | A short readable summary of the result. |
total_points | number | Points charged for this run. |
Example response
A real response, as returned.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "pt_companies_search",
"keyword": "padaria",
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Portugal — Registo Comercial — company search\n\n- **Keyword:** padaria\n- **Results:** 2\n- **Proxy traffic:** 192.5 KB",
"machine": {
"total_items": 2,
"first_item": {
"registration_number": "500570205",
"name": "PADARIA DA RAMALHA, S.A.",
"status": null,
"address": "Covilhã",
"url": "https://publicacoes.mj.pt/Pesquisa.aspx#nipc=500570205",
"company_type": null,
"incorporation_date": null,
"latest_publication_date": "2026-10-06",
"latest_publication_type": "Aumento do capital(online)"
},
"items": [
{
"registration_number": "500570205",
"name": "PADARIA DA RAMALHA, S.A.",
"status": null,
"address": "Covilhã",
"url": "https://publicacoes.mj.pt/Pesquisa.aspx#nipc=500570205",
"company_type": null,
"incorporation_date": null,
"latest_publication_date": "2026-10-06",
"latest_publication_type": "Aumento do capital(online)"
},
{
"registration_number": "504048767",
"name": "IBERICA, PADARIA PASTELARIA E GELATARIA LDA",
"status": null,
"address": "Campo Maior",
"url": "https://publicacoes.mj.pt/Pesquisa.aspx#nipc=504048767",
"company_type": null,
"incorporation_date": null,
"latest_publication_date": "2026-10-02",
"latest_publication_type": "PRESTAÇÃO DE CONTAS INDIVIDUAL"
}
],
"total_found": null,
"page_count": 1,
"blocked": false,
"proxy_traffic_bytes": 197097
},
"total_points": 4
}How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
Results come back in the same envelope as every other source: a session id, a readable summary, the structured result and the points charged.
curl -X POST https://api.neuralverge.ai/functions/v1/run-pt-companies-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword":"padaria","max_items":2}'What teams use it for
Where this field shows up in an actual workflow.
Turn a company name into the number that Portugal company and filings need.
Search a trade word such as padaria and collect matching companies by municipality.
Sort leads by the date of their newest publication to find companies that just filed.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Portugal — entities on Registo Comercial publications portal.
Read at request time, so the answer reflects the register as it stands when you ask.
Registo Comercial publications portal is a public register. Every response carries the source URL it was read from and a session id you can trace.
- —Results carry name, NIPC, municipality and newest publication only; legal form and seat come from Portugal company.
- —The portal gives no match total on this query, so total_found can be null.
- —Search is by entity name, not by NIPC. Use Portugal company when you already have the number.
Questions, answered
The portal did not report a total for the sample query. Use start_page and max_items to read further results.
Related sources
Try portugal company search on your own data
One request format across every source in the catalog.