You can access the ETF Holdings Tracker — Daily Constituents & Weights API programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "8djdYcblls6VdbhA9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nexgendata~etf-holdings-tracker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nexgendata-etf-holdings-tracker",
        "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/nexgendata~etf-holdings-tracker/runs": {
      "post": {
        "operationId": "runs-sync-nexgendata-etf-holdings-tracker",
        "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/nexgendata~etf-holdings-tracker/run-sync": {
      "post": {
        "operationId": "run-sync-nexgendata-etf-holdings-tracker",
        "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": {
          "etf_symbols": {
            "title": "ETF tickers",
            "type": "array",
            "description": "List of US-listed ETF tickers to pull holdings for. Each ETF is fetched independently and emits one holding record per constituent (typically 10-500 constituents per ETF depending on the index). Defaults to the three most-traded core ETFs (SPY/QQQ/VTI). Supports all 100+ ETFs covered by stockanalysis.com including iShares, Vanguard, State Street, Invesco, ARK, JPMorgan, Schwab issuers.",
            "default": [
              "SPY",
              "QQQ",
              "VTI"
            ],
            "items": {
              "type": "string"
            }
          },
          "limit": {
            "title": "Maximum holding records to return (across all ETFs)",
            "minimum": 0,
            "maximum": 50000,
            "type": "integer",
            "description": "Hard cap on total holding records emitted across every ETF requested. Set to 0 to disable the cap (you'll get every constituent of every ETF). This caps the dataset AFTER per-ETF max_holdings_per_etf has been applied — use it to bound cost.",
            "default": 1000
          },
          "max_holdings_per_etf": {
            "title": "Maximum holdings per ETF",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Cap on constituents returned per ETF. SPY has ~500, QQQ ~100, VTI ~3700, ARKK ~30. Use 10 for top-10 sampling, 100 for top-100 (standard institutional reporting), 0 for full holdings. Most ETF analytics workflows only need the top 50-100 names by weight.",
            "default": 100
          },
          "min_weight_pct": {
            "title": "Minimum constituent weight (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "Filter out tiny long-tail holdings below this weight threshold (in percent of ETF AUM). Use 0.5 to keep only meaningful positions (>0.5% of AUM), 1.0 for top-decile positions, 0 for everything including 0.01% positions. Useful for factor research where small-weight holdings are noise.",
            "default": 0
          },
          "country": {
            "title": "Holding country filter",
            "enum": [
              "all",
              "United States",
              "China",
              "Japan",
              "United Kingdom",
              "Canada",
              "Germany",
              "France",
              "Switzerland",
              "Taiwan",
              "India",
              "Brazil",
              "South Korea",
              "Netherlands",
              "Australia"
            ],
            "type": "string",
            "description": "Filter holdings by issuer country of incorporation. 'all' returns everything; pick a specific country to isolate (for example) Chinese ADRs inside KWEB or Japanese names inside EWJ. Most US-domiciled ETFs are 100% US holdings — this is primarily useful for international/global ETFs like EEM, EFA, VEA, IEMG.",
            "default": "all"
          },
          "issuer": {
            "title": "ETF issuer filter",
            "enum": [
              "all",
              "iShares",
              "Vanguard",
              "State Street",
              "Invesco",
              "ARK",
              "JPMorgan",
              "Schwab",
              "First Trust",
              "Direxion",
              "ProShares",
              "WisdomTree"
            ],
            "type": "string",
            "description": "Filter the requested ETFs by sponsor. Useful when you pass a long list of tickers but only want (e.g.) all iShares ETFs. 'all' returns every issuer. Issuer is inferred from the ETF's name.",
            "default": "all"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

ETF Holdings Download — Constituents, Weights & Shares OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for ETF Holdings Tracker — Daily Constituents & Weights API from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

ETF Holdings Tracker — Daily Constituents & Weights API API in Python

ETF Holdings Tracker — Daily Constituents & Weights API API in JavaScript

ETF Holdings Tracker — Daily Constituents & Weights API API through CLI

ETF Holdings Tracker — Daily Constituents & Weights API API

SEC Form 13F Tracker Pro — Institutional Holdings API

nexgendata/sec-form-13f-tracker-pro

Track 13F institutional holdings from SEC EDGAR — parsed, source-linked JSON for analysts, funds and AI agents.

NexGenData

SEC EDGAR Full-Text Search — Filings Query API

nexgendata/sec-edgar-search

Track SEC EDGAR full-text search results from SEC EDGAR — parsed, source-linked JSON for analysts, funds and AI agents.

NexGenData

ETF.com Scraper | ETF Data Holdings and Returns

parseforge/etf-com-scraper

Pull ETF data from ETF.com including ticker, issuer, expense ratio, AUM, holdings, sector breakdown, returns, dividend yield, and benchmark. Compare thousands of ETFs for portfolio analysis, fund research, finance dashboards, and investment screening at scale across markets.