Search Findings
curl --request POST \
--url https://app.octavehq.com/api/v2/finding/search \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"query": "objections from prospects",
"customExtractorOIds": [
"<string>"
],
"startDate": "2026-08-01T00:00:00Z",
"endDate": "2023-11-07T05:31:56Z",
"eventFilters": {
"eventTypes": [],
"eventCategories": [],
"companyDomains": [
"<string>"
],
"contactEmails": [
"<string>"
],
"outcomeFilters": [],
"minDealAmount": 123,
"maxDealAmount": 123,
"sentiments": [],
"callPurposes": [],
"personas": [
"<string>"
],
"playbooks": [
"<string>"
],
"competitors": [
"<string>"
],
"segments": [
"<string>"
],
"useCases": [
"<string>"
],
"references": [
"<string>"
],
"proofPoints": [
"<string>"
]
},
"speakerSide": "external",
"attributedPersonaOIds": [
"<string>"
],
"insightOId": "rcfg_XVPcS3dLZFqzfQIfSeCpk",
"limit": 100,
"offset": 0
}
'import requests
url = "https://app.octavehq.com/api/v2/finding/search"
payload = {
"query": "objections from prospects",
"customExtractorOIds": ["<string>"],
"startDate": "2026-08-01T00:00:00Z",
"endDate": "2023-11-07T05:31:56Z",
"eventFilters": {
"eventTypes": [],
"eventCategories": [],
"companyDomains": ["<string>"],
"contactEmails": ["<string>"],
"outcomeFilters": [],
"minDealAmount": 123,
"maxDealAmount": 123,
"sentiments": [],
"callPurposes": [],
"personas": ["<string>"],
"playbooks": ["<string>"],
"competitors": ["<string>"],
"segments": ["<string>"],
"useCases": ["<string>"],
"references": ["<string>"],
"proofPoints": ["<string>"]
},
"speakerSide": "external",
"attributedPersonaOIds": ["<string>"],
"insightOId": "rcfg_XVPcS3dLZFqzfQIfSeCpk",
"limit": 100,
"offset": 0
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: 'objections from prospects',
customExtractorOIds: ['<string>'],
startDate: '2026-08-01T00:00:00Z',
endDate: '2023-11-07T05:31:56Z',
eventFilters: {
eventTypes: [],
eventCategories: [],
companyDomains: ['<string>'],
contactEmails: ['<string>'],
outcomeFilters: [],
minDealAmount: 123,
maxDealAmount: 123,
sentiments: [],
callPurposes: [],
personas: ['<string>'],
playbooks: ['<string>'],
competitors: ['<string>'],
segments: ['<string>'],
useCases: ['<string>'],
references: ['<string>'],
proofPoints: ['<string>']
},
speakerSide: 'external',
attributedPersonaOIds: ['<string>'],
insightOId: 'rcfg_XVPcS3dLZFqzfQIfSeCpk',
limit: 100,
offset: 0
})
};
fetch('https://app.octavehq.com/api/v2/finding/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.octavehq.com/api/v2/finding/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => 'objections from prospects',
'customExtractorOIds' => [
'<string>'
],
'startDate' => '2026-08-01T00:00:00Z',
'endDate' => '2023-11-07T05:31:56Z',
'eventFilters' => [
'eventTypes' => [
],
'eventCategories' => [
],
'companyDomains' => [
'<string>'
],
'contactEmails' => [
'<string>'
],
'outcomeFilters' => [
],
'minDealAmount' => 123,
'maxDealAmount' => 123,
'sentiments' => [
],
'callPurposes' => [
],
'personas' => [
'<string>'
],
'playbooks' => [
'<string>'
],
'competitors' => [
'<string>'
],
'segments' => [
'<string>'
],
'useCases' => [
'<string>'
],
'references' => [
'<string>'
],
'proofPoints' => [
'<string>'
]
],
'speakerSide' => 'external',
'attributedPersonaOIds' => [
'<string>'
],
'insightOId' => 'rcfg_XVPcS3dLZFqzfQIfSeCpk',
'limit' => 100,
'offset' => 0
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.octavehq.com/api/v2/finding/search"
payload := strings.NewReader("{\n \"query\": \"objections from prospects\",\n \"customExtractorOIds\": [\n \"<string>\"\n ],\n \"startDate\": \"2026-08-01T00:00:00Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"eventFilters\": {\n \"eventTypes\": [],\n \"eventCategories\": [],\n \"companyDomains\": [\n \"<string>\"\n ],\n \"contactEmails\": [\n \"<string>\"\n ],\n \"outcomeFilters\": [],\n \"minDealAmount\": 123,\n \"maxDealAmount\": 123,\n \"sentiments\": [],\n \"callPurposes\": [],\n \"personas\": [\n \"<string>\"\n ],\n \"playbooks\": [\n \"<string>\"\n ],\n \"competitors\": [\n \"<string>\"\n ],\n \"segments\": [\n \"<string>\"\n ],\n \"useCases\": [\n \"<string>\"\n ],\n \"references\": [\n \"<string>\"\n ],\n \"proofPoints\": [\n \"<string>\"\n ]\n },\n \"speakerSide\": \"external\",\n \"attributedPersonaOIds\": [\n \"<string>\"\n ],\n \"insightOId\": \"rcfg_XVPcS3dLZFqzfQIfSeCpk\",\n \"limit\": 100,\n \"offset\": 0\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.octavehq.com/api/v2/finding/search")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"objections from prospects\",\n \"customExtractorOIds\": [\n \"<string>\"\n ],\n \"startDate\": \"2026-08-01T00:00:00Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"eventFilters\": {\n \"eventTypes\": [],\n \"eventCategories\": [],\n \"companyDomains\": [\n \"<string>\"\n ],\n \"contactEmails\": [\n \"<string>\"\n ],\n \"outcomeFilters\": [],\n \"minDealAmount\": 123,\n \"maxDealAmount\": 123,\n \"sentiments\": [],\n \"callPurposes\": [],\n \"personas\": [\n \"<string>\"\n ],\n \"playbooks\": [\n \"<string>\"\n ],\n \"competitors\": [\n \"<string>\"\n ],\n \"segments\": [\n \"<string>\"\n ],\n \"useCases\": [\n \"<string>\"\n ],\n \"references\": [\n \"<string>\"\n ],\n \"proofPoints\": [\n \"<string>\"\n ]\n },\n \"speakerSide\": \"external\",\n \"attributedPersonaOIds\": [\n \"<string>\"\n ],\n \"insightOId\": \"rcfg_XVPcS3dLZFqzfQIfSeCpk\",\n \"limit\": 100,\n \"offset\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.octavehq.com/api/v2/finding/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"objections from prospects\",\n \"customExtractorOIds\": [\n \"<string>\"\n ],\n \"startDate\": \"2026-08-01T00:00:00Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"eventFilters\": {\n \"eventTypes\": [],\n \"eventCategories\": [],\n \"companyDomains\": [\n \"<string>\"\n ],\n \"contactEmails\": [\n \"<string>\"\n ],\n \"outcomeFilters\": [],\n \"minDealAmount\": 123,\n \"maxDealAmount\": 123,\n \"sentiments\": [],\n \"callPurposes\": [],\n \"personas\": [\n \"<string>\"\n ],\n \"playbooks\": [\n \"<string>\"\n ],\n \"competitors\": [\n \"<string>\"\n ],\n \"segments\": [\n \"<string>\"\n ],\n \"useCases\": [\n \"<string>\"\n ],\n \"references\": [\n \"<string>\"\n ],\n \"proofPoints\": [\n \"<string>\"\n ]\n },\n \"speakerSide\": \"external\",\n \"attributedPersonaOIds\": [\n \"<string>\"\n ],\n \"insightOId\": \"rcfg_XVPcS3dLZFqzfQIfSeCpk\",\n \"limit\": 100,\n \"offset\": 0\n}"
response = http.request(request)
puts response.read_body{
"_metadata": {
"requestId": "requestId",
"timestamp": "2021-01-01T00:00:00.000Z",
"usage": 0,
"message": "message"
},
"findings": [
{
"oId": "<string>",
"snippetText": "<string>",
"extractionType": "EMAIL_INTERNAL_USE_CASE",
"structuredValue": {},
"eventOId": "<string>",
"eventType": "EMAIL_SENT",
"eventTimestamp": "2023-11-07T05:31:56Z",
"callPurpose": "DISCOVERY",
"company": {
"name": "<string>",
"domain": "<string>"
},
"evidence": {
"quote": "<string>",
"reasoning": "<string>",
"speakerLabel": "<string>"
},
"speaker": "internal",
"attributedParticipant": {
"participantOId": "<string>",
"contactOId": "<string>",
"name": "<string>",
"email": "<string>",
"confidence": "<string>",
"personaOId": "<string>",
"personaName": "<string>"
},
"customExtractor": {
"oId": "<string>",
"name": "<string>",
"promptVersion": 1,
"modelTier": "NOTE",
"model": "<string>"
},
"sentimentScore": 123,
"linkedEntities": {
"personas": [
"<string>"
],
"competitors": [
"<string>"
],
"playbooks": [
"<string>"
],
"segments": [
"<string>"
],
"useCases": [
"<string>"
],
"references": [
"<string>"
],
"proofPoints": [
"<string>"
],
"coreFeatures": [
"<string>"
],
"alternatives": [
"<string>"
],
"buyingTriggers": [
"<string>"
]
}
}
],
"total": 123,
"hasMore": true,
"dataWindow": {
"kind": "event_range",
"startDate": "<string>",
"endDate": "<string>",
"isDefault": true,
"periodType": "week"
}
}{
"_metadata": {
"requestId": "requestId",
"timestamp": "2021-01-01T00:00:00.000Z",
"usage": 0,
"message": "message"
},
"message": "<string>"
}Findings
Search Findings
Search extracted findings from sales conversations using natural language. Findings are insights extracted from calls, emails, and other events — objections, pain points, competitor mentions, value props, and more. Describe what you’re looking for (the query is translated to finding types), or pass customExtractorOIds for an exact filter on workspace-defined extractors. Optionally narrow by event type, company, deal outcome, call purpose, linked entities, or the persona cohort that SPOKE the finding. Each row carries its event/company linkage, compact persisted evidence (quote, reasoning, speaker label), and the resolved attributed participant — use /event/get to pull a finding’s full transcript or email.
POST
/
api
/
v2
/
finding
/
search
Search Findings
curl --request POST \
--url https://app.octavehq.com/api/v2/finding/search \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"query": "objections from prospects",
"customExtractorOIds": [
"<string>"
],
"startDate": "2026-08-01T00:00:00Z",
"endDate": "2023-11-07T05:31:56Z",
"eventFilters": {
"eventTypes": [],
"eventCategories": [],
"companyDomains": [
"<string>"
],
"contactEmails": [
"<string>"
],
"outcomeFilters": [],
"minDealAmount": 123,
"maxDealAmount": 123,
"sentiments": [],
"callPurposes": [],
"personas": [
"<string>"
],
"playbooks": [
"<string>"
],
"competitors": [
"<string>"
],
"segments": [
"<string>"
],
"useCases": [
"<string>"
],
"references": [
"<string>"
],
"proofPoints": [
"<string>"
]
},
"speakerSide": "external",
"attributedPersonaOIds": [
"<string>"
],
"insightOId": "rcfg_XVPcS3dLZFqzfQIfSeCpk",
"limit": 100,
"offset": 0
}
'import requests
url = "https://app.octavehq.com/api/v2/finding/search"
payload = {
"query": "objections from prospects",
"customExtractorOIds": ["<string>"],
"startDate": "2026-08-01T00:00:00Z",
"endDate": "2023-11-07T05:31:56Z",
"eventFilters": {
"eventTypes": [],
"eventCategories": [],
"companyDomains": ["<string>"],
"contactEmails": ["<string>"],
"outcomeFilters": [],
"minDealAmount": 123,
"maxDealAmount": 123,
"sentiments": [],
"callPurposes": [],
"personas": ["<string>"],
"playbooks": ["<string>"],
"competitors": ["<string>"],
"segments": ["<string>"],
"useCases": ["<string>"],
"references": ["<string>"],
"proofPoints": ["<string>"]
},
"speakerSide": "external",
"attributedPersonaOIds": ["<string>"],
"insightOId": "rcfg_XVPcS3dLZFqzfQIfSeCpk",
"limit": 100,
"offset": 0
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: 'objections from prospects',
customExtractorOIds: ['<string>'],
startDate: '2026-08-01T00:00:00Z',
endDate: '2023-11-07T05:31:56Z',
eventFilters: {
eventTypes: [],
eventCategories: [],
companyDomains: ['<string>'],
contactEmails: ['<string>'],
outcomeFilters: [],
minDealAmount: 123,
maxDealAmount: 123,
sentiments: [],
callPurposes: [],
personas: ['<string>'],
playbooks: ['<string>'],
competitors: ['<string>'],
segments: ['<string>'],
useCases: ['<string>'],
references: ['<string>'],
proofPoints: ['<string>']
},
speakerSide: 'external',
attributedPersonaOIds: ['<string>'],
insightOId: 'rcfg_XVPcS3dLZFqzfQIfSeCpk',
limit: 100,
offset: 0
})
};
fetch('https://app.octavehq.com/api/v2/finding/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.octavehq.com/api/v2/finding/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => 'objections from prospects',
'customExtractorOIds' => [
'<string>'
],
'startDate' => '2026-08-01T00:00:00Z',
'endDate' => '2023-11-07T05:31:56Z',
'eventFilters' => [
'eventTypes' => [
],
'eventCategories' => [
],
'companyDomains' => [
'<string>'
],
'contactEmails' => [
'<string>'
],
'outcomeFilters' => [
],
'minDealAmount' => 123,
'maxDealAmount' => 123,
'sentiments' => [
],
'callPurposes' => [
],
'personas' => [
'<string>'
],
'playbooks' => [
'<string>'
],
'competitors' => [
'<string>'
],
'segments' => [
'<string>'
],
'useCases' => [
'<string>'
],
'references' => [
'<string>'
],
'proofPoints' => [
'<string>'
]
],
'speakerSide' => 'external',
'attributedPersonaOIds' => [
'<string>'
],
'insightOId' => 'rcfg_XVPcS3dLZFqzfQIfSeCpk',
'limit' => 100,
'offset' => 0
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.octavehq.com/api/v2/finding/search"
payload := strings.NewReader("{\n \"query\": \"objections from prospects\",\n \"customExtractorOIds\": [\n \"<string>\"\n ],\n \"startDate\": \"2026-08-01T00:00:00Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"eventFilters\": {\n \"eventTypes\": [],\n \"eventCategories\": [],\n \"companyDomains\": [\n \"<string>\"\n ],\n \"contactEmails\": [\n \"<string>\"\n ],\n \"outcomeFilters\": [],\n \"minDealAmount\": 123,\n \"maxDealAmount\": 123,\n \"sentiments\": [],\n \"callPurposes\": [],\n \"personas\": [\n \"<string>\"\n ],\n \"playbooks\": [\n \"<string>\"\n ],\n \"competitors\": [\n \"<string>\"\n ],\n \"segments\": [\n \"<string>\"\n ],\n \"useCases\": [\n \"<string>\"\n ],\n \"references\": [\n \"<string>\"\n ],\n \"proofPoints\": [\n \"<string>\"\n ]\n },\n \"speakerSide\": \"external\",\n \"attributedPersonaOIds\": [\n \"<string>\"\n ],\n \"insightOId\": \"rcfg_XVPcS3dLZFqzfQIfSeCpk\",\n \"limit\": 100,\n \"offset\": 0\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.octavehq.com/api/v2/finding/search")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"objections from prospects\",\n \"customExtractorOIds\": [\n \"<string>\"\n ],\n \"startDate\": \"2026-08-01T00:00:00Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"eventFilters\": {\n \"eventTypes\": [],\n \"eventCategories\": [],\n \"companyDomains\": [\n \"<string>\"\n ],\n \"contactEmails\": [\n \"<string>\"\n ],\n \"outcomeFilters\": [],\n \"minDealAmount\": 123,\n \"maxDealAmount\": 123,\n \"sentiments\": [],\n \"callPurposes\": [],\n \"personas\": [\n \"<string>\"\n ],\n \"playbooks\": [\n \"<string>\"\n ],\n \"competitors\": [\n \"<string>\"\n ],\n \"segments\": [\n \"<string>\"\n ],\n \"useCases\": [\n \"<string>\"\n ],\n \"references\": [\n \"<string>\"\n ],\n \"proofPoints\": [\n \"<string>\"\n ]\n },\n \"speakerSide\": \"external\",\n \"attributedPersonaOIds\": [\n \"<string>\"\n ],\n \"insightOId\": \"rcfg_XVPcS3dLZFqzfQIfSeCpk\",\n \"limit\": 100,\n \"offset\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.octavehq.com/api/v2/finding/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"objections from prospects\",\n \"customExtractorOIds\": [\n \"<string>\"\n ],\n \"startDate\": \"2026-08-01T00:00:00Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"eventFilters\": {\n \"eventTypes\": [],\n \"eventCategories\": [],\n \"companyDomains\": [\n \"<string>\"\n ],\n \"contactEmails\": [\n \"<string>\"\n ],\n \"outcomeFilters\": [],\n \"minDealAmount\": 123,\n \"maxDealAmount\": 123,\n \"sentiments\": [],\n \"callPurposes\": [],\n \"personas\": [\n \"<string>\"\n ],\n \"playbooks\": [\n \"<string>\"\n ],\n \"competitors\": [\n \"<string>\"\n ],\n \"segments\": [\n \"<string>\"\n ],\n \"useCases\": [\n \"<string>\"\n ],\n \"references\": [\n \"<string>\"\n ],\n \"proofPoints\": [\n \"<string>\"\n ]\n },\n \"speakerSide\": \"external\",\n \"attributedPersonaOIds\": [\n \"<string>\"\n ],\n \"insightOId\": \"rcfg_XVPcS3dLZFqzfQIfSeCpk\",\n \"limit\": 100,\n \"offset\": 0\n}"
response = http.request(request)
puts response.read_body{
"_metadata": {
"requestId": "requestId",
"timestamp": "2021-01-01T00:00:00.000Z",
"usage": 0,
"message": "message"
},
"findings": [
{
"oId": "<string>",
"snippetText": "<string>",
"extractionType": "EMAIL_INTERNAL_USE_CASE",
"structuredValue": {},
"eventOId": "<string>",
"eventType": "EMAIL_SENT",
"eventTimestamp": "2023-11-07T05:31:56Z",
"callPurpose": "DISCOVERY",
"company": {
"name": "<string>",
"domain": "<string>"
},
"evidence": {
"quote": "<string>",
"reasoning": "<string>",
"speakerLabel": "<string>"
},
"speaker": "internal",
"attributedParticipant": {
"participantOId": "<string>",
"contactOId": "<string>",
"name": "<string>",
"email": "<string>",
"confidence": "<string>",
"personaOId": "<string>",
"personaName": "<string>"
},
"customExtractor": {
"oId": "<string>",
"name": "<string>",
"promptVersion": 1,
"modelTier": "NOTE",
"model": "<string>"
},
"sentimentScore": 123,
"linkedEntities": {
"personas": [
"<string>"
],
"competitors": [
"<string>"
],
"playbooks": [
"<string>"
],
"segments": [
"<string>"
],
"useCases": [
"<string>"
],
"references": [
"<string>"
],
"proofPoints": [
"<string>"
],
"coreFeatures": [
"<string>"
],
"alternatives": [
"<string>"
],
"buyingTriggers": [
"<string>"
]
}
}
],
"total": 123,
"hasMore": true,
"dataWindow": {
"kind": "event_range",
"startDate": "<string>",
"endDate": "<string>",
"isDefault": true,
"periodType": "week"
}
}{
"_metadata": {
"requestId": "requestId",
"timestamp": "2021-01-01T00:00:00.000Z",
"usage": 0,
"message": "message"
},
"message": "<string>"
}Authorizations
Body
application/json
Findings search query and filters
Natural language description of what findings you want, e.g. 'objections from prospects', 'pricing concerns from lost deals'. Required unless customExtractorOIds is provided.
Example:
"objections from prospects"
Filter to findings produced by these workspace-defined custom extractors (oIds, as returned in each finding's customExtractor field). Exact filter — when provided, natural-language translation of the query is skipped and only these extractors' findings are returned.
Start date for event time range (ISO 8601 format). Defaults to 14 days ago if not provided.
Example:
"2026-08-01T00:00:00Z"
End date for event time range (optional; if omitted, no upper bound is applied)
Additional filters to narrow down which events to search
Show child attributes
Show child attributes
Who said it: 'external' is the buyer's side, 'internal' the workspace's own people. Narrows a query to that side, or, given alone, returns every finding type from that side. The side is read per finding (its recorded speaker, a custom extractor's perspective, the participant it was attributed to), so it combines with customExtractorOIds. Findings nothing attributes to a speaker, and document findings, match neither side.
Available options:
internal, external Example:
"external"
Filter to findings SPOKEN BY contacts classified into these personas (e.g. 'objections raised by CTOs'). Different from eventFilters.personas, which matches findings TAGGED with a persona. Attribution exists only for email and call findings with a resolved speaker.
Scope results to one Insight: only findings from the events that Insight covers, resolved the same way the Insight's own run resolves them. Given alone, it also selects the finding types and custom extractors the Insight reads. Combined with query or customExtractorOIds, it narrows the events only and your own source selection is kept.
Example:
"rcfg_XVPcS3dLZFqzfQIfSeCpk"
Maximum results to return (default: 100, max: 200)
Required range:
1 <= x <= 200Example:
100
Offset for pagination
Required range:
x >= 0Response
Matching findings with pagination info
Show child attributes
Show child attributes
Matching findings, each with its event/company/speaker linkage
Show child attributes
Show child attributes
The time span these numbers cover. Compare numbers from two tools only when their dataWindow kind and dates match.
Show child attributes
Show child attributes