fiis 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.
What is the fiis 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace fiis-com-br-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: fiis.com.br SDK — Brazilian FII fund data, bounded and re-runnable."""
from parse_apis.fiis_com_br_api import Fiis, FundNotFound
client = Fiis()
# List available funds (capped to 5 for demonstration).
for summary in client.fundsummaries.list(limit=5):
print(summary.ticker, summary.name)
# Drill into one fund's full details via the summary's .details() navigation.
summary = client.fundsummaries.list(limit=1).first()
fund = summary.details()
print(fund.ticker, fund.name, fund.current_price, fund.p_vp)
print(fund.administration.administrator)
# Access dividend history as a sub-resource of a fund.
for div in client.fund("MXRF11").dividends.list(limit=3):
print(div.base_date, div.payment_date, div.value, div.dividend_yield)
# Typed error handling: catch a not-found ticker.
try:
bad = client.funds.get(ticker="ZZZZ99")
print(bad.name)
except FundNotFound as exc:
print(f"Fund not found: {exc.ticker}")
print("exercised: fundsummaries.list / details / funds.get / fund.dividends.list")
List all investing funds (FIIs) available on fiis.com.br. Returns an array of fund tickers with names and detail page URLs. No filtering or pagination — the full catalogue is returned in a single response.
No input parameters required.
{
"type": "object",
"fields": {
"funds": "array of fund summary objects with ticker, name, and url",
"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 API
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.
The fiis API is a managed, monitored endpoint for fiis.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fiis.com.br changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official fiis.com.br API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.