# OpenAlex Institutions Search

> OpenAlex Institutions Search is a paid API for AI agents from x402-v2-mint-openalex-institutions.vercel.app, paid per call via x402, $0.020089/call, status unknown (last checked 2026-11-18).

Searches the OpenAlex academic institutions database by keyword, returning matching institution records for a given query.

## Facts

- Endpoint: POST https://x402-v2-mint-openalex-institutions.vercel.app/v1/openalex-institutions?utm_source=zero.xyz
- Price: $0.020089/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openalex-institutions-search-2fb2fdbd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CJDvnC7OAGifXzJ3kUgFa

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 openalex-institutions-search-2fb2fdbd -d '<json body>'
```

Example prompt: Search OpenAlex institutions for 'MIT' and give me up to 10 results.

## When to prefer this

Use this endpoint when you need to search or discover academic institutions, universities, hospitals, or research organizations by name or keyword using OpenAlex data, especially when you want a keyless (no API key required on your end) paid-per-call integration that avoids OpenAlex rate limits.

## Known failure modes

- Empty or missing query (q/search/query all absent) returns 400 and is not charged
- Query exceeding 200 characters may be rejected
- per_page values outside 1-25 range are rejected
- No matching institutions returns an empty results array
- Service downtime or Vercel cold-start may cause timeouts

## How this service works

OpenAlex institutions search (keyless; disclose OpenAlex adjacency). POST {q|search|query}/{per_page?}. Empty -> 400 not charged. Board W45 swap for gtex.

## Output

Returns a JSON object with an 'ok' boolean, the skill name ('openalex-institutions'), a 'charged' flag indicating payment was processed, and a 'summary' field. The payload includes matching institution records from the OpenAlex database corresponding to the search query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "maxLength": 200
  },
  "query": {
   "type": "string",
   "maxLength": 200
  },
  "search": {
   "type": "string",
   "maxLength": 200
  },
  "per_page": {
   "type": "integer",
   "maximum": 25,
   "minimum": 1
  },
  "request_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "skill": "openalex-institutions",
  "charged": true,
  "summary": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openalex-institutions-search-2fb2fdbd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-v2-mint-openalex-institutions.vercel.app](https://www.zero.xyz/host/x402-v2-mint-openalex-institutions.vercel.app/llms.txt)
