Developers

Page Search API

Search ZSR.GG pages and receive canonical page links. This endpoint is public, read-only, and does not require an API key.

Request

GET /api/pages?q=wrong%20warp&scope=tags

Parameter	Required	Description
`q`	Yes	Search text, from 1 to 120 characters.
`scope`	No	`all`, `title`, `content`, or `tags`. Defaults to `all`.
`game`	No	Restrict results to one game slug, such as `oot`.
`page`	No	Result page, from 1 to 1,000. Defaults to 1.
`page_size`	No	Results per page, from 1 to 50. Defaults to 20.

Title and content searches are case-insensitive substring matches. Tag searches are case-insensitive exact matches after whitespace normalization. Translation titles and content are searched, but every result points to its canonical base page.

Example

curl "https://www.zsr.gg/api/pages?q=wrong%20warp&scope=tags&game=oot&page_size=20"

{
  "query": "wrong warp",
  "scope": "tags",
  "game": "oot",
  "page": 1,
  "page_size": 20,
  "total": 1,
  "results": [
    {
      "title": "Forest Temple Wrong Warp",
      "href": "/oot/tech/forest-temple-wrong-warp",
      "url": "https://www.zsr.gg/oot/tech/forest-temple-wrong-warp",
      "game": "oot",
      "game_name": "Ocarina of Time",
      "category": "tech",
      "category_name": "Techniques",
      "slug": "forest-temple-wrong-warp",
      "tags": ["wrong warp", "forest temple"],
      "updated_at": "2026-09-03T12:00:00.000Z"
    }
  ]
}

Limits and errors

Requests are limited to 60 per five minutes per IP address, with an additional global limit. A limited request returns 429 and a Retry-After header.

This endpoint returns links and page metadata.