Apinoa Docs

Answer

Ask Dola (Doubao) a question and get its answer, with its sources.

View raw .mdx
POST /v1/dola/answer

Send the inputs as a JSON body. An answer takes seconds: allow up to 120 seconds.

Request

curl -X POST "https://gateway.apinoa.com/v1/dola/answer" \
  -H "x-api-key: $APINOA_API_KEY" \
  -H "content-type: application/json" \
  -d '{"prompt": "What are the best running shoes for beginners?", "country": "KR"}'

Parameters

ParameterTypeRequiredNotes
promptstringyesThe question, as a person would type it.
conversationstringAn earlier answer's conversation.id: ask a follow-up in the same conversation.
countrystringThe market the answer is asked from, as an ISO 3166 country code. Each engine's page lists its countries.
includeenum listpage: also return the answer as a self-contained HTML page, in page.

The same parameters, and every response type, are in the OpenAPI document.

Response

Returns Answer in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "success": true,
  "data": {
    "engine": "dola",
    "outcome": "answered",
    "prompt": "What are the best running shoes for beginners?",
    "askedAt": "2026-11-11T01:31:49.701Z",
    "country": "KR",
    "language": "en",
    "blocks": [
      {
        "type": "heading",
        "level": 1,
        "markdown": "🏃 Best Running Shoes for Beginners (2026)"
      },
      {
        "type": "paragraph",
        "markdown": "Great question! The ideal beginner shoe prioritizes **comfort, cushioning, stability, and durability** — not speed or fancy tech. Here are m…"
      },
      {
        "type": "rule"
      }
    ],
    "text": "🏃 Best Running Shoes for Beginners (2026)\n\nGreat question! The ideal beginner shoe prioritizes comfort, cushioning, stability, and durabilit…",
    "markdown": "# 🏃 Best Running Shoes for Beginners (2026)\n\nGreat question! The ideal beginner shoe prioritizes **comfort, cushioning, stability, and durab…",
    "citations": [],
    "sources": [
      {
        "url": "https://www.rtings.com/running-shoes/reviews/best/running",
        "title": "The 7 Best Running Shoes of 2026 - RTINGS.com",
        "site": "rtings.com",
        "cited": false,
        "ext": {
          "docId": "f538ac5ebedb0ebb-bd4b6a2a4c56e838",
          "searchId": "2026111101315317201800102650044588",
          "index": 1
        }
      },
      {
        "url": "https://www.runrepeat.com/uk/guides/best-for-beginners-running-shoes",
        "title": "7 Best Running Shoes For Beginners in 2026 | RunRepeat",
        "site": "runrepeat.com",
        "cited": false,
        "ext": {
          "docId": "abc0cc96bb831a0d-692220fe4d575423",
          "searchId": "2026111101315317201800102650044588",
          "index": 2,
          "rank": 1
        }
      },
      {
        "url": "https://www.sportsgearlab.com/best-running-shoes-for-beginners/",
        "title": "Best Running Shoes for Beginners 2026: Comfort Guide",
        "site": "sportsgearlab.com",
        "cited": false,
        "ext": {
          "docId": "e5b80fd9e68a24c8-5c1b007e028ceffb",
          "searchId": "2026111101315317201800102650044588",
          "index": 3,
          "rank": 2
        }
      }
    ],
    "mentions": [],
    "cards": [],
    "suggestions": [],
    "ext": {
      "steps": [
        "Searching the web",
        "Found 2 sources",
        "Found 6 sources"
      ],
      "searches": [
        "best running shoes for beginners 2026",
        "beginner running shoes guide cushion support durability"
      ],
      "searchSummary": "Searched for 2 keywords · 12 sources",
      "finishReason": "succeed:completion",
      "hasSuggestions": true
    }
  }
}

Errors

StatusCodeMeaning
400INVALID_PARAMSA parameter is missing, unknown or out of range, or the engine does not take it. The message names it.
401UNAUTHORIZEDThe x-api-key header is missing, or the key is revoked or unknown.
402INSUFFICIENT_BALANCEThe balance does not cover this call. Top up in the dashboard.
429MARKETPLACE_SATURATEDToo many concurrent calls. Retry after the Retry-After seconds.
502UPSTREAM_ERRORThe engine answered with something unusable. Retry with backoff.
502UPSTREAM_TIMEOUTThe engine did not answer in time. Retry.
503SERVICE_UNAVAILABLEA temporary failure. Retry with backoff.

Every code is listed in Errors. Failed calls are not billed.

Pricing

Price $0.0012 per call. List price; the rate steps down above 1,000 calls a day.

Notes

  • Dola answers in the language of the prompt. language is not taken.
  • Ask a follow-up with the conversation of an earlier answer; a conversation stays open for about 30 minutes.
  • Dola names its sources but does not say which sentence each one supports, so citations is empty and every source has cited: false. A source carries url, title and site; Dola gives no snippet.
  • Dola is asked from KR, JP, DE, GB, AU, FR, IT, SG, TW, HK or CN. Dola itself is not offered in mainland China, so CN is answered by Doubao (豆包), ByteDance's own service there, in the same response shape. US and CA are not available: the call fails with COUNTRY_UNAVAILABLE. There is no photos input.
  • An answer usually takes 10 to 35 seconds.

On this page