🏦 Banco Central do Brasil SGS Scraper

🚀 Export Brazilian economic time series in seconds. Pull Selic, IPCA, exchange rates and credit aggregates from the Banco Central do Brasil SGS API, one clean dated row per observation.

🕒 Last updated: 2026-06-05 · 📊 6 fields per record · 20 curated series plus any custom code · daily, monthly and annual data

The Sistema Gerenciador de Series Temporais (SGS) is the official open data service of the Banco Central do Brasil. It publishes thousands of macroeconomic and financial time series, from the Selic policy rate to IPCA inflation, USD/BRL exchange rates and outstanding credit. This Actor turns any of those series into a tidy table you can drop straight into a model, a dashboard or a spreadsheet.

Pick from a curated list of the most requested series, or paste any numeric SGS code. Choose the latest N observations per series, or pull a full date range. Every observation becomes one record with the series code, a readable series name, the date and the value.

🎯 Target Audience	💡 Primary Use Cases
Economists and analysts	Tracking Selic and IPCA over time
Fintech and trading teams	Feeding FX and rate data into models
Researchers and journalists	Sourcing official Brazilian macro data
Data engineers	Backfilling economic series into a warehouse

📋 What the Banco Central do Brasil SGS Scraper does

• Fetches observations from the official Banco Central do Brasil SGS API.
• Accepts one or many series at once, by curated pick or custom numeric code.
• Two modes: latest N observations per series, or a full date range.
• Returns one dated row per observation with a numeric value and the original raw value.
• Labels curated series with a human readable name so the output is self describing.

🎬 Full Demo (🚧 Coming soon)

⚙️ Input

Field	Type	Description
seriesCodes	array	One or more curated SGS series to fetch (defaults to Selic, IPCA, USD/BRL).
customSeriesCodes	string	Any other SGS codes, comma separated, added to the selection above.
mode	string	latest for most recent records, or dateRange for a window.
lastN	integer	How many recent records per series when mode is latest.
startDate	string	First day to include, DD/MM/YYYY, when mode is dateRange.
endDate	string	Last day to include, DD/MM/YYYY, when mode is dateRange.
maxItems	integer	Overall record cap. Free plan is limited to 10.

Latest observations example:

{
    "seriesCodes": ["432", "433", "1"],
    "mode": "latest",
    "lastN": 5,
    "maxItems": 10
}

Date range example:

{
    "seriesCodes": ["433"],
    "customSeriesCodes": "189",
    "mode": "dateRange",
    "startDate": "01/01/2024",
    "endDate": "01/06/2024"
}

⚠️ Good to Know: SGS dates use the DD/MM/YYYY format and are returned exactly as published by the Banco Central. Some series are daily, some monthly, some annual, so the spacing between dates depends on the series you pick.

📊 Output

Field	Description
🔖 seriesCode	The numeric SGS series code
📌 seriesName	Readable name for curated series (null for custom codes)
📅 date	Observation date, DD/MM/YYYY
🔢 value	The observation value as a number
🧾 rawValue	The original value string as published
🕒 scrapedAt	When the record was collected
❌ error	Null on success, message on failure

Real sample records:

{
    "seriesCode": 432,
    "seriesName": "Selic target rate (% per year)",
    "date": "13/06/2026",
    "value": 14.5,
    "rawValue": "14.50",
    "scrapedAt": "2026-06-05T16:30:36.863Z",
    "error": null
}

{
    "seriesCode": 432,
    "seriesName": "Selic target rate (% per year)",
    "date": "14/06/2026",
    "value": 14.5,
    "rawValue": "14.50",
    "scrapedAt": "2026-06-05T16:30:36.920Z",
    "error": null
}

{
    "seriesCode": 432,
    "seriesName": "Selic target rate (% per year)",
    "date": "15/06/2026",
    "value": 14.5,
    "rawValue": "14.50",
    "scrapedAt": "2026-06-05T16:30:37.059Z",
    "error": null
}

✨ Why choose this Actor

• Pulls straight from the official Banco Central do Brasil source, no middleman.
• Curated picker for the 20 series people ask for most, plus open access to any code.
• Numeric value and original rawValue together, so you never lose precision.
• Clean one row per observation shape that maps directly to a table.
• Works for daily FX, monthly inflation and annual indicators alike.

📈 How it compares to alternatives

Approach	Coverage	Effort
This Actor	Any SGS series, latest or date range	Pick a series and run
Manual SGS portal	Full, but one series at a time	Lots of clicking
Generic API client	Full, but raw values only	You build the parsing

🚀 How to use

1. Sign up for a free Apify account using this link.
2. Open the Banco Central do Brasil SGS Scraper.
3. Pick one or more series, or paste custom SGS codes.
4. Choose latest observations or a date range, then run.
5. Collect your results from the dataset once the run finishes.

💼 Business use cases

Rates and policy

Need	How this helps
Track the Selic	Pull series 432 over any window
Monitor policy shifts	Compare target and effective rates

Inflation

Need	How this helps
Follow IPCA	Pull series 433 monthly change
Compare indices	Add IGP-M and INPC in one run

FX and treasury

Need	How this helps
Daily USD/BRL	Pull series 1 by date range
Reserves view	Add international reserves series

Credit and activity

Need	How this helps
Credit aggregates	Pull outstanding credit series
Activity proxy	Add the IBC-Br activity index

🔌 Automating Banco Central do Brasil SGS Scraper

Connect runs and results to Make, Zapier, Slack, Airbyte, GitHub Actions or Google Drive through the Apify API and integrations. Schedule a daily run to keep a rates and FX table fresh, then route new records into your tool of choice.

🌟 Beyond business use cases

• Research: build a reproducible dataset of Brazilian macro indicators.
• Personal: watch the Selic or USD/BRL for your own savings decisions.
• Non-profit: add official economic context to public reports.
• Experimentation: test forecasting models on real central bank series.

🤖 Ask an AI assistant

Paste your collected records into ChatGPT, Claude, Perplexity or Copilot and ask it to chart the trend, summarize the move or compare two series.

❓ Frequently Asked Questions

Where does the data come from? Directly from the official Banco Central do Brasil SGS API.

Do I need an API key? No. The SGS service is open and keyless.

Which series can I fetch? Any series in the SGS, by curated pick or by pasting its numeric code.

What date format does it use? DD/MM/YYYY, exactly as the Banco Central publishes it.

Can I fetch several series at once? Yes. Add as many curated picks and custom codes as you like.

Latest observations or a full history? Both. Use latest mode for recent records or date range for a window.

Why is seriesName null for some records? Custom codes outside the curated list are returned without a friendly name.

What is rawValue for? It preserves the exact value string the API returned, before numeric parsing.

Is there a limit on free plans? Free runs are capped at 10 records. Paid plans go up to 1,000,000.

What happens if a code is invalid? That series is skipped and an error record explains why, while valid series still run.

🔌 Integrate with any app

Use the Apify API, webhooks and scheduling to push records into databases, sheets and BI tools, or to trigger downstream workflows when a run completes.

🔗 Recommended Actors

• DBnomics Economic Series Scraper
• NY Fed Reference Rates Scraper
• SEC XBRL Company Facts Scraper

💡 Pro Tip: browse the complete ParseForge collection.

🆘 Need Help? Open our contact form

⚠️ Disclaimer: independent tool, not affiliated with the Banco Central do Brasil. Only publicly available data collected.