ClubeFII Scraper

What does ClubeII FII Scraper do?

ClubeII FII Scraper extracts structured investment data from clubefii.com.br — one of the most widely used Brazilian Real Estate Investment Trust (FII) data portals. Pass one or more FII ticker page URLs and get back a clean JSON record per fund with 45+ fields: current price, dividend yield history, P/VP, NAV per share, market cap, fund registration data, and others.

Why scrape FII data from clubefii.com.br?

FII data on clubefii.com.br is publicly available, but there is no official API. This Actor gives you programmatic access to that data so you can:

• 📊 Build investment dashboards — pull daily snapshots of your FII watchlist into Google Sheets, Notion, or a database
• 🤖 Automate portfolio monitoring — schedule a daily run and alert yourself when P/VP or dividend yield crosses a threshold
• 🔎 Screen the whole FII market — batch-scrape every FII and filter by segment, DY, liquidity, or leverage
• 📉 Track price and yield history — store periodic snapshots to build time-series data that clubefii.com.br itself does not export
• 🧮 Feed quantitative models — clean numeric output is ready as input for valuation models, backtests, or ranking scripts

How to scrape FII data with ClubeII FII Scraper

1. Visit the Actor page on Apify and click Try for free — no credit card required.
2. In the Input tab, add one or more clubefii.com.br/fiis/<TICKER> URLs under FII URLs (e.g. https://www.clubefii.com.br/fiis/MXRF11).
3. Click Start and wait a few seconds per FII for the run to complete.
4. Open the Output tab or download the dataset as JSON, CSV, or Excel.

To trigger a run via the Apify API:

curl -X POST \
  "https://api.apify.com/v2/acts/riseandcode~apify-clubefii/runs?token=<YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "startUrls": [
      { "url": "https://www.clubefii.com.br/fiis/MXRF11" },
      { "url": "https://www.clubefii.com.br/fiis/KNRI11" }
    ]
  }'

Input

The Actor accepts a single field, configurable in the Input tab on Apify Console or as a JSON body when calling the API.

Field	Type	Description
startUrls	array	Required. List of clubefii.com.br/fiis/<TICKER> page URLs.

Example:

{
    "startUrls": [
        { "url": "https://www.clubefii.com.br/fiis/MXRF11" },
        { "url": "https://www.clubefii.com.br/fiis/HGLG11" },
        { "url": "https://www.clubefii.com.br/fiis/KNRI11" }
    ]
}

Output

What data can you extract from clubefii.com.br?

One dataset record is pushed per URL. You can download the dataset extracted by ClubeII FII Scraper in various formats such as JSON, CSV, HTML, or Excel from the Output tab or via the Apify API.

Output example

{
    "ticker": "HGBS11",
    "url": "https://www.clubefii.com.br/fiis/HGBS11",
    "scrapedAt": "2026-04-21T11:14:00.000Z",
    "price": 21.02,
    "priceChange": 0.14,
    "priceChangeMonth": 2.84,
    "priceChangeYear": 5.1,
    "priceChange12Months": 7.87,
    "dividendYield1Month": 0.81,
    "dividendYield3Months": 2.38,
    "dividendYield6Months": 4.52,
    "dividendYield12Months": 8.94,
    "pvp": 1.02,
    "navPerShare": 20.69,
    "marketCap": 2714375870,
    "totalPatrimonyValue": 2671636928,
    "avgDailyLiquidity30d": 5945105,
    "leverageIndex": 20.41,
    "numberOfShareholders": 174272,
    "ifixRepresentation": 1.79,
    "segment": "SHOPPING/VAREJO",
    "manager": "HEDGE INVESTMENTS",
    "managementType": "ATIVA",
    "mandate": null,
    "ipoDate": "11/12/2007",
    "ipoValue": 10.0,
    "totalShares": 129133010,
    "cnpj": "08.431.747/0001-06",
    "administrator": "HEDGE INVESTMENTS",
    "custody": "HEDGE INVESTMENTS",
    "shareRegistration": "HEDGE INVESTMENTS",
    "officialFundUrl": "https://www.hedgeinvest.com.br/HGBS",
    "adminFeeYearValue": 14881510.21,
    "adminFeeOverBookValue": 0.56,
    "adminFeeOverMarketValue": 0.58,
    "propertyAppraiser": "CUSHMAN&WAKEFIELD",
    "auditor": "PWC",
    "ablM2": 239478,
    "vacancyRate": 4.6,
    "occupancyRate": 95.4,
    "vacancyM2": 11015.99,
    "occupiedM2": 228462.01,
    "vacancyReferenceDate": "30/11/2025",
    "priceHistory": [
        { "date": "2025-04-15", "value": 19.53 },
        { "date": "2025-04-16", "value": 19.71 }
    ],
    "dividendYieldHistory": [
        { "date": "2025-03-01", "value": 0.79 },
        { "date": "2025-04-01", "value": 0.81 }
    ]
}

Output fields

