---
title: "Wikipedia (Vector)"
method: POST
path: "/v1/vector/wikipedia/all"
tags: ["v1"]
---

# Wikipedia (Vector)

`POST /v1/vector/wikipedia/all`

Perform a natural language search over Wikipedia pages using semantic relevance. The result includes a list of page sections most closely matched to your query intent.

## Request body

- WikipediaSearchParams
  - `prompt` string, required — Natural language query to search the Wikipedia pages database
  - `filter` WikipediaSearchFilter — Complex filter structure for Wikipedia page searches that supports nested logical operations (AND, OR, NOT) and multiple filtering criteria.
    - `pageId` string[], nullable — Filter by specific Perigon page identifiers. Accepts either a single ID or an array of IDs. Returns only pages matching these IDs.
    - `sectionId` string[], nullable — Filter by specific section identifiers. Accepts either a single ID or an array of IDs. Returns only pages containing these sections.
    - `wikiPageId` integer[], nullable — Filter by specific Wikipedia page identifiers. Accepts either a single ID or an array of IDs. Returns only pages matching these IDs.
    - `wikiRevisionId` integer[], nullable — Filter by specific Perigon page revision identifiers. Accepts either a single ID or an array of IDs. Returns only pages matching these IDs.
    - `wikiCode` string[], nullable — Filter by specific Wikipedia project codes. Returns only pages matching these projects.
    - `wikiNamespace` integer[], nullable — Filter by specific Wikipedia namespaces. Returns only pages matching these namespaces.
    - `wikidataId` string[], nullable — Filter by specific Wikidata entity IDs. Returns only pages whose Wikidata entities match those ids.
    - `wikidataInstanceOfId` string[], nullable — Filter by specific Wikidata entity IDs. Returns only pages whose Wikidata entities are instances of provided ids.
    - `wikidataInstanceOfLabel` string[], nullable — Filter by specific Wikidata entity labels. Returns only pages whose Wikidata entities are instances of these labels.
    - `AND` WikipediaSearchFilter[], nullable — Adds additional AND filter objects. These objects must be of the same type as the original filter object and will be combined with the existing filter using the AND logical operator.
    - `OR` WikipediaSearchFilter[], nullable — Adds additional OR filter objects. These objects must be of the same type as the original filter object and will be combined with the existing filter using the OR logical operator.
    - `NOT` WikipediaSearchFilter[], nullable — A filter object for logical NOT operations
  - `wikiRevisionFrom` string, date-time, nullable — 'wikiRevisionFrom' filter, will search pages modified after the specified date, the date could be passed as ISO or 'yyyy-mm-dd'. Date time in ISO format, ie. 2024-01-01T00:00:00.
  - `wikiRevisionTo` string, date-time, nullable — 'wikiRevisionFrom' filter, will search pages modified before the specified date, the date could be passed as ISO or 'yyyy-mm-dd'. Date time in ISO format, ie. 2024-01-01T00:00:00.
  - `pageviewsFrom` integer, nullable — 'pageviewsFrom' filter, will search pages with at least the provided number of views per day.
  - `pageviewsTo` integer, nullable — 'pageviewsFrom' filter, will search pages with at most the provided number of views per day.
  - `size` integer, nullable — The number of items per page.
  - `page` integer, nullable — The page number to retrieve.

## Response `200`

200 - Success

- WikipediaVectorSearchResult — Wikipedia vector search result
  - `status` integer, required
  - `results` ScoredDataWikiData[], required
    - `score` number, float, nullable
    - `data` WikiData
      - `pageId` string, nullable
      - `sectionId` string, nullable
      - `wikiPageId` integer, nullable
      - `wikiRevisionId` integer, nullable
      - `wikiRevisionTs` string, nullable
      - `wikiCode` string, nullable
      - `wikiNamespace` integer, nullable
      - `wikiTitle` string, nullable
      - `wikidataId` string, nullable
      - `wikidataInstanceOf` WikidataLabelHolder[], nullable
        - `wikidataId` string, nullable
        - `label` string, nullable
      - `redirectTitles` string[], nullable
      - `pageviews` integer, nullable
      - `title` string, nullable
      - `styleLevel` integer, nullable
      - `content` string, nullable
    - `vectors` VectorData[], nullable
      - `data` number[], nullable
      - `version` integer, nullable

## Other responses

- `400` — 400 - Bad Request
- `401` — 401 - Invalid API Key
- `403` — 403 - Request Forbidden
- `429` — 429 - Too Many Requests
- `500` — 500 - Server Error

## Changes

- **2026-04-30** `182b74871f6a` — 1 info
  - added the optional property `results/items/vectors` to the response with the `200` status
- **2025-08-18** `a73a3b58ca66` — 1 breaking, 22 warning, 80 info
  - the `status` response's property type/format changed from `string`/`` to `integer`/`int32` for status `429`
  - removed the optional property `cause` from the response with the `400` status
  - removed the optional property `cause` from the response with the `401` status
  - removed the optional property `cause` from the response with the `403` status
  - …99 more
- **2025-08-04** `3eb8ae4622b8` — 4 breaking, 27 warning, 2 info
  - added `#/components/schemas/WikipediaSearchFilter` to the `filter` request property `allOf` list
  - the `filter` request property type/format changed from `object`/`` to ``/``
  - the response property `results/items/data` became nullable for the status `200`
  - the `results/items/data` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - …29 more
- **2025-07-23** `e807740e36fb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/goperigon/apis/perigon-api/changes/v1/vector/wikipedia/all/post.md)

---

[API](https://skmtc.dev/goperigon/apis/perigon-api.md) · [All operations](https://skmtc.dev/goperigon/apis/perigon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goperigon/perigon-api/revisions/2c55bf07003a/schema)