/recommendations/base endpoint to recommend their own relevant books, articles, or videos. To preview the content, they could use the /recommendations/verbose endpoint to display a relevant snippet or a sample of one, encouraging the user to explore the full item.
Ranking (by snippet count, then cumulative certainty) is identical to the Affiliate Recommendations API. The Recommendations lesson in the AI Learning Center explains it and when to use each endpoint.
Before you start
First, find which publisher’s content you want to query.- Find Your Tenant (Publisher Name): Go to the Organizations page in Studio and click “View Publishers”. Your Tenant is the name of the publisher you’re querying.
- Identify the Collection: A collection is where we keep customer content. Set the
collectionfield toGlooProd, the only collection you need.
You will only have access to your own publisher’s tenant through this endpoint. For multi-tenant collections such as
GlooProd, a tenant must be specified; requests outside your tenant return a 403 “Forbidden” response.Quick start: base recommendations
This endpoint returns snippet metadata without the snippet text.POST /ai/v1/data/items/recommendations/base
uuids array in the response contains snippet metadata, but not the snippet text.
Example response (/base)
Example response (/base)
Verbose recommendations
This endpoint returns the full snippet text.POST /ai/v1/data/items/recommendations/verbose
item_extra text contains visibleOnApps:true and returns them newest-first by publication date.
The response has the same shape as /base, with two additions: each entry in uuids carries the snippet text, and each item carries its raw item_extra text (which may be an empty string). See the verbose API reference for the full response.
Parameters
Sendquery and collection (plus tenant for a multi-tenant collection such as GlooProd). The optional fields filter by publisher and media type, set a certainty threshold, and decide how many snippets are searched and how many items come back. /verbose also takes item_extra_contains, sort_by and sort_order.
For every field and its default, see the API reference for base and verbose recommendations.
Next steps
Call this endpoint from your server so your key stays private, as API Key Security describes, and see Error Handling and Retries for which failed requests to retry.Affiliate Recommendations
Recommend items from the affiliate network.
Step-by-step tutorial
Build a recommender with code in six languages.
API Reference
Request and response details.