Field	Type	Description
ticker	string	FII ticker symbol (e.g. MXRF11)
url	string	Source page URL
scrapedAt	string	ISO 8601 timestamp of collection
price	number|null	Current share price in BRL. null for funds with no active trading
priceChange	number|null	Today's price change (%)
priceChangeMonth	number|null	Price change in the current month (%)
priceChangeYear	number|null	Price change year-to-date (%)
priceChange12Months	number|null	Price change over the last 12 months (%)
dividendYield1Month	number|null	Dividend yield for the last month (%)
dividendYield3Months	number|null	Accumulated DY last 3 months (%)
dividendYield6Months	number|null	Accumulated DY last 6 months (%)
dividendYield12Months	number|null	Accumulated DY last 12 months (%)
pvp	number|null	Price / NAV per share
navPerShare	number|null	Net asset value per share (BRL)
marketCap	number|null	Total market capitalisation (BRL)
totalPatrimonyValue	number|null	Total fund NAV (BRL)
avgDailyLiquidity30d	number|null	Avg daily trading volume last 30 days (BRL)
leverageIndex	number|null	Liabilities / Assets ratio
numberOfShareholders	number|null	Total number of shareholders (cotistas)
ifixRepresentation	number|null	Fund weight in the IFIX index (%)
segment	string|null	FII market segment (e.g. RECEBÍVEIS IMOBILIÁRIOS)
manager	string|null	Fund manager name
managementType	string|null	ATIVA or PASSIVA
mandate	string|null	Fund mandate type (e.g. TÍTULOS E VALORES MOBILIÁRIOS). null when not disclosed
ipoDate	string|null	IPO date (DD/MM/YYYY)
ipoValue	number|null	Share price at IPO (BRL)
totalShares	number|null	Total shares (cotas) outstanding
cnpj	string|null	Brazilian tax ID (XX.XXX.XXX/XXXX-XX)
administrator	string|null	Fund administrator institution
custody	string|null	Custodian institution
shareRegistration	string|null	Share registrar (Escrituração)
officialFundUrl	string|null	Official fund website URL. null when not listed
adminFeeYearValue	number|null	Total admin fee paid in the reference year (BRL)
adminFeeOverBookValue	number|null	Admin fee as % of book-value patrimony
adminFeeOverMarketValue	number|null	Admin fee as % of market-value patrimony
propertyAppraiser	string|null	Real estate appraiser firm (Avaliador Imobiliário). null when not applicable
auditor	string|null	Accounting auditor firm (Auditor Contábil). null when not disclosed
ablM2	number|null	Total gross leasable area in m² (ABL). null for non-property funds
vacancyRate	number|null	Physical vacancy rate (%). Property funds only; null otherwise
occupancyRate	number|null	Physical occupancy rate (%). Property funds only; null otherwise
vacancyM2	number|null	Vacant leasable area in m². Property funds only; null otherwise
occupiedM2	number|null	Occupied leasable area in m². Property funds only; null otherwise
vacancyReferenceDate	string|null	Reference date for vacancy data (DD/MM/YYYY). Property funds only; null otherwise
priceHistory	array	Daily-ish share price for the last ~12 months. Each object: { date: "YYYY-MM-DD", value: number }
dividendYieldHistory	array	Monthly dividend yield for the last ~12 months. Each object: { date: "YYYY-MM-DD", value: number }

How much does it cost to scrape clubefii.com.br?

Each FII page requires a full Chromium browser load because the site is a JavaScript SPA. Despite that, the Actor is efficient: a run of 10 FII pages at the same time typically uses under 0.1 Compute Units (CUs).

Apify's free plan includes $5 of free usage per month — enough to scrape hundreds of FII pages at no cost — more than enough to estimate your costs.

Tips to keep costs low

• Pass only the FIIs you need in startUrls.
• The runner becomes more efficient if you call it with all the tickers you need at once instead of calling it one by one.
• If you run it with multiple tickers, remember to check the timeout limitation on Apify.
• You could change the fetch frequency to once-a-day or even once-a-week — that cadence is sufficient for most use cases.

FAQ

What are the available list of FIIs to scrape?

You can find a list of all FIIs supported on this page.

Some fields come back as null — is that expected?

Yes. Not every fund has every field populated on clubefii.com.br. Newer funds may have no 12-month DY history, and fields like ifixRepresentation only appear for IFIX-listed FIIs. Missing fields are set to null rather than omitted so the output schema is always consistent.

The price was not extracted — what happened?

The price header is the last element to render. If Playwright times out before the JS finishes, price will be null and the record is skipped. Re-running the Actor for the affected ticker usually resolves it. If the problem persists, open an issue on GitHub.

Is it legal to scrape clubefii.com.br?

This Actor collects only publicly available data — the same information any visitor sees without logging in. No private user data is collected. Review clubefii.com.br's Terms of Service before using scraped data in commercial products, and comply with LGPD (Brazil) and GDPR (EU) as applicable.

Support

If you encounter a bug or have any suggestion for this actor or for a new one, please feel free to reach us at contact.riseandcode@gmail.com and we'll look into it ASAP. We'll respond emails in English 🇺🇸 and Portuguese 🇧🇷.