Google Cloud Recommendations AI Projects API
The Projects API from Google Cloud Recommendations AI — 3 operation(s) for projects.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/google-cloud-recommendations-ai:google-cloud-recommendations-ai-projects-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Google Cloud Recommendations AI Projects API
description: Delivers personalized product recommendations at scale using machine learning for retail and e-commerce use cases.
version: v1beta1
contact:
name: Google Cloud
url: https://cloud.google.com/recommendations-ai
servers:
- url: https://recommendationengine.googleapis.com/v1beta1
tags:
- name: Projects
paths:
/projects/{projectId}/locations/{location}/catalogs/{catalogId}/catalogItems:
get:
operationId: listCatalogItems
summary: Google Cloud Recommendations AI List catalog items
description: Lists all catalog items in the specified catalog.
parameters:
- name: projectId
in: path
required: true
schema:
type: string
- name: location
in: path
required: true
schema:
type: string
- name: catalogId
in: path
required: true
schema:
type: string
- name: pageSize
in: query
schema:
type: integer
- name: pageToken
in: query
schema:
type: string
responses:
'200':
description: Successful response with catalog items.
content:
application/json:
schema:
type: object
properties:
catalogItems:
type: array
items:
$ref: '#/components/schemas/CatalogItem'
nextPageToken:
type: string
tags:
- Projects
post:
operationId: createCatalogItem
summary: Google Cloud Recommendations AI Create a catalog item
description: Creates a new catalog item in the specified catalog.
parameters:
- name: projectId
in: path
required: true
schema:
type: string
- name: location
in: path
required: true
schema:
type: string
- name: catalogId
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CatalogItem'
responses:
'200':
description: Successful catalog item creation.
content:
application/json:
schema:
$ref: '#/components/schemas/CatalogItem'
tags:
- Projects
/projects/{projectId}/locations/{location}/catalogs/{catalogId}/eventStores/{eventStoreId}/userEvents:
post:
operationId: writeUserEvent
summary: Google Cloud Recommendations AI Write a user event
description: Writes a single user event to the event store.
parameters:
- name: projectId
in: path
required: true
schema:
type: string
- name: location
in: path
required: true
schema:
type: string
- name: catalogId
in: path
required: true
schema:
type: string
- name: eventStoreId
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserEvent'
responses:
'200':
description: Successful user event creation.
content:
application/json:
schema:
$ref: '#/components/schemas/UserEvent'
tags:
- Projects
? /projects/{projectId}/locations/{location}/catalogs/{catalogId}/eventStores/{eventStoreId}/placements/{placementId}:predict
: post:
operationId: predict
summary: Google Cloud Recommendations AI Get recommendations
description: Makes a recommendation prediction for a user.
parameters:
- name: projectId
in: path
required: true
schema:
type: string
- name: location
in: path
required: true
schema:
type: string
- name: catalogId
in: path
required: true
schema:
type: string
- name: eventStoreId
in: path
required: true
schema:
type: string
- name: placementId
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PredictRequest'
responses:
'200':
description: Successful recommendation prediction response.
content:
application/json:
schema:
$ref: '#/components/schemas/PredictResponse'
tags:
- Projects
components:
schemas:
PredictResponse:
type: object
properties:
results:
type: array
items:
type: object
properties:
id:
type: string
metadata:
type: object
recommendationToken:
type: string
nextPageToken:
type: string
UserEvent:
type: object
required:
- eventType
- userInfo
properties:
eventType:
type: string
enum:
- EVENT_TYPE_UNSPECIFIED
- detail-page-view
- add-to-cart
- remove-from-cart
- purchase-complete
- category-page-view
- home-page-view
- search
userInfo:
type: object
properties:
visitorId:
type: string
userId:
type: string
eventDetail:
type: object
properties:
recommendationToken:
type: string
eventAttributes:
type: object
productEventDetail:
type: object
properties:
productDetails:
type: array
items:
type: object
properties:
id:
type: string
quantity:
type: integer
eventTime:
type: string
PredictRequest:
type: object
required:
- userEvent
properties:
userEvent:
$ref: '#/components/schemas/UserEvent'
pageSize:
type: integer
pageToken:
type: string
filter:
type: string
dryRun:
type: boolean
params:
type: object
additionalProperties:
type: object
CatalogItem:
type: object
required:
- id
- categoryHierarchies
- title
properties:
id:
type: string
categoryHierarchies:
type: array
items:
type: object
properties:
categories:
type: array
items:
type: string
title:
type: string
description:
type: string
languageCode:
type: string
tags:
type: array
items:
type: string
itemAttributes:
type: object
properties:
categoricalFeatures:
type: object
additionalProperties:
type: object
numericalFeatures:
type: object
additionalProperties:
type: object
productMetadata:
type: object
properties:
priceRange:
type: object
properties:
min:
type: number
max:
type: number
availableQuantity:
type: integer
canonicalProductUri:
type: string