{"openapi":"3.1.0","info":{"title":"monad.xyz site API","version":"1.0.0","description":"Public endpoints of monad.xyz, the official Monad Foundation site. For the Monad blockchain JSON-RPC API (chain ID 143, https://rpc.monad.xyz), see https://docs.monad.xyz.\n\nVersioning: the major version is the first path segment after /api (/api/v1). Additions that do not break existing callers (new optional parameters, new response fields) ship within a version. A breaking change ships under a new prefix, and the previous version then answers with Deprecation and Sunset response headers until it is switched off.\n\nRate limits: 120 requests per 60 seconds per client address. Every response states the limit in a RateLimit-Policy header; past it the answer is 429 with RateLimit and Retry-After headers.\n\nErrors: every 4xx and 5xx response carries an error object with a machine-readable code, a message and a hint on what to do next.","contact":{"name":"Monad Foundation","url":"https://monad.xyz/about"}},"servers":[{"url":"https://monad.xyz","description":"Production"}],"paths":{"/api/v1/search":{"get":{"operationId":"searchSiteIndex","summary":"Search the site index","description":"Returns entries of the monad.xyz search index: blog posts and announcements, infrastructure providers, and videos. Without parameters it returns the whole index. Static pages and newsroom press releases are not indexed, so a missing result does not mean a page does not exist; see /sitemap.xml for every page. Responses are cached for one hour.","parameters":[{"name":"q","in":"query","required":false,"description":"Text to look for in titles and descriptions, case-insensitive.","schema":{"type":"string","maxLength":200}},{"name":"type","in":"query","required":false,"description":"Only entries of this kind.","schema":{"type":"string","enum":["page","infra","video","blog"]}},{"name":"limit","in":"query","required":false,"description":"The most entries to return. All of them when absent.","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"The matching entries.","headers":{"RateLimit-Policy":{"description":"The limit each client address is held to, as an IETF RateLimit policy (draft-ietf-httpapi-ratelimit-headers): q is the number of requests, w the window in seconds.","schema":{"type":"string"},"example":"\"default\";q=120;w=60"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"A parameter is out of range (code: invalid_parameter).","headers":{"RateLimit-Policy":{"description":"The limit each client address is held to, as an IETF RateLimit policy (draft-ietf-httpapi-ratelimit-headers): q is the number of requests, w the window in seconds.","schema":{"type":"string"},"example":"\"default\";q=120;w=60"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Any method other than GET (code: method_not_allowed).","headers":{"RateLimit-Policy":{"description":"The limit each client address is held to, as an IETF RateLimit policy (draft-ietf-httpapi-ratelimit-headers): q is the number of requests, w the window in seconds.","schema":{"type":"string"},"example":"\"default\";q=120;w=60"},"Allow":{"description":"The methods this endpoint answers.","schema":{"type":"string"},"example":"GET, HEAD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too many requests from this address (code: rate_limited).","headers":{"RateLimit-Policy":{"description":"The limit each client address is held to, as an IETF RateLimit policy (draft-ietf-httpapi-ratelimit-headers): q is the number of requests, w the window in seconds.","schema":{"type":"string"},"example":"\"default\";q=120;w=60"},"RateLimit":{"description":"What is left of the limit: r is the requests remaining, t the seconds until it resets.","schema":{"type":"string"},"example":"\"default\";r=0;t=60"},"Retry-After":{"description":"Seconds to wait before the next request.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"The index failed to build (code: search_index_unavailable); retry shortly.","headers":{"RateLimit-Policy":{"description":"The limit each client address is held to, as an IETF RateLimit policy (draft-ietf-httpapi-ratelimit-headers): q is the number of requests, w the window in seconds.","schema":{"type":"string"},"example":"\"default\";q=120;w=60"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"SearchItem":{"type":"object","required":["id","type","title","href"],"properties":{"id":{"type":"string","description":"Stable item id."},"type":{"type":"string","enum":["page","infra","video","blog"],"description":"Kind of indexed content."},"title":{"type":"string"},"description":{"type":"string"},"href":{"type":"string","description":"Site-relative or absolute URL of the item."}}},"SearchResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SearchItem"}}}},"Error":{"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string","description":"Machine-readable reason.","enum":["invalid_parameter","method_not_allowed","rate_limited","search_index_unavailable","endpoint_not_found"]},"message":{"type":"string","description":"What went wrong."},"hint":{"type":"string","description":"What to do next."}}},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"$ref":"#/components/schemas/Error"},"items":{"type":"array","maxItems":0,"description":"Always empty on an error from the search endpoint."}}}}}}