Top terms
Ranked topic or organization terms across matching proof-point documents.
Top terms returns the most frequent topics or organizations in matching proof points. Use it to see which entities dominate a filtered corpus.
Endpoints:
POST /proof-points/top-terms— all document types — playgroundPOST /proof-points/news-articles/top-termsPOST /proof-points/patents/top-termsPOST /proof-points/research-articles/top-termsPOST /proof-points/earnings-calls/top-termsPOST /proof-points/pdfs/top-termsPOST /proof-points/projects/top-terms
Type-specific routes apply the same request on one dataset. Shared proof-point filters (query, topicQuery, gpeQuery, start / end, and so on) still apply.
Field
| Field | Purpose |
|---|---|
field | topic or organization |
take | Number of terms to return (default 10) |
Request Pattern
{
"field": "organization",
"take": 10,
"topicQuery": "11111111-1111-1111-1111-111111111111",
"start": "2023-01-01T00:00:00Z",
"end": "2024-12-31T23:59:59Z"
}Response Notes
Each bucket has id (topic or organization UUID), count (matching documents), and name.
Use the all-types route when you want rankings across datasets; use a type-specific route to isolate patents, news, or another corpus.