fiis.com.br APIfiis.com.br ↗
Access fund listings, financial metrics, and full dividend history for Brazilian real estate investment funds (FIIs) via the fiis.com.br API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/6762562c-9905-4830-8042-efe6d76265d6/search_funds' \ -H 'X-API-Key: $PARSE_API_KEY'
List all investing funds (FIIs) available on the site. Returns an array of fund tickers with names and URLs.
No input parameters required.
{
"type": "object",
"fields": {
"funds": "array of objects with ticker, name, and url for each fund",
"total": "integer total number of funds returned"
},
"sample": {
"data": {
"funds": [
{
"url": "https://fiis.com.br/mxrf11/",
"name": "MXRF11",
"ticker": "MXRF11"
},
{
"url": "https://fiis.com.br/snag11/",
"name": "SNAG11",
"ticker": "SNAG11"
}
],
"total": 668
},
"status": "success"
}
}About the fiis.com.br API
The fiis.com.br API provides access to Brazilian real estate investment fund (FII) data across 3 endpoints, covering everything from a complete fund directory to per-ticker financials and dividend history. The get_fund endpoint returns fields like current price in BRL, P/VP ratio, equity, total shareholders, and the most recent dividend with its yield and payment date. The get_dividends endpoint exposes the full historical payout record for any fund ticker.
Fund Discovery and Directory
The search_funds endpoint takes no inputs and returns a full array of FII tickers available on fiis.com.br, including each fund's name, ticker code, and URL. The total field tells you exactly how many funds are indexed. This is the natural starting point for building a screener or keeping a local fund universe up to date.
Per-Fund Financial Metrics
For any individual ticker (e.g. MXRF11), get_fund returns a detailed snapshot. Key pricing fields include current_price (BRL) and p_vp (price-to-book ratio). The last_dividend object breaks down the most recent distribution: value, yield_percent, the base_date and payment_date, and the base_price used to calculate yield. Administration data — administrator name and administrator_cnpj — is returned under the administration object. The financial_info block contains equity, total_shares, total_shareholders, cnpj, and segment.
Dividend History
The get_dividends endpoint accepts a required ticker parameter and returns the complete available payout history as an array of records. Each record in dividend_history includes type, base_date, payment_date, closing_price at the record date, dividend_yield, and value. The total_records field gives the count of entries returned, useful for detecting funds with limited history.
Data Scope and Freshness
All monetary values are denominated in Brazilian Reais (BRL). Coverage is limited to FIIs listed on fiis.com.br; funds not tracked by the site will return no data. The financial_info segment classification follows the taxonomy used by fiis.com.br, which reflects CVM-registered fund categories common in the Brazilian market.
- Screen all listed FIIs by P/VP ratio using data from
get_fundto identify funds trading below book value - Build a dividend calendar by pulling
payment_dateandvaluefromget_dividendsfor a portfolio of tickers - Track yield trends over time using
dividend_yieldandclosing_pricerecords from the full dividend history - Populate a fund database with administrator names, CNPJs, and segment classifications from
financial_infoandadministration - Monitor the latest dividend yield and base price for any FII using the
last_dividendobject fromget_fund - Enumerate the full FII universe with
search_fundsto detect newly listed or delisted funds - Compare total shareholder counts across funds using
total_shareholdersfromfinancial_info
| 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.
Does fiis.com.br have an official developer API?+
What does `get_dividends` return, and how far back does the history go?+
type, base_date, payment_date, closing_price, dividend_yield, and value. The depth of history varies by fund; the total_records field tells you how many entries were returned. There is no date-range filter parameter — you receive the full available history in one call.Does the API cover FII price history or intraday quotes?+
get_fund returns only the current share price and the closing price associated with each dividend record in get_dividends. You can fork this API on Parse and revise it to add a price-history endpoint if fiis.com.br exposes that data.Can I filter `search_funds` results by segment or fund type?+
search_funds endpoint returns the full fund list without filtering options — it returns ticker, name, and URL for every fund indexed. Segment data is available at the individual fund level via the financial_info.segment field in get_fund. You can fork this API on Parse and revise it to add server-side segment filtering if needed.