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

# Find by details

`POST /v1/knowledge-graph/sources`

Locate and explore data sources and information providers within the knowledge graph. Filter sources by country, rank, and category to find the most relevant information providers.

## Request body

- FindSourcesRequest — Request body for finding sources. Each field is optional. However, you must provide at least one field to perform a valid search.
  - `query` string — Text query to search for sources by name or description. (e.g.,'MT Newswire', 'Benzinga', 'Bloomberg')
  - `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)
  - `ranks` string[] — Source ranking from 1 to 5, where RANK_1 is the highest quality
  - `categories` string[] — Available source categories
  - `packages` string[] — Filter sources by available data packages

## Response `200`

Successful response with source data

- FindSourcesResponse — Response containing source results and metadata
  - `results` Source[], required — Array of source results
    - `id` string, required — Unique source identifier in the Knowledge Graph
    - `name` string, required — Source name
    - `description` string — Source description and overview
    - `country` string, required — Country code (ISO 3166-1 alpha-2)
    - `rank` 'RANK_1' | 'RANK_2' | 'RANK_3' | 'RANK_4' | 'RANK_5', required — Source ranking from 1 to 5
    - `retention` string — Data retention policy for the source
    - `webpage` string — Source webpage or platform
    - `categories` string[] — Source categories
    - `packages` string[] — Available data packages for this source
    - `subscribed` boolean — Whether the user is subscribed to this source
  - `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)