ccee.org.br APIccee.org.br ↗
Access Brazil's CCEE electricity spot prices (PLD), board meeting minutes, and document repository via 4 structured JSON endpoints.
curl -X GET 'https://api.parse.bot/scraper/880218c8-67e5-4746-8c4b-a8a9a2069f28/search_documents?page=0&limit=10&query=energia' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for documents in the CCEE Acervo (repository) with keyword and filters. Returns paginated results sorted by publication date descending. When no date range is provided, defaults to the last 365 days.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed). |
| limit | integer | Number of results per page. |
| query | string | Search keyword to filter documents. |
| assunto | string | Subject filter. Accepted values available from the get_filter_options endpoint (e.g. 'PLD', 'Conselho de Administração'). |
| especie | string | Document type filter. Accepted values available from the get_filter_options endpoint (e.g. 'Ata', 'Relatório', 'Resolução'). |
| end_date | string | End date for publication filter in DD/MM/YYYY format. |
| start_date | string | Start date for publication filter in DD/MM/YYYY format. |
{
"type": "object",
"fields": {
"total": "integer, number of results on the current page",
"results": "array of document objects with fields: nomeDocumentoList, extension, size, nomeComplementar, description, publishDateFMT, url, hash",
"maxResults": "integer, total matching documents across all pages",
"pageNumber": "integer, current page number (1-indexed in response)",
"totalPages": "integer, total number of pages available"
},
"sample": {
"data": {
"total": 1247,
"results": [
{
"url": "https://www.ccee.org.br/documents/80415/31258623/example.pdf/051eb4e4-7c31-4c43-69d2-b450f7a2943c",
"hash": "497dd0fc9b608045b391031ff9fb7714",
"size": 229,
"extension": "PDF",
"description": "Relatório de asseguração razoável nº 005/26 - Emitido pela EY.",
"publishDate": "Wed May 13 03:00:00 GMT 2026",
"anoReferencia": "2026",
"mesReferencia": "04",
"publishDateFMT": "13/05/2026",
"nomeComplementar": "Relatório de asseguração razoável dos auditores independentes",
"nomeDocumentoList": "Relatório de Asseguração da Apuração e Liquidação Financeira de Energia de Reserva"
}
],
"maxResults": 2000,
"pageNumber": 1,
"totalPages": 125
},
"status": "success"
}
}About the ccee.org.br API
This API exposes 4 endpoints covering CCEE's electricity spot price data and document repository. Use get_pld_prices to retrieve real-time PLD prices across all Brazilian electricity submarkets, or use search_documents to query CCEE's full document archive with keyword and subject filters. Board meeting minutes are accessible through their own dedicated endpoint, and filter vocabulary can be fetched dynamically.
PLD Spot Prices
The get_pld_prices endpoint returns current PLD (Preço de Liquidação das Diferenças) electricity spot prices from CCEE. The response includes a submarkets array where each object carries name, pld_horario (hourly price), and media_diaria (daily average). A hora_vigente field identifies the active time window and date, so you always know exactly which pricing interval the figures represent. No parameters are required.
Document Search
The search_documents endpoint searches CCEE's Acervo repository with optional query, assunto (subject), especie (document type), start_date, and end_date parameters. When no date range is supplied, the endpoint defaults to the last 365 days. Results are paginated (0-indexed page parameter) and sorted by publication date descending. Each result object includes nomeDocumentoList, extension, size, description, publishDateFMT, url, and hash. The maxResults and totalPages fields let you page through large result sets programmatically.
Board Meeting Minutes
The search_atas_cad endpoint is scoped specifically to CCEE's Conselho de Administração (CAD) meeting minutes. It accepts the same page, limit, and query parameters as the general document search and returns the same document object shape. Using this endpoint instead of the general search avoids the need to pass subject or type filters manually.
Filter Discovery
Before filtering documents, call get_filter_options to retrieve the current accepted values for both the assunto and especie parameters. The response provides assuntos and especies arrays. This is the correct way to enumerate valid filter values rather than hard-coding strings that may change.
- Track real-time PLD electricity spot prices by submarket for energy trading or procurement decisions
- Monitor daily average PLD prices (media_diaria) across Brazil's Southeast, South, Northeast, and North submarkets
- Search CCEE's document repository by subject and type to retrieve regulatory reports or resolutions
- Pull CCEE board meeting minutes programmatically for governance and compliance monitoring
- Build date-range queries over CCEE documents to audit policy changes over specific periods
- Enumerate valid assunto and especie filter values dynamically before constructing search requests
- Aggregate historical PLD pricing context by cross-referencing meeting minutes with price data by date
| 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.