B3 Brazil Stock Screener — Ibovespa Market Data API

B3 Brazil Stock Screener

B3 Brazil Stock Screener is a NexGenData tool on Apify that returns Ibovespa stocks with market cap, P/E and dividend yield from B3 market data.

Screen B3 (Brazil) stocks by market cap, valuation and fundamentals. Built for analysts, quant researchers, fintech builders and AI agents. Factual public data — not financial or investment advice.

📊 Sample Output

yahoo_symbol	company_name_pt	share_class	exchange_full_name	country	liquidity_2m_brl
PETR4.SA	PETROBRAS	PN (Preferencial / preferred)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	2010450000
VALE3.SA	VALE	ON (Ordinária / common, voting)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	1507170000
ITUB4.SA	ITAUUNIBANCO	PN (Preferencial / preferred)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	1012170000
BBDC4.SA	BANCO BRADESCO S.A.	PN (Preferencial / preferred)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	678572000
AXIA3.SA	AXIA ENERGIA	ON (Ordinária / common, voting)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	676366000
BBAS3.SA	BANCO DO BRASIL S.A.	ON (Ordinária / common, voting)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	648704000

Real rows from run BgT2vfj4ka6IXNmKa on build 0.0.10 (2026-09-24), unedited apart from masked emails/phones and shortened long text; fields the source does not publish are empty.

🔧 Input reference

