v68

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0170379386.9 KB

Recommend documents

Retrieve recommended documents for the given URL or Glean Document ID.

post/rest/api/v1/recommendations

Query parameters

localestring

The client's preferred locale in rfc5646 format (e.g. en, ja, pt-BR). If omitted, the Accept-Language will be used. If not present or not supported, defaults to the closest match or en.

Headers

X-Glean-ActAsstring email

Email address of a user on whose behalf the request is intended to be made (should be non-empty only for global tokens).

X-Glean-Auth-Typestring

Auth type being used to access the endpoint (should be non-empty only for global tokens).

Request body

timestampstring date-time

The ISO 8601 timestamp associated with the client request.

trackingTokenstring

A previously received trackingToken for a search associated with the same query. Useful for more requests and requests for other tabs.

pageSizeinteger

Hint to the server about how many results to send back. Server may return less or more. Structured results and clustered results don't count towards pageSize.

maxSnippetSizeinteger

Hint to the server about how many characters long a snippet may be. Server may return less or more.

Response

trackingTokenstring

A token that should be passed for additional requests related to this request (such as more results requests).

requestIDstring

A platform-generated request ID to correlate backend logs.

backendTimeMillisinteger

Time in milliseconds the backend took to respond to the request.