---
title: "Search AI research works (OpenAlex proxy)"
method: GET
path: "/api/atlas/search"
tags: ["research"]
---

# Search AI research works (OpenAlex proxy)

`GET /api/atlas/search`

## Request

- Base URL: `https://aioq.org`
- URL: `https://aioq.org/api/atlas/search`
- Auth: none declared

Trimmed proxy over the OpenAlex works index, used by the AIO Atlas. Responses are cached for ten minutes. Data originates from OpenAlex (CC0); this endpoint adds no AIO claim over it.

## Query parameters

- `q` string, required
- `per_page` integer

## Response `200`

Matching works.

- object
  - `meta` object
  - `cached` boolean
  - `results` object[]
    - `openalex_id` string
    - `doi` string, nullable
    - `title` string, nullable
    - `publication_year` integer, nullable
    - `citations` integer, nullable
    - `primary_topic` string, nullable
    - `authors_preview` string[]

## Other responses

- `400`: Missing or too-short query.
- `502`: OpenAlex upstream failure.

---

[API](https://skmtc.dev/aioq/apis/aio-public-api.md) · [All operations](https://skmtc.dev/aioq/apis/aio-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aioq/apis/aio-public-api/revisions/377b76120162?raw)