To manage products, locations, and business details through Listing GMB platform
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/birdeye:birdeye-gmb-products-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
title: Birdeye GMB Products API
version: '1.0'
description: 'Operations tagged GMB Products across 2 of this provider''s published API definitions: birdeye-birdeye-api-openapi.yml, birdeye-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.birdeye.com
description: Production
- url: https://api.birdeye.com/resources
tags:
- name: GMB Products
description: To manage products, locations, and business details through Listing GMB platform
paths:
/v1/listing/public/product/setup/googleMerchant:
post:
summary: Onboard Google Merchant Account
operationId: onboard-google-merchant-account
tags:
- GMB Products
parameters:
- name: merchantId
in: query
required: true
description: Google Merchant Center account ID.
schema:
type: string
example: '1234567'
responses:
'200':
description: HTTP 200 response
content:
application/json:
schema:
type: object
example:
code: 1167
message: API key is missing
requestBody:
required: true
content:
application/json:
schema:
type: object
example: {}
security:
- apiKey: []
servers:
- url: https://api.birdeye.com
description: Production
/v1/listing/public/product:
post:
summary: Create Product Listing
operationId: create-product-listing
tags:
- GMB Products
parameters: []
responses:
'200':
description: HTTP 200 response
content:
application/json:
schema:
type: object
example:
code: 1167
message: API key is missing
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
businessNumbers:
type: array
title:
type: string
description:
type: string
imageLink:
type: string
additionalImageLinks:
type: array
brandName:
type: string
googleProductCategoryId:
type: string
price:
type: object
properties:
amount:
type: string
currencyCode:
type: string
required:
- amount
- currencyCode
salePrice:
type: object
properties:
amount:
type: string
currencyCode:
type: string
required:
- amount
- currencyCode
productSku:
type: string
productTypes:
type: array
productUrl:
type: string
status:
type: string
required:
- title
- imageLink
- googleProductCategoryId
- price
- status
security:
- apiKey: []
servers:
- url: https://api.birdeye.com
description: Production
/v1/listing/public/product/{productId}:
put:
summary: Update Product Listing
operationId: update-product-listing
tags:
- GMB Products
parameters:
- name: productId
in: path
required: true
description: Unique identifier of the product to update.
schema:
type: string
example: 68767cb39ebf51000815ab39
responses:
'200':
description: HTTP 200 response
content:
application/json:
schema:
type: object
example:
code: 1167
message: API key is missing
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
businessNumbers:
type: array
title:
type: string
description:
type: string
imageLink:
type: string
additionalImageLinks:
type: array
brandName:
type: string
googleProductCategoryId:
type: string
price:
type: object
properties:
amount:
type: string
currencyCode:
type: string
required:
- amount
- currencyCode
salePrice:
type: object
properties:
amount:
type: string
currencyCode:
type: string
required:
- amount
- currencyCode
productTypes:
type: array
productUrl:
type: string
status:
type: string
required:
- title
- imageLink
- googleProductCategoryId
- price
- status
security:
- apiKey: []
servers:
- url: https://api.birdeye.com
description: Production
/v1/listing/public/product/{productIdentifier}:
get:
summary: Get Product Listing
operationId: get-product-listing
tags:
- GMB Products
parameters:
- name: productIdentifier
in: path
required: true
description: Product identifier.
schema:
type: string
example: 68767cb39ebf51000815ab39
responses:
'200':
description: HTTP 200 response
content:
application/json:
schema:
type: object
example:
code: 1167
message: API key is missing
security:
- apiKey: []
servers:
- url: https://api.birdeye.com
description: Production
/v1/listing/public/product/deleteProduct:
post:
summary: Delete Product Listings
operationId: delete-product-listings
tags:
- GMB Products
parameters: []
responses:
'200':
description: HTTP 200 response
content:
application/json:
schema:
type: object
example:
code: 1167
message: API key is missing
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
productIds:
type: array
required:
- productIds
security:
- apiKey: []
servers:
- url: https://api.birdeye.com
description: Production
/v1/listing/public/product/getList:
post:
summary: Get List Product Listing
operationId: get-list-product-listing
tags:
- GMB Products
parameters:
- name: pageSize
in: query
required: false
description: Number of records per page. Default 50.
schema:
type: number
example: '50'
- name: pageNumber
in: query
required: false
description: 0-based page index. Default 0.
schema:
type: number
example: '0'
responses:
'200':
description: HTTP 200 response
content:
application/json:
schema:
type: object
example:
code: 1167
message: API key is missing
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
search:
type: string
status:
type: array
businessNumbers:
type: array
security:
- apiKey: []
servers:
- url: https://api.birdeye.com
description: Production
/v1/listing/public/product/addProduct:
post:
summary: Add Products On a Location
operationId: add-products-on-a-location
tags:
- GMB Products
parameters: []
responses:
'200':
description: HTTP 200 response
content:
application/json:
schema:
type: object
example:
code: 1167
message: API key is missing
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
productIds:
type: array
required:
- productIds
security:
- apiKey: []
servers:
- url: https://api.birdeye.com
description: Production
/v1/listing/public/product/removeProduct:
post:
summary: Remove Products On a Location
operationId: remove-products-on-a-location
tags:
- GMB Products
parameters: []
responses:
'200':
description: HTTP 200 response
content:
application/json:
schema:
type: object
example:
code: 1167
message: API key is missing
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
productIds:
type: array
required:
- productIds
security:
- apiKey: []
servers:
- url: https://api.birdeye.com
description: Production
components:
schemas:
Apiary_updateProductListing_Response200:
type: object
properties:
productId:
type: string
description: Unique identifier for the product.
code:
type: number
description: Error code. Present on validation failure.
message:
type: string
description: Error message. Present on validation failure.
data:
type: object
properties:
errorAttributes:
type: array
items:
type: object
properties:
type:
type: string
description: Type of validation error.
message:
type: string
description: Validation error message.
Apiary_getListProductListing_Response200:
type: object
properties:
response:
type: array
description: Product list
items:
type: object
properties:
productId:
type: string
productSku:
type: string
locationCount:
type: number
title:
type: string
description:
type: string
productUrl:
type: string
description: bragadiru.ro/preturi/ (string)
imageLink:
type: string
additionalImageLinks:
type: array
items: {}
videoUrl:
type: string
brandName:
type: string
googleProductCategoryId:
type: string
price:
type: object
properties:
amount:
type: string
currencyCode:
type: string
productTypes:
type: array
items: {}
salePrice:
type: object
properties:
amount:
type: string
currencyCode:
type: string
status:
type: string
updatedOn:
type: number
description: Epoch time.
updatedBy:
type: string
totalCount:
type: number
1167Model:
type: object
properties:
code:
type: number
message:
type: string
example:
code: 1167
message: API key is missing
89Model:
type: object
properties:
code:
type: number
message:
type: string
example:
code: 89
message: Rate limit exceeded
1011Model:
type: object
properties:
code:
type: number
message:
type: string
example:
code: 1011
message: Business id is invalid
Apiary_createProductListing_Response200:
type: object
properties:
productId:
type: string
description: Unique identifier for the product.
code:
type: number
description: Error code. Present on validation failure.
message:
type: string
description: Error message. Present on validation failure.
data:
type: object
properties:
errorAttributes:
type: array
items:
type: object
properties:
type:
type: string
description: Type of validation error.
message:
type: string
description: Validation error message.
1161Model:
type: object
properties:
code:
type: number
message:
type: string
example:
code: 1161
message: Invalid API key
Apiary_createProductListing_Request:
type: object
properties:
businessNumbers:
type: array
description: Location numbers of enterprise locations. If empty all valid enterprise locations will be selected.
items: {}
title:
type: string
description: Product title.
description:
type: string
imageLink:
type: string
description: Publicly accessible image URL.
additionalImageLinks:
type: array
description: Additional public image URLs.
items: {}
brandName:
type: string
googleProductCategoryId:
type: string
description: Google product taxonomy ID.
price:
type: object
properties:
amount:
type: string
description: Decimal string.
currencyCode:
type: string
description: ISO 4217 code.
required:
- amount
- currencyCode
salePrice:
type: object
properties:
amount:
type: string
currencyCode:
type: string
required:
- amount
- currencyCode
productSku:
type: string
description: Merchant SKU; if omitted, system may assign.
productTypes:
type: array
description: Product categorization keywords.
items: {}
productUrl:
type: string
description: implant (string, optional)
status:
type: string
description: 'Accepted values: `PUBLISH`, `DRAFT`.'
required:
- title
- imageLink
- googleProductCategoryId
- price
- status
example:
businessNumbers:
- 145308764185002
- 145308769721320
title: Dental Implant
description: The dental procedure for replacing missing teeth using implants.
imageLink: https://example.com/images/dental-implant-main.jpg
additionalImageLinks:
- https://example.com/images/dental-implant-side.jpg
- https://example.com/images/dental-implant-closeup.jpg
brandName: SmileCare
googleProductCategoryId: '123'
price:
amount: '1500.00'
currencyCode: USD
salePrice:
amount: '1200.00'
currencyCode: USD
productSku: DENTAL-IMPLANT-001
productTypes:
- Dental Services
- Implants
- Cosmetic Dentistry
productUrl: https://example.com/products/dental-implant
status: PUBLISH
requestBodies:
Fix_ListingBody:
content:
application/json:
schema:
type: object
properties: {}
example: {}
Add_Products_On_a_LocationBody:
content:
application/json:
schema:
type: object
properties:
productIds:
type: array
items: {}
required:
- productIds
example:
productIds:
- 68767cb39ebf51000815ab39
- 68767cb39ebf51000815ab39
securitySchemes:
apiKey:
type: apiKey
in: header
name: x-api-key
description: Partner specific API key provided by Birdeye for data exchange.
x-refined-from:
- birdeye-birdeye-api-openapi.yml
- birdeye-openapi-original.yml