Correlation matrix
Co-occurrence of topics and organizations across proof-point documents.
A correlation matrix counts how often row entities and column entities appear together in matching proof points. Use it to see which organizations cluster around which topics, or how two topic groups overlap in the same documents.
Endpoints:
POST /proof-points/correlation-matrix— all document types — playgroundPOST /proof-points/news-articles/correlation-matrixPOST /proof-points/patents/correlation-matrixPOST /proof-points/research-articles/correlation-matrixPOST /proof-points/earnings-calls/correlation-matrixPOST /proof-points/pdfs/correlation-matrixPOST /proof-points/projects/correlation-matrix
Type-specific routes apply the same matrix request on one dataset. Shared proof-point filters (query, topicIds, start / end, and so on) still apply.
Axes
Each of rows and cols is:
| Field | Purpose |
|---|---|
kind | topic or organization |
groups | Non-empty list of UUID groups. Each inner list is one bucket (IDs in a group are OR-ed). |
Request Pattern
{
"start": "2023-01-01T00:00:00Z",
"end": "2024-12-31T23:59:59Z",
"rows": {
"kind": "topic",
"groups": [
["11111111-1111-1111-1111-111111111111"],
["22222222-2222-2222-2222-222222222222"]
]
},
"cols": {
"kind": "organization",
"groups": [
["aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"],
["bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"]
]
}
}Validation Notes
- Every group must contain at least one UUID.
- Use the all-types route when you want a single matrix across datasets; use a type-specific route to isolate patents, news, or another corpus.