Skip to main content
Coming Soon. Ask is not available yet. This page describes how it is planned to work, so you can design for it. Details can change before release. To hear when it ships, email support@avina.io.
Search returns a list of companies or people. Ask is for when you want an answer to a question instead. Ask takes a question in plain language and returns a direct answer, with a numbered citation for every factual claim.

What it is for

Research an account

“What does Northwind Pay sell, and who are its main competitors?”

Prepare for a call

“What has this company announced in the last 90 days?”

Size a segment

“Which US states have the most privately held dental groups with more than ten locations?”

Give an agent sources

One tool that answers B2B questions with sources the agent can quote.

How it will work

1

Ask a question

Send one question in plain language to POST /ask. Add about to limit it to one company or one person, or leave it out for a question about a market.
2

Avina researches it

The question is answered in the background, the same way a search runs. You get an id back immediately and poll for the result.
3

Read the answer and its sources

The answer comes back as text with numbered markers such as [1]. Each marker points to a source in citations, with the passage that supports the claim.
Planned request
Planned response (shortened)
The full planned contract is in the Ask reference.

What you can rely on

  • Every claim is cited. Each factual statement in an answer points to a source you can open.
  • It says when it does not know. outcome is answered, partially_answered or insufficient_evidence. When the evidence is missing, the answer explains what could not be found instead of guessing.
  • Answers code can read. Send an output_schema and the answer also comes back as an object in that shape, for your code or an AI agent to use.
  • A spend limit. max_credits caps what one question can cost, in the same credits as search.

Until it ships

Search already answers some of these questions for lists of companies:
  • To answer “which companies do X?”, run a company search with X as a criterion. Every result cites its evidence.
  • To check one fact across many companies, add it to criteria and read matched_criteria on each result.

Evidence and verdicts

How search results cite their sources today.

Changelog

Release announcements.