---
title: "Batch search for wiki chunks"
method: POST
path: "/v1/wiki/search/batch"
tags: ["wiki"]
---

# Batch search for wiki chunks

`POST /v1/wiki/search/batch`

## Request

- Base URL: `https://api.asknews.app`
- URL: `https://api.asknews.app/v1/wiki/search/batch`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/asknews/apis/asknews-api/docs/v1/wiki/search/batch/post.ts> (a function with typed inputs; its response is checked against the schema)

Search for wikipedia documents for multiple queries in a single batch.

## Query parameters

- `queries` string[], required: List of query strings to search for in parallel.
- `neighbor_chunks` integer, nullable: Number of neighbor chunks to attach and return.
- `n_documents` integer, nullable: Number of documents to return per query.
- `full_articles` boolean, nullable: If true, full articles will be returned.
- `hybrid_search` boolean, nullable: If true, hybrid search will be used.
- `string_guarantee` string[], nullable: List of strings that must be present in the results.
- `diversify` number, nullable: Diversity factor for MMR re-ranking.
- `include_main_section` boolean, nullable: If true, the main section of the article will be prepended to each chunk.
- `has_wikidata` boolean, nullable: Filter results by whether the article has Wikidata.

## Response `200`

List of Wikipedia search results

- WikiBatchSearchResponse
  - `results` WikiSearchResponse[], required
    - `documents` WikiResponseDictItem[], required
      - `content` string, required
      - `title` string, required
      - `url` string, required
      - `categories` string[], required
      - `timestamp` string, date-time, required
      - `cirrus_metadata` CirrusMetadata
        - `create_timestamp` string, date-time, nullable
        - `wikibase_item` string, nullable
        - `version` integer, nullable
        - `popularity_score` number, nullable
        - `text_bytes` integer, nullable
        - `heading` string[], nullable
        - `incoming_links` integer, nullable
        - `outgoing_links` integer, nullable
      - `point_id` string, nullable
      - `point_id_main_section` string, nullable
      - `point_id_full_page` string, nullable
      - `has_main_section` boolean, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `405`: Method Not Allowed
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-11-07** `6513c99e2917`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/asknews/apis/asknews-api/changes/v1/wiki/search/batch/post.md)

---

[API](https://skmtc.dev/asknews/apis/asknews-api.md) - [All operations](https://skmtc.dev/asknews/apis/asknews-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asknews/apis/asknews-api/revisions/6513c99e2917?raw)