Find by details

Find by details

curl --request POST \
  --url https://api.bigdata.com/v1/knowledge-graph/topics \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "query": "Earnings",
  "groups": [
    "earnings"
  ]
}
'

import requests

url = "https://api.bigdata.com/v1/knowledge-graph/topics"

payload = {
    "query": "Earnings",
    "groups": ["earnings"]
}
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: 'Earnings', groups: ['earnings']})
};

fetch('https://api.bigdata.com/v1/knowledge-graph/topics', 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/topics",
  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' => 'Earnings',
    'groups' => [
        'earnings'
    ]
  ]),
  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/topics"

	payload := strings.NewReader("{\n  \"query\": \"Earnings\",\n  \"groups\": [\n    \"earnings\"\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/topics")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"Earnings\",\n  \"groups\": [\n    \"earnings\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bigdata.com/v1/knowledge-graph/topics")

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\": \"Earnings\",\n  \"groups\": [\n    \"earnings\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "id": "business,earnings,earnings,,",
      "name": "Earnings",
      "description": "Net income of a company",
      "topic": "business",
      "group": "earnings",
      "type": "earnings",
      "subtype": "<string>"
    }
  ],
  "metadata": {
    "request_id": "2a25111e-0043-4fe2-946e-668aa5af928a",
    "timestamp": "2026-07-02T13:24:45.163695+00:00"
  },
  "usage": {
    "knowledge_graph_tokens": 1
  }
}

POST

knowledge-graph

topics

Find by details

curl --request POST \
  --url https://api.bigdata.com/v1/knowledge-graph/topics \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "query": "Earnings",
  "groups": [
    "earnings"
  ]
}
'

import requests

url = "https://api.bigdata.com/v1/knowledge-graph/topics"

payload = {
    "query": "Earnings",
    "groups": ["earnings"]
}
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: 'Earnings', groups: ['earnings']})
};

fetch('https://api.bigdata.com/v1/knowledge-graph/topics', 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/topics",
  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' => 'Earnings',
    'groups' => [
        'earnings'
    ]
  ]),
  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/topics"

	payload := strings.NewReader("{\n  \"query\": \"Earnings\",\n  \"groups\": [\n    \"earnings\"\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/topics")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"Earnings\",\n  \"groups\": [\n    \"earnings\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bigdata.com/v1/knowledge-graph/topics")

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\": \"Earnings\",\n  \"groups\": [\n    \"earnings\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "id": "business,earnings,earnings,,",
      "name": "Earnings",
      "description": "Net income of a company",
      "topic": "business",
      "group": "earnings",
      "type": "earnings",
      "subtype": "<string>"
    }
  ],
  "metadata": {
    "request_id": "2a25111e-0043-4fe2-946e-668aa5af928a",
    "timestamp": "2026-07-02T13:24:45.163695+00:00"
  },
  "usage": {
    "knowledge_graph_tokens": 1
  }
}

Authorizations

X-API-KEY

string

header

required

Body

application/json

Request body for finding topics. 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/topics/values/{filter}.

query

string

Text query to search for topics by name or description. Examples: 'Earnings', 'Board Member Appointment'

Example:

"Earnings"

topics

string[]

Top-level topics, as published in the topic field of results (e.g., 'business')

Example:

["business"]

groups

string[]

Topic groups, as published in the group field of results (e.g., 'earnings', 'investor-relations')

Example:

["earnings"]

types

string[]

Topic types, as published in the type field of results (e.g., 'earnings', 'earnings-call')

Example:

["earnings-call"]

subtypes

string[]

Topic subtypes, as published in the subtype field of results

Example:

[]

Response

200 - application/json

Successful response with topics data

Response containing topics results and metadata

results

object[]

required

Array of topics results

Show child attributes

metadata

object

required

Show child attributes

usage

object

Optional. Present for token-billing accounts only. Reports the number of tokens consumed by this request.

Show child attributes

API

Knowledge Graph

Search Service

Watchlists

Monitors

Research Service

Content

Structured Data

Subscription

SDK

Authorizations

Body

Response