Search the docs

Pages of Median’s documentation that match the words, best first, each with a line around the match.

GET/docs/search

Authorization

AuthorizationBearer token · headerrequired

`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.

Query parameters

qstringrequired

limitinteger

Up to 8. Default 5.

Responses

200The matches.

pagesobject[]

Show properties

Array of object

titlestring

routestring

urlstring

sectionstring

descriptionstring

snippetstring

401The bearer token is missing, revoked, or expired.

errorobject

Show properties

codestring

messagestring

429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).

errorobject

Show properties

codestring

messagestring

Request

curl -X GET "https://api.median.sh/v1/docs/search?q=string" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.median.sh/v1/docs/search?q=string", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Response

{
  "pages": [
    {
      "title": "string",
      "route": "string",
      "url": "string",
      "section": "string",
      "description": "string",
      "snippet": "string"
    }
  ]
}