Profound

Profound Categories API

The Categories API from Profound — 10 operation(s) for categories.

GitHub OpenAPI

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/org/categories List the organization's categories · Get Categories #
Ask an LLM
“Which tracking categories are set up for my organization?”
“Can I list categories for several organizations at once?”
Tell an agent
List all of my categories.
Show the categories belonging to organizations {organization_ids}.
GET /v1/org/categories/{category_id}/topics List the topics in a category · Get Category Topics #
Ask an LLM
“What topics are defined under one of my categories?”
“Where do I find topic IDs to filter a category's prompts by?”
Tell an agent
List the topics in category {category_id}.
Show me every topic configured for category {category_id}.
GET /v1/org/categories/{category_id}/tags List the prompt tags in a category · Get Category Tags #
Ask an LLM
“What tags are used to label prompts in my category?”
“Can I get the tag IDs for a single category?”
Tell an agent
List the tags for category {category_id}.
Get every prompt tag defined in category {category_id}.
GET /v1/org/categories/{category_id}/regions List the regions tracked in a category · Get Category Regions #
Ask an LLM
“Which geographic regions does one of my categories track?”
“Can I find region IDs scoped to a single category?”
Tell an agent
List the regions for category {category_id}.
Which countries or regions are enabled in category {category_id}? List them.
GET /v1/org/categories/{category_id}/citation-categories List citation buckets for a category · Get Category Citation Categories #
Ask an LLM
“How are cited sources grouped into buckets in my category?”
“Does a category have custom citation categories on top of the built-in ones?”
Tell an agent
List the citation categories for category {category_id}.
Show built-in and custom source buckets used by category {category_id}.
GET /v1/org/categories/{category_id}/citation-tags List custom citation tags for a category · Get Category Citation Tags #
Ask an LLM
“What custom labels have we defined for cited sources in a category?”
“Can I see the citation tags my team created for one category?”
Tell an agent
List the custom citation tags in category {category_id}.
Get the source labels our team defined for citations in category {category_id}.
GET /v1/org/categories/{category_id}/prompts List prompts tracked in a category · List prompts #
Ask an LLM
“Which prompts are we tracking in a category?”
“Can I filter a category's prompts by topic, region, platform or persona?”
Tell an agent
List the prompts in category {category_id}.
Show prompts in category {category_id} with status {status} for topic {topic_id}.
POST /v1/org/categories/{category_id}/prompts Add new prompts to a category · Create prompts #
Ask an LLM
“How do I start tracking new prompts in a category?”
“Can I preview new prompts with a dry run before they're saved?”
Tell an agent
Add these prompts {prompts} to category {category_id}.
Dry-run adding prompts {prompts} to category {category_id} (dry_run {dry_run}) without saving.
PATCH /v1/org/categories/{category_id}/prompts Edit existing prompts in a category · Update prompts #
Ask an LLM
“Can I change the wording or tags of prompts already in a category?”
“If I send new regions for an existing prompt, do they replace the old set?”
Tell an agent
Apply these edits {prompts} to existing prompts in category {category_id}.
Preview changing existing prompts {prompts} in category {category_id} with dry_run {dry_run}.
PATCH /v1/org/categories/{category_id}/prompts/status Activate, disable or delete prompts · Update prompt status #
Ask an LLM
“How can I pause prompts so they stop running daily but keep their history?”
“What happens to historical data when I mark prompts as deleted?”
Tell an agent destructive · confirm first
Set prompts {prompt_ids} in category {category_id} to {status}.
Disable prompts {prompt_ids} in category {category_id} so they stop running.
GET /v1/org/categories/{category_id}/assets List the brands tracked in a category · Get Category Assets #
Ask an LLM
“Which brands or assets are being compared within one category?”
“Can I get the asset IDs for a single category?”
Tell an agent
List the assets in category {category_id}.
Show the brands tracked under category {category_id}.
GET /v1/org/categories/{category_id}/personas List the personas in a category · Get Category Personas #
Ask an LLM
“Which audience personas are prompts run as in one category?”
“Can I fetch persona IDs for a specific category?”
Tell an agent
List the personas for category {category_id}.
Show the audience personas configured in category {category_id}.

Documentation

📖
Documentation
https://docs.tryprofound.com/rest-api/introduction
📖
APIReference
https://docs.tryprofound.com/api-reference/organization/get-categories
📖
Authentication
https://docs.tryprofound.com/rest-api/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/profound/refs/heads/main/openapi/profound-categories-api-openapi.yml

Other Resources

🔗
OpenAPI Source
https://api.tryprofound.com/openapi.json
🔗
ChangeLog
https://docs.tryprofound.com/rest-api/changelog

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/profound:profound-categories-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

profound-categories-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: External Categories API
  version: 6551bd49db665ffb7f80780b3e150b8e8b780cc3
servers:
- url: https://api.tryprofound.com
  description: Production Server
tags:


# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/profound/refs/heads/main/openapi/profound-categories-api-openapi.yml