curl --request POST \ --url https://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "question": "How many brands does this group manage?", "answer_count": "1", "answer_format": "a single number"}'
import requests
url = "https://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions"
payload = {
"question": "How many brands does this group manage?",
"answer_count": "1",
"answer_format": "a single number"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
question: 'How many brands does this group manage?',
answer_count: '1',
answer_format: 'a single number'
})
};
fetch('https://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions"
payload := strings.NewReader("{\n \"question\": \"How many brands does this group manage?\",\n \"answer_count\": \"1\",\n \"answer_format\": \"a single number\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<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://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"question\": \"How many brands does this group manage?\",\n \"answer_count\": \"1\",\n \"answer_format\": \"a single number\"\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"question\": \"How many brands does this group manage?\",\n \"answer_count\": \"1\",\n \"answer_format\": \"a single number\"\n}"
response = http.request(request)
puts response.read_body
{ "answers": [ { "answer": "Roughly 30 brands, grouped under four divisions.", "sources": [ "<string>" ] } ], "id": "b3c6f5e2-1234-4abc-9def-0123456789ab", "question": "How many brands does this group manage?", "status": "PROCESSING", "updated_at": "2023-11-07T05:31:56Z"}
{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}
Companies
Ask a research question about a company
Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via Get an asked research question.
Costs 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again.
Works on any company. The company does not need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line.
curl --request POST \ --url https://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "question": "How many brands does this group manage?", "answer_count": "1", "answer_format": "a single number"}'
import requests
url = "https://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions"
payload = {
"question": "How many brands does this group manage?",
"answer_count": "1",
"answer_format": "a single number"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
question: 'How many brands does this group manage?',
answer_count: '1',
answer_format: 'a single number'
})
};
fetch('https://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions"
payload := strings.NewReader("{\n \"question\": \"How many brands does this group manage?\",\n \"answer_count\": \"1\",\n \"answer_format\": \"a single number\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<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://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"question\": \"How many brands does this group manage?\",\n \"answer_count\": \"1\",\n \"answer_format\": \"a single number\"\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://api.tamtam.ai/api/v2/companies/{linkedin_id}/research-questions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"question\": \"How many brands does this group manage?\",\n \"answer_count\": \"1\",\n \"answer_format\": \"a single number\"\n}"
response = http.request(request)
puts response.read_body
{ "answers": [ { "answer": "Roughly 30 brands, grouped under four divisions.", "sources": [ "<string>" ] } ], "id": "b3c6f5e2-1234-4abc-9def-0123456789ab", "question": "How many brands does this group manage?", "status": "PROCESSING", "updated_at": "2023-11-07T05:31:56Z"}
{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TAMTAM","colors":{"primary":"#0c31c1","light":"#3554d4","dark":"#081f7a"},"logo":{"light":"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/logo/light.svg?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=5291cd6148923d32a8552bdb99ef3669","dark":"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/logo/dark.svg?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=32b84eb16f13c1a361f8318778532924"},"favicon":"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/favicon.png?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=f532f912a05f0bdb216d0903aae60d4a","navbar":{"links":[],"primary":{"type":"button","label":"Visit tamtam.ai","href":"https://www.tamtam.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/tamtam-ai"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tamtam","hasAudioNarration":false,"actualSubdomain":"tamtam","customDomains":["docs.api.tamtam.ai"],"gitSource":{"type":"gitlab","owner":"tamtamai","repo":"tamtam","projectId":76070796,"deployBranch":"production","contentDirectory":"backend/public-api/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae36362864324a0b7688ac3","collectionId":"60ec3be8-4567-4986-a371-38355385382b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae36362864324a0b7688ac3"},"entitlements":{},"buildId":"6ae498f016d886c98de48553","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API reference","count":88},{"language":"default","tag":"Signals","count":11},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Companies","count":7},{"language":"default","tag":"People Search","count":7},{"language":"default","tag":"LinkedIn Content Signals","count":6},{"language":"default","tag":"Smart Verticals","count":6},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Concepts","count":5},{"language":"default","tag":"Contact Searches","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/companies/ask-a-research-question-about-a-company","slug":"/api-reference/companies/ask-a-research-question-about-a-company","pageMetadata":{"title":"Ask a research question about a company","description":"Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via [Get an asked research question](/api-reference/companies/get-an-asked-research-question).\n\nCosts 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again.\n\nWorks on any company. The company does **not** need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line.\n\nDistinct from [Get research answers for a company](/api-reference/companies/get-research-answers-for-a-company), which returns those standing questions rather than one you asked here.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/{linkedin_id}/research-questions","href":"/api-reference/companies/ask-a-research-question-about-a-company","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via \", _jsx(_components.a, {\n href: \"/api-reference/companies/get-an-asked-research-question\",\n children: \"Get an asked research question\"\n }), \".\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Costs 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Works on any company. The company does \", _jsx(_components.strong, {\n children: \"not\"\n }), \" need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Distinct from \", _jsx(_components.a, {\n href: \"/api-reference/companies/get-research-answers-for-a-company\",\n children: \"Get research answers for a company\"\n }), \", which returns those standing questions rather than one you asked here.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Ask a research question about a company","description":"Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via [Get an asked research question](/api-reference/companies/get-an-asked-research-question).\n\nCosts 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again.\n\nWorks on any company. The company does **not** need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line.\n\nDistinct from [Get research answers for a company](/api-reference/companies/get-research-answers-for-a-company), which returns those standing questions rather than one you asked here.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/{linkedin_id}/research-questions","href":"/api-reference/companies/ask-a-research-question-about-a-company","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via [Get an asked research question](/api-reference/companies/get-an-asked-research-question).\n\nCosts 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again.\n\nWorks on any company. The company does **not** need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line.\n\nDistinct from [Get research answers for a company](/api-reference/companies/get-research-answers-for-a-company), which returns those standing questions rather than one you asked here.","operationId":"ask-company-research-question","parameters":["6aa8a417-2df0-4846-a5a2-1967149bc0c6"],"requestBody":"850448b5-d918-4982-b457-7fa5fe8bc1e8","responses":{"202":"226e7824-296a-473a-b1d4-41b6fd925af6","default":"4bc4cfec-2c6b-4bbe-bfe0-63d80b12acd9"},"security":["d36fb078-9a0a-4cb9-80e5-faaff410321b","9256ca14-4abf-4061-8f7a-4fa282264a0b"],"summary":"Ask a research question about a company","tags":["Companies"],"method":"post","type":"path","servers":["83ce9b4e-1db5-4c96-8b86-10e3c4245028"],"path":"/v2/companies/{linkedin_id}/research-questions","baseUrlOptions":["https://api.tamtam.ai/api"],"title":"Ask a research question about a company","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6aa8a417-2df0-4846-a5a2-1967149bc0c6":{"description":"LinkedIn numeric company ID.","in":"path","name":"linkedin_id","required":true,"schema":{"description":"LinkedIn numeric company ID.","examples":["104924588"],"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"question":{"description":"The question to answer about this company, in plain language.","examples":["How many brands does this group manage?"],"maxLength":2000,"minLength":3,"type":"string","isRequired":true,"uniqueKey":"question","typeLabel":"string"},"answer_count":{"description":"How many answers to produce, as an instruction to the model rather than a hard count. Defaults to one.","examples":["1"],"type":"string","uniqueKey":"answer_count","typeLabel":"string"},"answer_format":{"description":"How the answer should read — 'a single number', 'a short paragraph', 'a bullet list'. Defaults to a detailed answer.","examples":["a single number"],"type":"string","uniqueKey":"answer_format","typeLabel":"string"}},"required":["question"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"question":"How many brands does this group manage?","answer_count":"1","answer_format":"a single number"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"226e7824-296a-473a-b1d4-41b6fd925af6":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"answers":{"oneOf":[{"description":"Answers, present once the status is COMPLETED.","items":{"additionalProperties":false,"properties":{"answer":{"description":"The answer text.","examples":["Roughly 30 brands, grouped under four divisions."],"type":"string","isRequired":true,"uniqueKey":"answers.oneOf.0.items.[INDEX].answer","typeLabel":"string"},"sources":{"oneOf":[{"description":"URLs the answer was grounded in. Empty when the answer came from context we already held rather than from the web.","items":{"type":"string","uniqueKey":"answers.oneOf.0.items.[INDEX].sources.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"answers.oneOf.0.items.[INDEX].sources.oneOf.0","typeLabel":"string[]"},{"description":"URLs the answer was grounded in. Empty when the answer came from context we already held rather than from the web.","items":{"type":"string"},"type":"null","isRequired":true,"uniqueKey":"answers.oneOf.0.items.[INDEX].sources.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"answers.oneOf.0.items.[INDEX].sources","typeLabel":"string[] | null"}},"required":["answer","sources"],"type":"object","uniqueKey":"answers.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"answers.oneOf.0","typeLabel":"object[]"},{"description":"Answers, present once the status is COMPLETED.","items":{"additionalProperties":false,"properties":{"answer":{"description":"The answer text.","examples":["Roughly 30 brands, grouped under four divisions."],"type":"string"},"sources":{"oneOf":[{"description":"URLs the answer was grounded in. Empty when the answer came from context we already held rather than from the web.","items":{"type":"string"},"type":"array"},{"description":"URLs the answer was grounded in. Empty when the answer came from context we already held rather than from the web.","items":{"type":"string"},"type":"null"}]}},"required":["answer","sources"],"type":"object"},"type":"null","isRequired":true,"uniqueKey":"answers.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"answers","typeLabel":"object[] | null"},"id":{"description":"ID of this asked question. Poll it to collect the answer.","examples":["b3c6f5e2-1234-4abc-9def-0123456789ab"],"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"question":{"description":"The question as asked.","examples":["How many brands does this group manage?"],"type":"string","isRequired":true,"uniqueKey":"question","typeLabel":"string"},"status":{"description":"One of COMPLETED, PROCESSING, FAILED.","examples":["PROCESSING"],"type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"updated_at":{"description":"When this question last produced an answer.","format":"date-time","type":"string","uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"}},"required":["id","question","status","answers"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"answers":[{"answer":"Roughly 30 brands, grouped under four divisions.","sources":["\u003cstring>"]}],"id":"b3c6f5e2-1234-4abc-9def-0123456789ab","question":"How many brands does this group manage?","status":"PROCESSING","updated_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"description":"Accepted","exampleType":"generated"},"4bc4cfec-2c6b-4bbe-bfe0-63d80b12acd9":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Error","exampleType":"generated"}},"security":{"d36fb078-9a0a-4cb9-80e5-faaff410321b":{"apikeyAuth":{"description":"Account API key passed in the Authorization header","in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apikeyAuth"}},"9256ca14-4abf-4061-8f7a-4fa282264a0b":{"bearerAuth":{"description":"Bearer JWT obtained via the OAuth 2.1 authorization flow","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"83ce9b4e-1db5-4c96-8b86-10e3c4245028":{"url":"https://api.tamtam.ai/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Account API key passed in the Authorization header","in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apikeyAuth"},"schema":{"title":"Authorization","type":"string","description":"Account API key passed in the Authorization header","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apikeyAuth","name":"Authorization"}],"title":"apikeyAuth"},{"schemes":[{"scheme":{"description":"Bearer JWT obtained via the OAuth 2.1 authorization flow","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer JWT obtained via the OAuth 2.1 authorization flow","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"reference/openapi.yaml"},"subdomain":"tamtam","siteName":"TAMTAM","title":"Ask a research question about a company - TAMTAM","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T15:16:59.298Z","originalFileLocation":"api-reference/companies/ask-a-research-question-about-a-company.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via Get an asked research question. Costs 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again. Works on any company. The company does not need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line. Distinct from Get research answers for a company, which returns those standing questions rather than one you asked here.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TAMTAM\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ask a research question about a company - TAMTAM\">\u003cmeta data-mint-head property=\"og:description\" content=\"Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via Get an asked research question. Costs 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again. Works on any company. The company does not need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line. Distinct from Get research answers for a company, which returns those standing questions rather than one you asked here.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TAMTAM\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.api.tamtam.ai/api-reference/companies/ask-a-research-question-about-a-company\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tamtam.mintlify.app/_mintlify/api/og/v2?division=Companies\u0026amp;title=Ask+a+research+question+about+a+company\u0026amp;description=Ask+a+grounded%2C+free-form+research+question+about+one+company.+Returns+immediately+with+an+ID+to+poll+via+%5BGet+an+asked+research+question%5D%28%2Fapi-reference%2Fcompan\u0026amp;theme=0a3840a452825963dbf5c1f1\u0026amp;signature=91d016d643abfb36f8237d5717a789e0e39de6f753d9048507fb93d111783bb0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Ask a research question about a company - TAMTAM\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via Get an asked research question. Costs 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again. Works on any company. The company does not need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line. Distinct from Get research answers for a company, which returns those standing questions rather than one you asked here.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tamtam.mintlify.app/_mintlify/api/og/v2?division=Companies\u0026amp;title=Ask+a+research+question+about+a+company\u0026amp;description=Ask+a+grounded%2C+free-form+research+question+about+one+company.+Returns+immediately+with+an+ID+to+poll+via+%5BGet+an+asked+research+question%5D%28%2Fapi-reference%2Fcompan\u0026amp;theme=0a3840a452825963dbf5c1f1\u0026amp;signature=91d016d643abfb36f8237d5717a789e0e39de6f753d9048507fb93d111783bb0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TAMTAM\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0c31c1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.api.tamtam.ai/api-reference/companies/ask-a-research-question-about-a-company\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/companies/ask-a-research-question-about-a-company.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.api.tamtam.ai/#organization\",\"name\":\"TAMTAM\",\"url\":\"https://docs.api.tamtam.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/logo/light.svg?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=5291cd6148923d32a8552bdb99ef3669\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.api.tamtam.ai#website\",\"name\":\"TAMTAM\",\"url\":\"https://docs.api.tamtam.ai\",\"publisher\":{\"@id\":\"https://docs.api.tamtam.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.api.tamtam.ai/api-reference/companies/ask-a-research-question-about-a-company#webpage\",\"url\":\"https://docs.api.tamtam.ai/api-reference/companies/ask-a-research-question-about-a-company\",\"name\":\"Ask a research question about a company\",\"description\":\"Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via Get an asked research question. Costs 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again. Works on any company. The company does not need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line. Distinct from Get research answers for a company, which returns those standing questions rather than one you asked here.\",\"dateModified\":\"2026-10-29T15:16:59.298Z\",\"isPartOf\":{\"@id\":\"https://docs.api.tamtam.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.api.tamtam.ai/api-reference/companies/ask-a-research-question-about-a-company#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.api.tamtam.ai/api-reference/companies/ask-a-research-question-about-a-company#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Companies\",\"item\":\"https://docs.api.tamtam.ai/api-reference/companies/list-job-changes-for-companies\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ask a research question about a company\",\"item\":\"https://docs.api.tamtam.ai/api-reference/companies/ask-a-research-question-about-a-company\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.api.tamtam.ai/api-reference/companies/ask-a-research-question-about-a-company#apireference\",\"headline\":\"Ask a research question about a company\",\"name\":\"Ask a research question about a company\",\"description\":\"Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via Get an asked research question. Costs 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again. Works on any company. The company does not need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line. Distinct from Get research answers for a company, which returns those standing questions rather than one you asked here.\",\"url\":\"https://docs.api.tamtam.ai/api-reference/companies/ask-a-research-question-about-a-company\",\"mainEntityOfPage\":{\"@id\":\"https://docs.api.tamtam.ai/api-reference/companies/ask-a-research-question-about-a-company#webpage\"},\"dateModified\":\"2026-10-29T15:16:59.298Z\",\"publisher\":{\"@id\":\"https://docs.api.tamtam.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.api.tamtam.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TAMTAM\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"TAMTAM","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Contacts","pages":[{"title":"Get contacts by IDs (deprecated)","deprecated":true,"version":null,"openapi":"/reference/openapi.yaml post /v1/contacts","href":"/api-reference/contacts/get-contacts-by-ids-deprecated"},{"title":"Get contacts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts","href":"/api-reference/contacts/get-contacts"},{"title":"Get research answers for a contact","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts/{contactID}/research-questions","href":"/api-reference/contacts/get-research-answers-for-a-contact"},{"title":"Ask a research question about a contact","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contacts/{contactID}/research-questions","href":"/api-reference/contacts/ask-a-research-question-about-a-contact"}]},{"group":"Companies Lists","pages":[{"title":"List companies lists","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies-lists","href":"/api-reference/companies-lists/list-companies-lists"},{"title":"Get a companies list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies-lists/{listID}","href":"/api-reference/companies-lists/get-a-companies-list"},{"title":"Add companies to a list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies-lists/{listID}","href":"/api-reference/companies-lists/add-companies-to-a-list"}]},{"group":"Companies","pages":[{"title":"List job changes for companies","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/job-changes","href":"/api-reference/companies/list-job-changes-for-companies"},{"title":"Search for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/search","href":"/api-reference/companies/search-for-a-company"},{"title":"Get job postings for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/job-postings","href":"/api-reference/companies/get-job-postings-for-a-company"},{"title":"Get news for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/news","href":"/api-reference/companies/get-news-for-a-company"},{"title":"Get research answers for a company","description":"Return your account's AI research questions answered for this company — the API form of the AI columns in the app. Each entry carries the question, its run status, the answers once available, and the sources they were grounded in.\n\nFree. These are the standing questions your account has configured; adding a company to [Key Accounts](/api-reference/key-accounts/add-companies-to-key-accounts) is what runs them for it, and that unlock is billed separately. A company you have not unlocked simply returns an empty list.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/research-questions","href":"/api-reference/companies/get-research-answers-for-a-company"},{"title":"Ask a research question about a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/{linkedin_id}/research-questions","href":"/api-reference/companies/ask-a-research-question-about-a-company"},{"title":"Get an asked research question","description":"Poll a question asked via [Ask a research question about a company](/api-reference/companies/ask-a-research-question-about-a-company). Returns the answers and their sources once the status is COMPLETED.\n\nFree: the credit was charged when the question was asked.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/research-questions/{questionID}","href":"/api-reference/companies/get-an-asked-research-question"}]},{"group":"Contact Searches","pages":[{"title":"List contact searches","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contact-searches","href":"/api-reference/contact-searches/list-contact-searches"},{"title":"Start a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contact-searches","href":"/api-reference/contact-searches/start-a-contact-search"},{"title":"Preview a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contact-searches/preview-count","href":"/api-reference/contact-searches/preview-a-contact-search"},{"title":"Get a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contact-searches/{searchID}","href":"/api-reference/contact-searches/get-a-contact-search"},{"title":"Stop a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contact-searches/{searchID}/stop","href":"/api-reference/contact-searches/stop-a-contact-search"}]},{"group":"Contacts Lists","pages":[{"title":"List contacts lists","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists","href":"/api-reference/contacts-lists/list-contacts-lists"},{"title":"Get a contacts list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists/{contactsListID}","href":"/api-reference/contacts-lists/get-a-contacts-list"},{"title":"List the contacts in a contacts list or contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists/{contactsListID}/contacts","href":"/api-reference/contacts-lists/list-the-contacts-in-a-contacts-list-or-contact-search"}]},{"group":"Signals","pages":[{"title":"List signals on a contacts list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists/{listID}/signals","href":"/api-reference/signals/list-signals-on-a-contacts-list"},{"title":"List CRM deal stages","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/crm-deal-stages","href":"/api-reference/signals/list-crm-deal-stages"},{"title":"Create a deal stage lookalike signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/deal-stage-lookalike-signals","href":"/api-reference/signals/create-a-deal-stage-lookalike-signal"},{"title":"Create a job posting signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/job-posting-signals","href":"/api-reference/signals/create-a-job-posting-signal"},{"title":"Start a lead generation run","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/lead-generation-runs","href":"/api-reference/signals/start-a-lead-generation-run"},{"title":"Create a new hire signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/new-hire-signals","href":"/api-reference/signals/create-a-new-hire-signal"},{"title":"Create a news signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/news-content-signals","href":"/api-reference/signals/create-a-news-signal"},{"title":"Create a page follower signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/page-follower-signals","href":"/api-reference/signals/create-a-page-follower-signal"},{"title":"List page follower filter values","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/page-follower-signals/filter-values","href":"/api-reference/signals/list-page-follower-filter-values"},{"title":"Create an ex-customer move signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/past-company-move-signals","href":"/api-reference/signals/create-an-ex-customer-move-signal"},{"title":"List signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/signals","href":"/api-reference/signals/list-signals"}]},{"group":"Credits","pages":[{"title":"Get remaining credits","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/credits","href":"/api-reference/credits/get-remaining-credits"}]},{"group":"Engagement Watches","pages":[{"title":"List engagement signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/engagement-signals","href":"/api-reference/engagement-watches/list-engagement-signals"},{"title":"List engagement watches","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/engagement-watches","href":"/api-reference/engagement-watches/list-engagement-watches"},{"title":"Create an engagement watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/engagement-watches","href":"/api-reference/engagement-watches/create-an-engagement-watch"},{"title":"Delete an engagement watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/engagement-watches/{id}","href":"/api-reference/engagement-watches/delete-an-engagement-watch"},{"title":"Update an engagement watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/engagement-watches/{id}","href":"/api-reference/engagement-watches/update-an-engagement-watch"}]},{"group":"ICP Criteria","pages":[{"title":"List ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-criteria","href":"/api-reference/icp-criteria/list-icp-criteria"},{"title":"Create an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/icp-criteria","href":"/api-reference/icp-criteria/create-an-icp-criteria"},{"title":"Get an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-criteria/{icpCriteriaID}","href":"/api-reference/icp-criteria/get-an-icp-criteria"},{"title":"Update an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml put /v2/icp-criteria/{icpCriteriaID}","href":"/api-reference/icp-criteria/update-an-icp-criteria"},{"title":"Delete an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/icp-criteria/{icpCriteriaID}","href":"/api-reference/icp-criteria/delete-an-icp-criteria"}]},{"group":"ICP Signal Watches","pages":[{"title":"List ICP signal watches","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-signal-watches","href":"/api-reference/icp-signal-watches/list-icp-signal-watches"},{"title":"Get an ICP signal watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-signal-watches/{icpCriteriaID}","href":"/api-reference/icp-signal-watches/get-an-icp-signal-watch"},{"title":"Create or update an ICP signal watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml put /v2/icp-signal-watches/{icpCriteriaID}","href":"/api-reference/icp-signal-watches/create-or-update-an-icp-signal-watch"},{"title":"Delete an ICP signal watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/icp-signal-watches/{icpCriteriaID}","href":"/api-reference/icp-signal-watches/delete-an-icp-signal-watch"},{"title":"List ICP signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-signals","href":"/api-reference/icp-signal-watches/list-icp-signals"}]},{"group":"Industries","pages":[{"title":"Search industries","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/industries/search","href":"/api-reference/industries/search-industries"}]},{"group":"Key Accounts","pages":[{"title":"List Key Accounts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/key-accounts","href":"/api-reference/key-accounts/list-key-accounts"},{"title":"Add companies to Key Accounts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/key-accounts","href":"/api-reference/key-accounts/add-companies-to-key-accounts"}]},{"group":"Lead Score","pages":[{"title":"Score job titles at a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/lead-scores/at-company","href":"/api-reference/lead-score/score-job-titles-at-a-company"},{"title":"Score job titles with no company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/lead-scores/title-only","href":"/api-reference/lead-score/score-job-titles-with-no-company"}]},{"group":"LinkedIn Content Signals","pages":[{"title":"List content signal events","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/linkedin-content-signal-events","href":"/api-reference/linkedin-content-signals/list-content-signal-events"},{"title":"List LinkedIn content signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/linkedin-content-signals","href":"/api-reference/linkedin-content-signals/list-linkedin-content-signals"},{"title":"Create a LinkedIn content signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/linkedin-content-signals","href":"/api-reference/linkedin-content-signals/create-a-linkedin-content-signal"},{"title":"Delete a LinkedIn content signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/linkedin-content-signals/{id}","href":"/api-reference/linkedin-content-signals/delete-a-linkedin-content-signal"},{"title":"Update a LinkedIn content signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/linkedin-content-signals/{id}","href":"/api-reference/linkedin-content-signals/update-a-linkedin-content-signal"},{"title":"List judged posts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/linkedin-content-signals/{id}/posts","href":"/api-reference/linkedin-content-signals/list-judged-posts"}]},{"group":"Lookalikes","pages":[{"title":"Search for lookalike companies","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/multi-search-lookalikes","href":"/api-reference/lookalikes/search-for-lookalike-companies"}]},{"group":"People Enrichment","pages":[{"title":"Enrich people with email and phone data","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/enrich","href":"/api-reference/people-enrichment/enrich-people-with-email-and-phone-data"},{"title":"Get enrichment request status and results","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/people/enrich/{RequestID}","href":"/api-reference/people-enrichment/get-enrichment-request-status-and-results"}]},{"group":"People Extract","pages":[{"title":"Read people's experiences","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/experiences","href":"/api-reference/people-extract/read-peoples-experiences"},{"title":"Extract a person's profile","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/extract","href":"/api-reference/people-extract/extract-a-persons-profile"},{"title":"Resolve people to LinkedIn profiles","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/resolve","href":"/api-reference/people-extract/resolve-people-to-linkedin-profiles"}]},{"group":"People Search","pages":[{"title":"Search for people","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search","href":"/api-reference/people-search/search-for-people"},{"title":"Run a people search to the end in the background","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs","href":"/api-reference/people-search/run-a-people-search-to-the-end-in-the-background"},{"title":"Plan a large people search before running it","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs/plan","href":"/api-reference/people-search/plan-a-large-people-search-before-running-it"},{"title":"Get a people search job","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/people/search-jobs/{JobID}","href":"/api-reference/people-search/get-a-people-search-job"},{"title":"Read a people search job's results","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/people/search-jobs/{JobID}/results","href":"/api-reference/people-search/read-a-people-search-jobs-results"},{"title":"Run a planned people search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs/{JobID}/run","href":"/api-reference/people-search/run-a-planned-people-search"},{"title":"Stop a people search job","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs/{JobID}/stop","href":"/api-reference/people-search/stop-a-people-search-job"}]},{"group":"Personas","pages":[{"title":"List personas","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/personas","href":"/api-reference/personas/list-personas"},{"title":"Create a persona","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/personas","href":"/api-reference/personas/create-a-persona"},{"title":"Update a persona","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/personas/{id}","href":"/api-reference/personas/update-a-persona"}]},{"group":"Smart Verticals","pages":[{"title":"List smart verticals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/smart-verticals","href":"/api-reference/smart-verticals/list-smart-verticals"},{"title":"Create a smart vertical","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/smart-verticals","href":"/api-reference/smart-verticals/create-a-smart-vertical"},{"title":"Classify companies into smart verticals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/smart-verticals/classify","href":"/api-reference/smart-verticals/classify-companies-into-smart-verticals"},{"title":"Reclassify all classified companies","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/smart-verticals/reclassify","href":"/api-reference/smart-verticals/reclassify-all-classified-companies"},{"title":"Update a smart vertical","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml put /v2/smart-verticals/{smartVerticalID}","href":"/api-reference/smart-verticals/update-a-smart-vertical"},{"title":"Delete a smart vertical","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/smart-verticals/{smartVerticalID}","href":"/api-reference/smart-verticals/delete-a-smart-vertical"}]},{"group":"Webhooks","pages":[{"title":"List webhook deliveries","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/webhook-deliveries","href":"/api-reference/webhooks/list-webhook-deliveries"},{"title":"Replay a webhook delivery","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/webhook-deliveries/{deliveryID}/replay","href":"/api-reference/webhooks/replay-a-webhook-delivery"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/webhook-endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/webhook-endpoints","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/webhook-endpoints/{endpointID}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/webhook-endpoints/{endpointID}","href":"/api-reference/webhooks/update-a-webhook-endpoint"}]}]}]},"title":"Ask a research question about a company - TAMTAM","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}