The method find_topics returns a list of topics that matched the value parameter.

The value can match with the topic’s name, group, base topic, or description.

Once you have the IDs, you can use them to filter your search queries with an Topic query filter.

from dotenv import load_dotenv
from bigdata_client import Bigdata
import os

load_dotenv()

# Initialize the Bigdata API
username = os.environ.get("BIGDATA_USERNAME")
password = os.environ.get("BIGDATA_PASSWORD")
bigdata = Bigdata(username, password)

results = bigdata.knowledge_graph.find_topics("board")

for topic in results:
    print(f"Topic ID: {topic.id}")
    print(f"Topic: {topic.topic}")
    print(f"Group : {topic.topic_group}")
    print(f"Topic Name: {topic.name}")
    print(f"Description: {topic.description}\n")

Output:

Topic ID: business,labor-issues,board-member-appointment,,
Topic: business
Group : labor-issues
Topic Name: Board Member Appointment
Description: A new member of the board is appointed

Topic ID: business,investor-relations,board-meeting,,
Topic: business
Group : investor-relations
Topic Name: Board Meeting
Description: A formal gathering of the board of directors of a company  

...