Find by details
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.",
"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
}
}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
Find by details
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.",
"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
}
}Authorizations
Body
application/json
Request body for finding sources. Each field is optional. However, you must provide at least one field to perform a valid search.
Text query to search for sources by name or description. (e.g.,'MT Newswire', 'Benzinga', 'Bloomberg')
Example:
"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)
Pattern:
^[A-Z]{2}$Example:
["US", "FR", "GB"]
Source ranking from 1 to 5, where RANK_1 is the highest quality
Available options:
RANK_1, RANK_2, RANK_3, RANK_4, RANK_5 Example:
["RANK_1", "RANK_2", "RANK_3"]
Available source categories
Available options:
transcripts, research, podcasts, news, filings, expert_interviews Example:
[ "transcripts", "research", "podcasts", "news", "filings", "expert_interviews" ]
Filter sources by available data packages
Available options:
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 Example:
["sec_filings"]
Response
200 - application/json
Successful response with source data
Was this page helpful?
⌘I