blackrock.com APIblackrock.com ↗
Access iShares ETF data via API: holdings, performance, sector breakdowns, fees, distributions, and fund overviews for the full iShares fund lineup.
curl -X GET 'https://api.parse.bot/scraper/99f6f8be-3a27-4bc8-92de-7e611b0076fe/get_etf_list?limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full list of iShares ETFs with ticker, fund name, inception date, expense ratios, net assets, yield, and YTD return.
| Param | Type | Description |
|---|---|---|
| limit | integer | Max results to return (0 for all). |
{
"type": "object",
"fields": {
"data": "array of ETF summary objects with ticker, fund_name, product_id, inception_date, gross_expense_ratio, net_expense_ratio, net_assets, yield_12m, ytd_return, asset_class, product_page_url",
"status": "string indicating success"
},
"sample": {
"data": [
{
"ticker": "MCHI",
"fund_name": "iShares MSCI China ETF",
"yield_12m": 2.27,
"net_assets": 6746261625.79,
"product_id": "239619",
"ytd_return": -7.46,
"asset_class": "Equity",
"inception_date": "Mar 29, 2011",
"product_page_url": "/us/products/239619/ishares-msci-china-etf",
"net_expense_ratio": 0.59,
"gross_expense_ratio": 0.59
}
],
"status": "success"
}
}About the blackrock.com API
The BlackRock iShares ETF API exposes 10 endpoints covering the full iShares fund catalog, from listing all ETFs with expense ratios and net assets via get_etf_list, to retrieving per-position holdings weights and identifiers, multi-period performance returns, sector allocations, and distribution history. Each endpoint returns structured JSON, making it straightforward to query individual funds by ticker or search across the entire lineup by keyword.
ETF Discovery and Search
The get_etf_list endpoint returns the complete iShares fund catalog, with each record including ticker, fund_name, product_id, inception_date, gross_expense_ratio, net_expense_ratio, and net_asset. An optional limit parameter controls how many records are returned (pass 0 for the full set). For targeted lookups, search_etfs accepts a query string — case-insensitive, matches on ticker or fund name — and returns matching funds with their product_page_url. The get_broad_market_index_etfs endpoint narrows the list to well-known index trackers like S&P 500, Russell 2000, MSCI World, and Aggregate Bond funds without requiring any parameters.
Fund Detail Endpoints
get_etf_overview takes a ticker and returns a single object with nav, yield, net_assets, expense_ratio, asset_class, market_region, and investment_style. get_etf_key_facts supplements this with pe_ratio, pb_ratio, dividend_yield, and total_holdings count. get_etf_fees isolates the cost fields — gross_expense_ratio, net_expense_ratio, and management_fee — which is useful when comparing cost structures across funds without pulling the full overview payload.
Holdings and Sector Data
get_etf_holdings returns the complete position list for a fund, including each holding's weight, name, and identifiers. An optional as_of_date parameter (format YYYYMMDD) allows retrieval of historical snapshots. The get_etf_holdings_download endpoint returns the same schema and is suited for bulk ingestion workflows. get_etf_sector_breakdown aggregates positions into a sectors array sorted by weight descending, covering the standard sector classifications used across iShares equity funds.
Performance and Distributions
get_etf_performance returns a performance object with named fields for ytd, 1y, 3y, 5y, 10y, and since_inception returns, alongside a distributions array containing the full payout history. This makes it possible to track both trailing return windows and individual cash distribution records for a given fund in a single call.
- Build an ETF screener that filters funds by net_expense_ratio, asset_class, and YTD return using get_etf_list and get_etf_overview
- Track holdings drift over time by comparing get_etf_holdings snapshots across different as_of_date values
- Construct a sector exposure model across a portfolio by aggregating get_etf_sector_breakdown results for multiple tickers
- Monitor distribution history and payout frequency for income-focused ETF selection using get_etf_performance
- Compare management_fee and gross vs. net expense ratios across competing funds with get_etf_fees
- Populate a fund factsheet with NAV, PE ratio, PB ratio, inception date, and dividend yield from get_etf_key_facts
- Index the full iShares catalog for search autocomplete using the ticker and fund_name fields from search_etfs
| 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 BlackRock provide an official developer API for iShares data?+
What does get_etf_holdings return, and can I retrieve historical snapshots?+
ticker, as_of_date, total_holdings, and a holdings array of position objects that include individual weights and identifiers. Pass the optional as_of_date parameter in YYYYMMDD format to retrieve holdings as of a specific past date rather than the current portfolio.Does the API cover iShares ETFs listed outside the US, such as UCITS funds traded on European exchanges?+
Are options data, real-time NAV intraday quotes, or bid-ask spreads available through this API?+
How current is the holdings data returned by get_etf_holdings?+
as_of_date field in each response indicates the date of the underlying portfolio snapshot. Some funds may update less frequently depending on the asset class.