alertalicitacao.com.br APIalertalicitacao.com.br ↗
Access Brazilian government procurement listings (licitações) by keyword or state. Search, browse by UF, and retrieve detailed edital data via 4 endpoints.
curl -X GET 'https://api.parse.bot/scraper/1210cd96-33c5-4ada-bd2d-ee6ce6d0a4e9/search_licitacoes?keyword=obras' \ -H 'X-API-Key: $PARSE_API_KEY'
Search licitações by keyword. Returns results matching the keyword (limited to sample results for non-subscribers).
| Param | Type | Description |
|---|---|---|
| keyword | string | Search keyword for procurement listings (e.g., 'obras', 'equipamentos', 'serviços de TI'). |
{
"type": "object",
"fields": {
"note": "string — informational note about result limitations",
"keyword": "string — the keyword that was searched",
"licitacoes": "array of licitação objects with identificador, titulo, link, visualizacoes, portal, data_abertura, cidade, uf, objeto, and optionally orgao, valor_estimado",
"total_results": "integer — number of results returned"
},
"sample": {
"data": {
"note": "Search results are limited to examples for non-subscribers. Use list_by_state for more comprehensive listings.",
"keyword": "PEAD",
"licitacoes": [
{
"uf": "MG",
"link": "https://alertalicitacao.com.br/!licitacao/PNCP-17744442000145-1-000049-2026",
"cidade": "Mercês/MG",
"objeto": "[licitanet] - registro de preços para aquisição de tubos de polietileno de alta densidade (pead)",
"portal": "PNCP",
"titulo": "Edital 9/2026",
"data_abertura": "14/05/2026 09:00",
"identificador": "PNCP-17744442000145-1-000049-2026",
"visualizacoes": 29,
"valor_estimado": "R$ 568.000,00"
}
],
"total_results": 2
},
"status": "success"
}
}About the alertalicitacao.com.br API
The Alerta Licitação API provides access to Brazilian government procurement listings through 4 endpoints covering keyword search, state-based browsing, individual licitação detail retrieval, and a full state index with open-listing counts. The search_licitacoes endpoint accepts keywords such as 'obras' or 'serviços de TI' and returns structured licitação objects including portal, city, state, opening date, and a plain-text objeto description. Free access returns a representative sample; full result sets require a subscription.
Endpoints and Data Coverage
The API exposes four endpoints against the Alerta Licitação directory of Brazilian public procurement notices. search_licitacoes accepts a keyword string and returns an array of licitação objects, each carrying an identificador, titulo, link, portal, data_abertura, cidade, uf, objeto, and a visualizacoes view count. A note field in the response indicates when results are capped at the publicly visible sample. list_by_state accepts a two-letter Brazilian state code (state) and returns up to approximately 20 listings for that UF, adding modalidade and orgao fields to the standard shape. The response also includes total_licitacoes_no_estado when the source reports a state-level total.
Detail and State Index Endpoints
get_licitacao accepts a licitacao_id (obtained from search or browse results, e.g. BB-1092336) and returns a single record with the full set of available fields: titulo, orgao, cidade, uf, modalidade, data_abertura, objeto, a link to the Alerta Licitação page, and a link_edital pointing to the official edital document when one is listed. list_states requires no input and returns all 27 Brazilian states as an array of objects with uf, nome, and total_licitacoes, giving a real-time count of open listings per state.
Identifiers and Portals
Each licitação carries an identificador that encodes its origin portal as a prefix (e.g. BB- for Banco do Brasil, PNCP- for the national procurement portal). These identifiers are stable and can be passed directly to get_licitacao. The portal field in search results makes the source portal explicit. Opening dates use DD/MM/YYYY HH:MM format throughout.
- Monitor new tenders for a specific product category by polling
search_licitacoeswith relevant keywords like 'equipamentos médicos'. - Build a state-level dashboard of open procurement opportunities using
list_statesto displaytotal_licitacoescounts per UF. - Filter procurement listings by Brazilian state for regional sales teams using
list_by_statewith the relevantstatecode. - Retrieve full edital document links via
get_licitacaoto automate bid document downloads fromlink_edital. - Track view counts (
visualizacoes) on listings to gauge competitive interest in specific procurement notices. - Aggregate
orgaoandmodalidadedata fromlist_by_stateto analyze which public bodies issue the most tenders in a state. - Cross-reference
identificadorprefixes to determine which procurement portals (e.g. PNCP, Banco do Brasil) are most active for a given keyword.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Alerta Licitação have an official developer API?+
What does `get_licitacao` return that the search and browse endpoints do not?+
get_licitacao adds link_edital (a direct URL to the official edital document) and is the only endpoint that guarantees the full field set for a single record. Search and browse results may omit link_edital and are subject to sample size limits.How many results does `search_licitacoes` return for non-subscribers?+
note field in the response describes the limitation explicitly. Full result sets are available with a paid subscription on Alerta Licitação.Does the API support pagination or filtering by date range?+
search_licitacoes accepts a keyword and list_by_state accepts a state code; date filtering is not available. You can fork this API on Parse and revise it to add a date-range parameter if the underlying source surfaces that data.