Apinoa Docs

Answer

Ask Qwen a question and get its answer, with its sources.

View raw .mdx
POST /v1/qwen/answer

Send the inputs as a JSON body. Qwen thinks and often searches before it answers: allow up to 240 seconds.

Request

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

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": "qwen",
    "outcome": "answered",
    "prompt": "What are the best running shoes for beginners?",
    "askedAt": "2026-11-15T20:20:35.944Z",
    "country": "US",
    "blocks": [
      {
        "type": "paragraph",
        "markdown": "When starting your running journey, the \"best\" shoe is one that feels comfortable, protects your joints, and matches your natural foot strik…"
      },
      {
        "type": "heading",
        "level": 3,
        "markdown": "🏆 Top Running Shoes for Beginners"
      },
      {
        "type": "paragraph",
        "markdown": "**1. Best Overall Daily Trainer: Brooks Ghost 17 / 18**\nThe Brooks Ghost is consistently the number one recommendation for new runners becau…"
      }
    ],
    "text": "When starting your running journey, the \"best\" shoe is one that feels comfortable, protects your joints, and matches your natural foot strik…",
    "markdown": "When starting your running journey, the \"best\" shoe is one that feels comfortable, protects your joints, and matches your natural foot strik…",
    "citations": [
      {
        "start": 369,
        "end": 506,
        "sources": [
          1
        ]
      },
      {
        "start": 509,
        "end": 633,
        "sources": [
          5
        ]
      },
      {
        "start": 763,
        "end": 923,
        "sources": [
          5
        ]
      }
    ],
    "sources": [
      {
        "url": "https://theruntesters.com/the-best-running-shoes-for-beginners/",
        "title": "The Best Beginner Running Shoes 2026",
        "site": "theruntesters.com",
        "snippet": "Who Are The Run Testers? · The Best Running Shoes For Beginners 2026 · Asics Novablast 6 · Nike Vomero Plus · Kiprun Kipride Max · Salomon A…",
        "cited": false
      },
      {
        "url": "https://www.runnersworld.com/gear/a19663621/best-running-shoes/",
        "title": "The 15 Best Running Shoes of 2026",
        "site": "runnersworld.com",
        "snippet": "The 7 Best Running Shoes for Beginners in 2026. Advertisement …… ©2026 Hearst Magazines, Inc. All Rights Reserved. Privacy NoticeCA",
        "publishedAt": "2026-10-22T00:00:00.000Z",
        "cited": true
      },
      {
        "url": "https://runrepeat.com/guides/best-for-beginners-running-shoes",
        "title": "7 Best Running Shoes For Beginners in 2026",
        "site": "runrepeat.com",
        "snippet": "Best running shoes for beginners overall. PUMA Velocity Nitro 5. 89 ; Best daily training running shoes for beginners. Nike Winflo 12. 85 ; …",
        "publishedAt": "2026-10-13T00:00:00.000Z",
        "cited": true
      }
    ],
    "mentions": [],
    "cards": [],
    "suggestions": [],
    "ext": {
      "thinking": [
        {
          "title": "Deconstructing the inquiry to determine the optimal footwear selection for novice runners.",
          "thought": "I aim to curate a comprehensive and current list of top-rated running shoes tailored for beginners.\nThis process involves analyzing performa…"
        },
        {
          "title": "Deconstructing the inquiry to determine the optimal footwear selection for novice runners.\nEvaluate the necessity of external information to…",
          "thought": "I aim to curate a comprehensive and current list of top-rated running shoes tailored for beginners.\nThis process involves analyzing performa…"
        },
        {
          "title": "Deconstructing the inquiry to determine the optimal footwear selection for novice runners.\nEvaluate the necessity of external information to…",
          "thought": "I aim to curate a comprehensive and current list of top-rated running shoes tailored for beginners.\nThis process involves analyzing performa…"
        }
      ],
      "searches": [
        "\"best running shoes for beginners\" 2025 2026",
        "\"best beginner running shoes\" reviews Runner's World OR Wirecutter"
      ],
      "reads": [
        {
          "goal": "Get specific shoe models, their features, and why they are good for beginners",
          "urls": [
            "https://runrepeat.com/guides/best-for-beginners-running-shoes",
            "https://www.runnersworld.com/gear/a19663621/best-running-shoes/",
            "https://run.outsideonline.com/gear/road-shoes/best-running-shoes-for-beginners/"
          ]
        }
      ],
      "usage": {
        "inputTokens": 7059,
        "outputTokens": 2306,
        "reasoningTokens": 1437
      }
    }
  }
}

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

  • Qwen 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.
  • Qwen decides by itself whether to search the web. When it does, citations marks the text each source supports and sources lists every page it found, with cited set on the ones the answer uses. ext carries Qwen's thinking steps, its searches, the pages it read and its token usage.
  • Qwen is asked from US, SG, JP, KR, GB, DE, HK, TW, AU or CN. There is no photos input.
  • An answer usually takes 30 to 140 seconds. A rare answer that stops early comes back with outcome: "partial" and the text Qwen gave.

On this page