Find your category ID

Every report call requires a category_id. Here’s how to look one up programmatically.

Every report endpoint (/v1/reports/visibility, /v1/reports/citations, /v1/reports/sentiment) requires a category_id. List the categories your key can see and pick the right one.

How this example works

1. One call lists everything. No filters, no pagination.
2. Match by name if you know what you’re looking for, or print them all if you don’t.

Python

import os
from profound import Profound

client = Profound(api_key=os.environ["PROFOUND_API_KEY"])

categories = client.organizations.categories.list()

# Print every category your key can see.
for c in categories:
    print(f"{c.id}  {c.name}")

# Or: find one by name.
TARGET = "<your-category-name>"
match = next((c for c in categories if c.name == TARGET), None)
if match:
    print(f"\nFound Category '{TARGET}': {match.id}")