Sources
Provenance records keyed by UUID
Find intelligence Sources
Use to discover or resolve provenance Sources before filtering Events by source_ids, or when an answer needs source metadata for citation. q performs case-insensitive metadata matching across source domain, name, and URL; it is not semantic search.
Carry a selected data[].id into Source detail or GET /events?source_ids={source_id}. Source results describe publishers and provenance; they do not contain Events.
query Parameters
qCase-insensitive Source metadata search.
domainsExact Source domain-name filter (CSV).
limitMaximum records per page. Default 20, max 100.
cursorOpaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.
response_typeResponse serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Find intelligence Sources › Responses
Source collection envelope
Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.
Inspect one Source
Returns provenance metadata for one Source. Use this route to enrich a citation or inspect publisher metadata, not to retrieve published Events.
To find Events from this Source, call GET /events?source_ids={source_id}. Optional description, favicon, and RSS feed fields can be absent when unavailable.
path Parameters
source_idSource UUID (RFC 4122).
query Parameters
response_typeResponse serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Inspect one Source › Responses
Source detail envelope