Ask a research question about a contact
Ask a grounded research question about one person. Returns immediately; poll Get research answers for a contact to collect the answer.
The answer is grounded in the person’s profile, their company, and a web search, so use it for what differs between people at the same company rather than for facts about the company itself.
Costs 1 credit per contact. Asking the same question text again reuses the question you already have — the ID stays stable, so asking it about a hundred people gives you one question and a hundred answers, not a hundred questions.
Authorizations
Account API key passed in the Authorization header
Path Parameters
Tamtam contact ID.
"b3c6f5e2-1234-4abc-9def-0123456789ab"
Body
The question to answer about this contact, in plain language. Grounded in the person's profile, their company, and a web search.
3 - 2000"Which brands does this person look after?"
Short label for the question, as a CRM column name would be. Defaults to the question text.
"Brands managed"
Response
Accepted
ID of the question. Stable across contacts: the same question asked about ten people carries one ID.
"b3c6f5e2-1234-4abc-9def-0123456789ab"
The column name given to this question.
"Brands managed"
The question as configured.
"Which brands does this person look after?"
One of COMPLETED, PROCESSING, FAILED.
"COMPLETED"
The answer, present once the status is COMPLETED.
When this question last produced an answer for this contact.