> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Find ETFs

Find ETFs by details returns a list of ETFs that matched the query parameter.

The value can match with the ETF's name, ticker, or any market identifers.

<CodeGroup>
  ```bash API highlight={1,5} theme={null}
  curl -X POST 'https://api.bigdata.com/v1/knowledge-graph/etfs' \
    -H 'Content-Type: application/json' \
    -H 'X-API-KEY: <your-api-key>' \
    --data '{
    "query": "Gold"
  }'
  ```

  ```python Python SDK  theme={null}
  from dotenv import load_dotenv
  from bigdata_client import Bigdata
  import os

  load_dotenv()

  # Initialize the Bigdata API
  username = os.environ.get("BIGDATA_USERNAME")
  password = os.environ.get("BIGDATA_PASSWORD")
  bigdata = Bigdata(username, password)

  results = bigdata.knowledge_graph.find_etfs("Gold")

  for etf in results:
      print(f"Entity ID: {etf.id}")
      print(f"ETF Name: {etf.name}")
      print(f"Country: {etf.country}")  
      print(f"Description: {etf.description}")
      print(f"Website: {etf.webpage}")
      print(f"Ticker: {etf.ticker}\n")
  ```
</CodeGroup>

Output:

<CodeGroup>
  ```json API theme={null}
  {
    "results": [
      {
        "id": "C7D57E",
        "name": "Global X Physical Gold ETP",
        "description": "Global X Physical Gold (formerly ETFS Physical Gold) seeks to provide investment results that correspond generally to the price performance, before fees and expenses, of the Gold Price PM in Australian dollars. It was launched by Global X Metal Securities Australia Ltd. in March 2003.",
        "country": "AU",
        "sector": "Financials",
        "industry_group": "Nonequity Investment Instruments",
        "industry": "Nonequity Investment Instruments",
        "favicon": "https://www.globalxetfs.com.au/favicon.ico",
        "webpage": "https://www.globalxetfs.com.au/funds/gold/",
        "isin_values": [
          "AU00000GOLD7"
        ],
        "cusip_values": [
          "Q3525W135"
        ],
        "sedol_values": [
          "6605528"
        ],
        "listing_values": [
          "XASX:GOLD"
        ],
        "ticker": "GOLD"
      },
      {
        "id": "Q24KM1",
        "name": "Goldman Sachs Physical Gold ETF",
        "description": "The Goldman Sachs Physical Gold ETF is designed to track the performance of the physical gold market, providing investors with exposure to the precious metal. It offers a convenient and cost-effective way to invest in gold, without the need for physical storage or handling.",
        "country": "US",
        "sector": "Financials",
        "industry_group": "Investment Instruments",
        "industry": "Investment Instruments",
        "webpage": "http://www.aaauetf.com",
        "isin_values": [
          "US38150K1034"
        ],
        "cusip_values": [
          "38150K103"
        ],
        "sedol_values": [
          "BM8KQW9"
        ],
        "listing_values": [
          "XCBO:AAAU"
        ],
        "ticker": "AAAU"
      },
  ...
  ```

  ```txt Python SDK theme={null}
  Entity ID: C7D57E
  ETF Name: Global X Physical Gold ETP
  Country: Australia
  Description: Global X Physical Gold (formerly ETFS Physical Gold) seeks to provide investment results that correspond generally to the price performance, before fees and expenses, of the Gold Price PM in Australian dollars. It was launched by Global X Metal Securities Australia Ltd. in March 2003.
  Website: https://www.globalxetfs.com.au/funds/gold/
  Ticker: GOLD

  Entity ID: Q24KM1
  ETF Name: Goldman Sachs Physical Gold ETF
  Country: United States
  Description: The Goldman Sachs Physical Gold ETF is designed to track the performance of the physical gold market, providing investors with exposure to the precious metal. It offers a convenient and cost-effective way to invest in gold, without the need for physical storage or handling.
  Website: http://www.aaauetf.com
  Ticker: AAAU

  ...

  ```
</CodeGroup>
