# vaaya.ai OpenAlex Scholarly Works Search

> vaaya.ai OpenAlex Scholarly Works Search is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Search 250M+ scholarly works via OpenAlex, returning metadata, abstracts, citation counts, and open-access links with filtering and sorting support.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/openalex/works
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaaya-ai-openalex-scholarly-works-search-b881a9be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xnRO926koRY2gQxg-R47S

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vaaya-ai-openalex-scholarly-works-search-b881a9be -d '<json body>'
```

Example prompt: Search OpenAlex for open-access papers on transformer architectures published after 2023-01-01 with more than 100 citations, sorted by citation count, and give me the top 10 results with abstracts and OA links.

## When to prefer this

Choose this endpoint when you need to search the full OpenAlex corpus of 250M+ scholarly works with rich filtering (date ranges, open-access status, citation thresholds), citation counts, and abstract access. Prefer it over web search for academic literature discovery, citation analysis, or building research summaries. It has broader coverage than PubMed (not limited to biomedicine) and includes the citation-graph layer absent from some alternatives.

## Known failure modes

- Invalid filter syntax (e.g. malformed filter key or value) returns an error
- No results found for highly specific filter combinations
- Rate limiting or payment failure if USDC balance is insufficient
- Empty search and filter fields return an error or unfiltered results
- Misspelled field names in sort or filter silently ignored or cause API error

## How this service works

Search 250M+ scholarly works (OpenAlex — successor to Microsoft Academic Graph). Pass `search` and/or `filter` (comma-joined, e.g. from_publication_date:2024-01-01,is_oa:true,cited_by_count:>100), optional `sort`, `page`, `per_page`. Returns metadata + abstracts + citation counts + OA links. The citation-graph layer kadec0/papers lacks.

## Output

Returns a list of scholarly work records from OpenAlex, each including title, abstract, authors, publication date, journal/venue, citation count, DOI, and open-access URL where available. Results are paginated and can be sorted by citation count, publication date, or relevance.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "properties": {
      "page": {
       "type": "integer",
       "minimum": 1
      },
      "sort": {
       "type": "string"
      },
      "filter": {
       "type": "string"
      },
      "search": {
       "type": "string"
      },
      "per_page": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaaya-ai-openalex-scholarly-works-search-b881a9be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)