Yandex (Alice)

Query Yandex's Alice AI assistant via Wire — Russian-market AI answers with sources

POSThttps://api.anakin.io/v1/wire/task

Alice (Алиса) is Yandex's AI assistant — the dominant AI answer surface for the Russian-speaking market. Send a prompt and get Alice's answer with the sources it cites. Run it with the yandex_alice action on POST /v1/wire/task.

Catalog: yandex · action_id: yandex_alice · Credits: 2 / call · Auth: none


Request Body

{
  "action_id": "yandex_alice",
  "params": { "prompt": "лучшие смартфоны 2026", "country": "ru" }
}
ParameterTypeDescription
action_id requiredstringSet to yandex_alice
params.prompt requiredstringYour question for Alice (Russian recommended for best grounding)
params.countrystringRegion to query from (2-letter code). Default ru
params.include_rawbooleanAlso include Alice's full raw response alongside the parsed result. Default false

Code Examples

curl -X POST https://api.anakin.io/v1/wire/task \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "action_id": "yandex_alice",
    "params": { "prompt": "лучшие смартфоны 2026", "country": "ru" }
  }'

Response

202 Accepted
{ "status": "processing", "job_id": "…", "poll_url": "/v1/wire/jobs/…" }

Poll GET /v1/wire/jobs/{id} until status: "completed":

200 OK
{
  "status": "completed",
  "credits_used": 2,
  "execution_ms": 15070,
  "data": {
    "status": "ok",
    "data": {
      "answer_text": "…", "answer_text_markdown": "…", "answer_text_raw": "…",
      "citations": [
        { "url": "https://…", "title": "…", "description": "…" }
      ],
      "sources": [{ "url": "https://…", "domain": "…", "title": "…" }],
      "citation_anchors": [], "search_sources": [], "references": [], "links_attached": [],
      "web_search_triggered": true, "model": "yandex-alice"
    },
    "meta": { "action_id": "yandex_alice", "catalog_slug": "yandex", "envelope_version": "v1" }
  }
}
FieldTypeDescription
data.data.answer_textstringAlice's answer (also answer_text_markdown, answer_text_raw)
data.data.answer_text_rawstringThe raw, unprocessed answer — keeps Alice's inline citation-chip labels and placeholder tokens that answer_text strips out
data.data.citationsarraySources Alice cites — { url, title, description }
data.data.recommendationsarrayRelated products or items the engine recommends alongside the answer
data.data.shoppingarrayShopping module for commercial-intent queries — products with titles, prices and links
data.data.sourcesarraySource pages — { url, domain, title }
data.data.citation_anchorsarrayPassage-level anchors when Alice provides them (empty when the answer carries no inline placement)
data.data.links_attachedarrayThe cited sources as a flat list in reading order: { url, text, position }
data.data.referencesarrayThe cited sources in { url, title, attribution, domain } shape
data.data.search_sourcesarraySources Alice considered during its web search (not necessarily cited)
data.data.web_search_triggeredbooleanWhether Alice ran a web search for this answer
data.data.web_search_querystringThe search query Alice ran
data.data.adsobjectThe sponsored result Alice showed — name, url, favicon_url, carousel_cards; fields are null when there was none
data.data.response_rawstringAlice's raw response stream, verbatim. Not a stable contract — its format can change without notice; use the structured fields instead

Alice answers in Russian and is strongest on Russian-language, Russia-geo prompts. Billed only on success.