---
title: "Find by details"
method: POST
path: "/v1/knowledge-graph/etfs"
tags: ["ETFs"]
---

# Find by details

`POST /v1/knowledge-graph/etfs`

Find exchange-traded funds through a comprehensive search. Search by name, ticker, or description and filter by country to discover relevant ETFs for your investment research.

## Request body

- FindETFsRequest — Request body for finding ETFs. Each field is optional. However, you must provide at least one field to perform a valid search.
  - `query` string — Text query to search for ETFs by name, ticker, or description. Examples: 'Gold', 'SPDR', 'Vanguard'
  - `countries` string[] — Country codes using the ISO 3166-1 A-2 format (e.g., 'US' for United States, 'FR' for France, 'GB' for Great Britain)

## Response `200`

Successful response with ETF data

- FindETFsResponse — Response containing ETF results and metadata
  - `results` ETF[], required — Array of ETF results
    - `id` string, required — Unique ETF identifier in the Knowledge Graph
    - `name` string, required — ETF name
    - `description` string — ETF description and overview
    - `country` string, required — Country code (ISO 3166-1 alpha-2)
    - `sector` string — ETF sector classification
    - `industry_group` string — Industry group classification
    - `industry` string — Specific industry classification
    - `webpage` string, uri — ETF website URL
    - `favicon` string, uri — ETF favicon URL
    - `isin_values` string[] — International Securities Identification Numbers
    - `cusip_values` string[] — Committee on Uniform Securities Identification Procedures numbers
    - `sedol_values` string[] — Stock Exchange Daily Official List numbers
    - `listing_values` string[] — Exchange listing identifiers
    - `ticker` string, required — Primary ticker symbol
  - `metadata` object, required
    - `request_id` string, required — Unique request identifier
    - `timestamp` string, date-time, required — Response timestamp
  - `usage` Usage
    - `knowledge_graph_tokens` integer, required — Number of tokens consumed by this request.

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)