# ClubeFII Scraper (`riseandcode/apify-clubefii`) Actor Extract 45+ structured fields from Brazilian FIIs (the local equivalent of REITs) on clubefii.com.br. Get price, dividend yield, P/VP, NAV, vacancy rates, admin fees, and more. No official API exists; this Actor fills the gap. You can use these data to spot opportunities across the whole market. - **URL**: https://apify.com/riseandcode/apify-clubefii.md - **Developed by:** [Rise and Code](https://apify.com/riseandcode) (community) - **Categories:** Real estate, Other, Automation - **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $80.00 / 1,000 cost per results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What does ClubeII FII Scraper do? **ClubeII FII Scraper** extracts structured investment data from [clubefii.com.br](https://www.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](https://apify.com/rise-and-code/clubefii-scraper) on Apify and click **Try for free** — no credit card required. 2. In the **Input** tab, add one or more `clubefii.com.br/fiis/` 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: ```bash curl -X POST \ "https://api.apify.com/v2/acts/riseandcode~apify-clubefii/runs?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/` page URLs. | Example: ```json { "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 ```json { "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](https://apify.com/pricing) 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](https://www.clubefii.com.br/fundo_imobiliario_lista). #### 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](https://www.clubefii.com.br) 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 and we'll look into it ASAP. We'll respond emails in English 🇺🇸 and Portuguese 🇧🇷. # Actor input Schema ## `startUrls` (type: `array`): List of clubefii.com.br FII detail page URLs to scrape (e.g. https://www.clubefii.com.br/fiis/MXRF11). You can find a list of all FIIs supported at https://www.clubefii.com.br/fundo\_imobiliario\_lista. ## `proxyConfiguration` (type: `object`): Proxy settings to avoid being blocked. Residential proxies are recommended. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.clubefii.com.br/fiis/MXRF11" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BR" } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.clubefii.com.br/fiis/MXRF11" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("riseandcode/apify-clubefii").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.clubefii.com.br/fiis/MXRF11" }] } # Run the Actor and wait for it to finish run = client.actor("riseandcode/apify-clubefii").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.clubefii.com.br/fiis/MXRF11" } ] }' | apify call riseandcode/apify-clubefii --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=riseandcode/apify-clubefii", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ClubeFII Scraper", "description": "Extract 45+ structured fields from Brazilian FIIs (the local equivalent of REITs) on clubefii.com.br. Get price, dividend yield, P/VP, NAV, vacancy rates, admin fees, and more. No official API exists; this Actor fills the gap. You can use these data to spot opportunities across the whole market.", "version": "1.0", "x-build-id": "aNIaX4bT1wFWkfKkT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/riseandcode~apify-clubefii/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-riseandcode-apify-clubefii", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/riseandcode~apify-clubefii/runs": { "post": { "operationId": "runs-sync-riseandcode-apify-clubefii", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/riseandcode~apify-clubefii/run-sync": { "post": { "operationId": "run-sync-riseandcode-apify-clubefii", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "FII URLs", "type": "array", "description": "List of clubefii.com.br FII detail page URLs to scrape (e.g. https://www.clubefii.com.br/fiis/MXRF11). You can find a list of all FIIs supported at https://www.clubefii.com.br/fundo_imobiliario_lista.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings to avoid being blocked. Residential proxies are recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BR" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```