# Instant Answer API
> Get instant knowledge answers — definitions, abstracts, entity facts and related topics — plus search autocomplete suggestions, powered by DuckDuckGo. Ideal for knowledge panels, "did you mean" boxes and query suggestions.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/answer-api/..."
```

## Pricing
- **Free** (Free) — 1,500 calls/Mo, 2 req/s
- **Basic** ($11/Mo) — 60,000 calls/Mo, 8 req/s
- **Pro** ($27/Mo) — 275,000 calls/Mo, 20 req/s
- **Mega** ($69/Mo) — 1,200,000 calls/Mo, 50 req/s

## Endpoints

### Search

#### `GET /v1/answer` — Instant answer for a query

**Parameters:**
- `q` (query, required, string) — Query Example: `python programming`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/answer-api/v1/answer?q=python+programming"
```

**Response:**
```json
{
    "data": {
        "type": "A",
        "image": "https://duckduckgo.com/i/4d83768732377cf3.png",
        "query": "python programming",
        "answer": null,
        "heading": "Python (programming language)",
        "abstract": "Python is a high-level, general-purpose programming language that emphasizes code readability, simplicity, and ease-of-writing with the use of significant indentation, \"plain English\" naming, an extensive standard library, and garbage collection. Python supports multiple programming paradigms but with an emphasis on object-oriented programming and dynamic typing. Guido van Rossum began working on Python in the late 1980s as a successor to the ABC programming language. Python 3.0, released in 2008, was a major revision and not completely backward-compatible with earlier versions. Beginning with Python 3.5, capabilities and keywords for typing were added to the language, allowing optional static typing. As of 2026, the Python Software Foundation supports Python 3.10, 3.11, 3.12, 3.13, and 3.14, following the project's annual release cycle and five-year support policy. Python 3.15 is currently in the alpha development phase, and the stable release is expected to launch in October 2026.",
        "definition": null,
        "answer_type": null,
        "abstract_url": "https://en.wikipedia.org/wiki/Python_(programming_language)",
        "definition_url": null,
        "related_topics": [
            {
                "url": "https://duckduckg
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/autocomplete` — Search autocomplete suggestions

**Parameters:**
- `q` (query, required, string) — Partial query Example: `pyth`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/answer-api/v1/autocomplete?q=pyth"
```

**Response:**
```json
{
    "data": {
        "count": 8,
        "query": "pyth",
        "suggestions": [
            "python",
            "python download",
            "python online",
            "python 3",
            "pythagoras",
            "python compiler",
            "python lernen",
            "pythagoras rechner"
        ]
    },
    "meta": {
        "timestamp": "2026-05-30T00:23:50.019Z",
        "request_id": "ac46f216-51cf-4d3d-ae1b-a5bc0a8e1137"
    },
    "status": "ok",
    "message": "Suggestions retrieved successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/answer-api
OpenAPI spec: https://www.oanor.com/api/answer-api/openapi.json