Field	Type	Default	What it does
limit	integer	100	Maximum number of B3 (Brasil, Bolsa, Balcão / Bovespa) listed stocks to return. The Brazilian exchange has roughly 400-450 listed common stocks plus preferred shares (PETR4, VALE3…
min_market_cap_brl	integer	0	Filter to stocks with patrimônio líquido (book equity, in BRL) at or above this threshold. Used as a market-cap proxy from Fundamentus. Examples: 1000000000 = 1bn BRL (mid-cap flo…
min_liquidity_2m_brl	integer	0	Filter to stocks with Liq.2meses (mean daily traded value over the last 2 months in BRL) at or above this threshold. Excellent for excluding illiquid micro-caps. Examples: 1000000…
max_pe_ratio	number	0	Filter to stocks with P/L (Preço/Lucro, P/E) at or below this value (value-investor screen). Examples: 8 = deep value typical of Brazilian banks/utilities, 15 = classic Graham val…
max_pvp_ratio	number	0	Filter to stocks with P/VP (Preço/Valor Patrimonial, P/B) at or below this value. Brazilian banks often trade at 0.8-1.5 P/VP. Examples: 1 = trading below book, 2 = reasonable. Le…
min_dividend_yield	number	0	Filter to stocks with trailing dividend yield at or above this value (in percent). Brazil is famous for its high-yield equity culture — utilities (TAEE11, ENBR3), banks (ITSA4, BB…
min_roe_pct	number	0	Filter to stocks with Return on Equity at or above this value (in percent). Quality-investor screen. Examples: 15 = good quality, 20 = top-tier (Itaú, WEG, Localiza historically).…
sector	string	""	Optional case-insensitive substring filter applied to the ticker (Papel) and company name. Examples: 'PETR' (Petrobras family — PETR3/PETR4), 'BANCO' (banks), 'VALE', 'ITAU', 'ENE…
proxyConfiguration	object	{"useApifyProxy": true}	Apify proxy configuration. Fundamentus.com.br is a public Brazilian server-rendered site and accepts datacenter proxies fine. Switch to RESIDENTIAL only if you hit rate limits.

🧾 JSON sample record

One real record from run BgT2vfj4ka6IXNmKa (emails/phones masked, long text shortened):

{
  "symbol": "PETR4",
  "yahoo_symbol": "PETR4.SA",
  "company_name_pt": "PETROBRAS",
  "root_ticker": "PETR",
  "share_class": "PN (Preferencial / preferred)",
  "market": "B3",
  "exchange_full_name": "Brasil, Bolsa, Balcão (Bovespa)",
  "country": "Brazil",
  "currency": "BRL",
  "price_brl": 49.26,
  "pe_ratio": 4.76,
  "pvp_ratio": 1.32,
  "psr": 1.158,
  "dividend_yield_pct": 7.4,
  "p_ativo": 0.496,
  "p_cap_giro": -24.05,
  "p_ebit": 2.71,
  "p_ativ_circ_liq": -0.99,
  "ev_ebit": 4.04,
  "ev_ebitda": 2.94,
  "gross_margin_pct": 50.6,
  "ebit_margin_pct": 42.76,
  "net_margin_pct": 24.39,
  "current_ratio": 0.85,
  "roic_pct": 19.69,
  "roe_pct": 27.73,
  "liquidity_2m_brl": 2010450000,
  "book_equity_brl": 480950000000,
  "net_debt_to_equity": 0.65,
  "revenue_growth_5y_pct": -2.33,
  "fundamentus_url": "https://www.fundamentus.com.br/detalhes.php?papel=PETR4",
  "b3_url": "https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/empresas-listadas.htm?codigo=PETR4",
  "yahoo_finance_url": "https://finance.yahoo.com/quote/PETR4.SA",
  "scraped_at": "2026-09-24T23:53:50.931367Z"
}

💰 Pricing

Event	Price (USD)	When it is charged
Actor Start (apify-actor-start)	$0.01	Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event).
B3 stock record (apify-default-dataset-item)	$0.25	Charged per B3 stock record returned with price, market cap, P/E, P/B, dividend yield, sector, and fundamentals.

Pay-per-event: you pay only for what the run delivers. A run that delivers nothing bills no result events (only the actor-start event, when the actor defines one). Example: a run that delivers 100 results costs 100 × $0.25 = $25.00 plus the start fee.

📊 What you get

Clean JSON, one record per stock. Key fields (full output has 34 fields per stock):

• root_ticker — Exchange ticker symbol
• company_name_pt — Company name
• price_brl — Latest traded price (local currency)
• pe_ratio — Price-to-earnings ratio
• dividend_yield_pct — Dividend yield (%)
• roe_pct — Return on equity
• currency — Reporting currency
• scraped_at — Data timestamp
• b3_url — Source / reference URL

All prices in BRL.

Local-market specifics: Deep fundamentals — ROE, ROIC, EV/EBIT, P/VP and margins — sourced from Fundamentus, with Portuguese company names.

Pricing: $0.25 per stock (Pay-Per-Event) — about 4 stocks per $1. A $0.01 actor-start fee applies per run.

🤖 Use with AI agents

This actor returns structured JSON built for LLM and agent pipelines — no data-vendor contract, no scraping to maintain. Point Claude, a custom OpenAI Agents SDK tool, an n8n flow, or any MCP-aware client at it and get Ibovespa fundamentals on demand. Ask for a filtered slice and the agent gets exactly the rows it needs.

Sample agent prompt:

Screen Brazilian B3 stocks with a dividend yield above 6% and return the 20 most liquid.

Agentic payments (x402): Supports agentic payment via x402 — agents can call this actor with USDC, no API key required.

Run it on a schedule

A daily run after the B3 close keeps price-based numbers like P/E and dividend yield current, while a weekly run is enough for a screen built on slower fundamentals like ROE and margins. The same stocks come back run after run with updated values; new rows only appear when a stock newly passes your filters or a listing changes. The actor has no new-only mode, so compare runs on symbol if you want to see which stocks entered or left your screen. Send each run's results onward with a webhook, Google Sheets, Zapier, Make or the Apify API.

Video guides from Apify: Schedule your Actor · Integrations

FAQ

Why use this instead of the official B3 or Fundamentus websites?

The numbers come from Fundamentus, a free public Brazilian site, and each row links back to Fundamentus, B3 and Yahoo Finance. What this actor adds is a screen you set in one input (book equity, liquidity, P/E, P/VP, dividend yield, ROE), 34 fields per stock as clean JSON, and runs you can schedule and export. It is not made by or linked to B3 or Fundamentus. It is factual public data, not investment advice.

What does a typical run cost?

You pay per result, not for run time: $0.25 for each row in the results, plus $0.01 per run start (charged per GB of run memory, minimum one). A run that returns 25 stocks costs about $6.26. Live prices are always shown in the Pricing tab.

How do I screen Brazilian stocks for high dividend yield?

Set min_dividend_yield to the percent you want, for example 6. Add min_liquidity_2m_brl to drop thinly traded names, since it filters on average daily traded value over the last two months. All prices and values are in BRL, and company names are in Portuguese.

Is the market cap filter based on real market cap?

No. min_market_cap_brl filters on book equity (patrimônio líquido) from Fundamentus, used as a stand-in for size. The row returns it as book_equity_brl. If you need true market value, take it from another source.

Can I filter by sector?

Not by an official sector code. The sector input is a text match on the ticker and company name, so "BANCO" finds banks by name and "PETR" finds the Petrobras share classes. Each share class (for example PETR3 and PETR4) is its own row.

Related actors

• Global Equities Screener MCP — 26 Markets for AI Agents — screen Brazil alongside other markets from one AI agent tool.
• BMV Mexico Stock Screener — S&P/BMV IPC Data API — the other big Latin American exchange.
• TSX Canada Stock Screener — S&P/TSX Market Data API — another Americas market screen.
• Finviz Stock Screener — US Market Data API — compare Brazilian names with US stocks.
• Finance MCP Server — Stocks, Screener & Crypto for AI Agents — quotes and screens for AI agents.