# ShanghaiRanking GRAS University Rankings

> ShanghaiRanking GRAS University Rankings is a paid API for AI agents from api.webintel-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Returns ranked universities by academic subject from the ShanghaiRanking Global Ranking of Academic Subjects (GRAS), including scores and indicators, with optional filtering by country or university name.

## Facts

- Endpoint: GET https://api.webintel-api.workers.dev/api/search/shanghai-gras-rankings?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/shanghairanking-gras-university-rankings-7eb16dc6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_msMDG5qcZTrqYYFkLV69e

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 shanghairanking-gras-university-rankings-7eb16dc6
```

Example prompt: What does ShanghaiRanking's GRAS say about the top 20 Computer Science universities in the United States for 2024, including their total scores and indicator breakdowns?

## When to prefer this

Choose this endpoint when you need structured, machine-readable GRAS subject-level university rankings from ShanghaiRanking, especially when filtering by country, university name, or year is needed. Prefer this over web scraping ShanghaiRanking.com directly. Best suited for academic research tools, university comparison agents, or education-domain data pipelines requiring indicator-level breakdown.

## Known failure modes

- Invalid or unsupported subject name/code returns empty results or error
- Year outside 2017–2026 range may return no data
- Country string must match ShanghaiRanking's own spelling (e.g. 'Türkiye' not 'Turkey'), otherwise filter returns empty
- Limit outside 1–500 range may be rejected or clamped
- Network or upstream ShanghaiRanking data unavailability may return a 5xx error

## How this service works

ShanghaiRanking Global Ranking of Academic Subjects (GRAS): for a subject (55, e.g. Mathematics, Computer Science, Clinical Medicine, Economics) and year, ranked universities with rank or band, total score, the five indicator scores, country and institution URL. Filter by country or university name. Without a subject, lists the subjects and their codes.

## Output

Returns a list of universities ranked for the specified academic subject and year, each with rank or rank band, total score, five individual indicator scores, country, and institution URL. If no subject is provided, returns a list of all available subjects with their codes. Supports filtering by country or partial university name.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "year": {
       "type": "string",
       "description": "Ranking year, 2017 to 2026 (default: newest for the subject)"
      },
      "limit": {
       "type": "string",
       "description": "Rows to return, 1 to 500 (default 50)"
      },
      "country": {
       "type": "string",
       "description": "Optional country/region as ShanghaiRanking writes it, e.g. United States, China, Türkiye"
      },
      "subject": {
       "type": "string",
       "description": "Subject name or code, e.g. Mathematics or AS0101 (omit to list subjects)"
      },
      "university": {
       "type": "string",
       "description": "Optional part of a university name"
      }
     }
    }
   },
   "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/shanghairanking-gras-university-rankings-7eb16dc6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.webintel-api.workers.dev](https://www.zero.xyz/host/api.webintel-api.workers.dev/llms.txt)