curl --request POST \
--url https://api.bigdata.com/v1/knowledge-graph/sources \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"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"
]
}
'import requests
url = "https://api.bigdata.com/v1/knowledge-graph/sources"
payload = {
"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"]
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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']
})
};
fetch('https://api.bigdata.com/v1/knowledge-graph/sources', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bigdata.com/v1/knowledge-graph/sources",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bigdata.com/v1/knowledge-graph/sources"
payload := strings.NewReader("{\n \"query\": \"MT Newswire\",\n \"countries\": [\n \"US\",\n \"FR\",\n \"GB\"\n ],\n \"ranks\": [\n \"RANK_1\",\n \"RANK_2\",\n \"RANK_3\"\n ],\n \"categories\": [\n \"transcripts\",\n \"research\",\n \"podcasts\",\n \"news\",\n \"filings\",\n \"expert_interviews\"\n ],\n \"packages\": [\n \"sec_filings\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bigdata.com/v1/knowledge-graph/sources")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"MT Newswire\",\n \"countries\": [\n \"US\",\n \"FR\",\n \"GB\"\n ],\n \"ranks\": [\n \"RANK_1\",\n \"RANK_2\",\n \"RANK_3\"\n ],\n \"categories\": [\n \"transcripts\",\n \"research\",\n \"podcasts\",\n \"news\",\n \"filings\",\n \"expert_interviews\"\n ],\n \"packages\": [\n \"sec_filings\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bigdata.com/v1/knowledge-graph/sources")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"MT Newswire\",\n \"countries\": [\n \"US\",\n \"FR\",\n \"GB\"\n ],\n \"ranks\": [\n \"RANK_1\",\n \"RANK_2\",\n \"RANK_3\"\n ],\n \"categories\": [\n \"transcripts\",\n \"research\",\n \"podcasts\",\n \"news\",\n \"filings\",\n \"expert_interviews\"\n ],\n \"packages\": [\n \"sec_filings\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"id": "97C483",
"name": "Personal Finance with Warren Ingram",
"country": "ZA",
"rank": "RANK_1",
"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.",
"language": "English",
"retention": "FULL_HISTORY",
"favicon": "https://www.podchaser.com/favicon.ico",
"webpage": "TV and Radio Transcripts",
"categories": [
"podcasts"
],
"packages": [
"podcasts",
"all"
],
"tiers": [
"podcasts"
],
"subscribed": true
}
],
"metadata": {
"request_id": "user_2k3Z4SerTUIieyCfQhGR5UF2Af3",
"timestamp": "2025-09-30T07:23:05.019121+00:00"
},
"usage": {
"knowledge_graph_tokens": 1
}
}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.
curl --request POST \
--url https://api.bigdata.com/v1/knowledge-graph/sources \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"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"
]
}
'import requests
url = "https://api.bigdata.com/v1/knowledge-graph/sources"
payload = {
"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"]
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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']
})
};
fetch('https://api.bigdata.com/v1/knowledge-graph/sources', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bigdata.com/v1/knowledge-graph/sources",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bigdata.com/v1/knowledge-graph/sources"
payload := strings.NewReader("{\n \"query\": \"MT Newswire\",\n \"countries\": [\n \"US\",\n \"FR\",\n \"GB\"\n ],\n \"ranks\": [\n \"RANK_1\",\n \"RANK_2\",\n \"RANK_3\"\n ],\n \"categories\": [\n \"transcripts\",\n \"research\",\n \"podcasts\",\n \"news\",\n \"filings\",\n \"expert_interviews\"\n ],\n \"packages\": [\n \"sec_filings\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bigdata.com/v1/knowledge-graph/sources")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"MT Newswire\",\n \"countries\": [\n \"US\",\n \"FR\",\n \"GB\"\n ],\n \"ranks\": [\n \"RANK_1\",\n \"RANK_2\",\n \"RANK_3\"\n ],\n \"categories\": [\n \"transcripts\",\n \"research\",\n \"podcasts\",\n \"news\",\n \"filings\",\n \"expert_interviews\"\n ],\n \"packages\": [\n \"sec_filings\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bigdata.com/v1/knowledge-graph/sources")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"MT Newswire\",\n \"countries\": [\n \"US\",\n \"FR\",\n \"GB\"\n ],\n \"ranks\": [\n \"RANK_1\",\n \"RANK_2\",\n \"RANK_3\"\n ],\n \"categories\": [\n \"transcripts\",\n \"research\",\n \"podcasts\",\n \"news\",\n \"filings\",\n \"expert_interviews\"\n ],\n \"packages\": [\n \"sec_filings\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"id": "97C483",
"name": "Personal Finance with Warren Ingram",
"country": "ZA",
"rank": "RANK_1",
"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.",
"language": "English",
"retention": "FULL_HISTORY",
"favicon": "https://www.podchaser.com/favicon.ico",
"webpage": "TV and Radio Transcripts",
"categories": [
"podcasts"
],
"packages": [
"podcasts",
"all"
],
"tiers": [
"podcasts"
],
"subscribed": true
}
],
"metadata": {
"request_id": "user_2k3Z4SerTUIieyCfQhGR5UF2Af3",
"timestamp": "2025-09-30T07:23:05.019121+00:00"
},
"usage": {
"knowledge_graph_tokens": 1
}
}Authorizations
Body
Request body for finding sources. Each field is optional. However, you must provide at least one field to perform a valid search. The values a filter accepts can be listed with GET /v1/knowledge-graph/sources/values/{filter}, except packages, categories and tiers, which cannot be enumerated.
Text query to search for sources by name or description. (e.g.,'MT Newswire', 'Benzinga', 'Bloomberg')
"MT Newswire"
Country codes using the ISO 3166-1 A-2 format (e.g., 'US' for United States, 'FR' for France, 'GB' for Great Britain)
^[A-Z]{2}$["US", "FR", "GB"]
Source ranking from 1 to 5, where RANK_1 is the highest quality
RANK_1, RANK_2, RANK_3, RANK_4, RANK_5 ["RANK_1", "RANK_2", "RANK_3"]
Filter sources by the language of their content, as published in the language field of results. Values are language names rather than ISO codes (e.g., 'English', not 'en')
["English"]
Available source categories
transcripts, research, podcasts, news, filings, expert_interviews [
"transcripts",
"research",
"podcasts",
"news",
"filings",
"expert_interviews"
]
Filter sources by available data packages
alliance_news, benzinga, crypto_markets, expert_networks, financial_newswires, fly_on_the_wall, fxstreet, middle_eastern_markets, midnight_trader, quartr_presentation_materials, quartr_reports, quartr_transcripts, rp_factset_earnings_comparision, rp_multi_source_earnings_comparision, sec_filings, public ["sec_filings"]
Filter sources by content tier, as published in the tiers field of results (e.g., 'web', 'premium-news')
["premium-news"]
Response
Successful response with source data
Was this page helpful?