Sign in

v1

latestOpenAPI 3.1.02026-07-2268276396.6 KB
Sources

Find by details

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.

post/v1/knowledge-graph/sources

Request body

querystring

Text query to search for sources by name or description. (e.g.,'MT Newswire', 'Benzinga', 'Bloomberg')

countriesstring[]

Country codes using the ISO 3166-1 A-2 format (e.g., 'US' for United States, 'FR' for France, 'GB' for Great Britain)

ranksstring[]

Source ranking from 1 to 5, where RANK_1 is the highest quality

categoriesstring[]

Available source categories

packagesstring[]

Filter sources by available data packages

Example request

{
  "query": "MT Newswire",
  "countries": [
    "US",
    "FR",
    "GB"
  ],
  "ranks": [
    "RANK_1",
    "RANK_2",
    "RANK_3"
  ],
  "categories": [
    "transcripts",
    "research",
    "podcasts",
    "news",
    "filings",
    "expert_interviews"
  ],
  "packages": [
    "sec_filings"
  ]
}

Response

Successful response with source data

Example response

{
  "results": [
    {
      "id": "97C483",
      "name": "Personal Finance with Warren Ingram",
      "description": "Personal Finance with Warren Ingram is a program that provides practical advice on money management, including guidance on investing, retirement planning, and wealth creation, through its podcast.",
      "country": "ZA",
      "rank": "RANK_1",
      "retention": "FULL_HISTORY",
      "webpage": "TV and Radio Transcripts",
      "categories": [
        "podcasts"
      ],
      "packages": [
        "podcasts",
        "all"
      ],
      "subscribed": true
    }
  ],
  "metadata": {
    "request_id": "user_2k3Z4SerTUIieyCfQhGR5UF2Af3",
    "timestamp": "2025-09-30T07:23:05.019121+00:00"
  },
  "usage": {
    "knowledge_graph_tokens": 1
  }
}