Skip to main content
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.
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}")