Birdeye

Birdeye Google Q&A API

Note Applicable to be used only by paid listings clients, for their active locations, for the Google Q&A section, in the Google listing

Documentation GitHub OpenAPI

Operations 9

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

POST /v1/qna/question/create Post a question and answer · Create Question #

Ask an LLM

“Can I post a question and its answer to my Google profile Q&A?”

“What's needed to seed a new Q&A pair for a location?”

Tell an agent

Create question {question} with answer {answer} for business {businessId}.

Seed a new Q&A pair on {businessId}: {question} answered {answer}.

POST /v1/qna/answer/create Answer an existing question · Create Answer #

Ask an LLM

“Can I answer a question someone already asked on my Google profile?”

“Can I add an answer to an existing Q&A question?”

Tell an agent

Answer question {questionId} with {answer} for business {businessId}.

Reply to Google question {questionId} on {businessId} with {answer}.

PUT /v1/qna/question/update Edit a posted question · Update Question #

Ask an LLM

“Can I edit the wording of a question I posted?”

“Is it possible to reword a Q&A question after it's live?”

Tell an agent

Change question {questionId} on {businessId} to {question}.

Reword Q&A question {questionId} to {question} for business {businessId}.

PUT /v1/qna/answer/update Edit a posted answer · Update Answer #

Ask an LLM

“Can I edit an answer already posted to a question?”

“Is it possible to correct a Q&A answer after publishing?”

Tell an agent

Update answer {answerId} on question {questionId} to {answer} for {businessId}.

Correct answer {answerId} of question {questionId} to read {answer} on business {businessId}.

POST /v1/qna/question/delete Delete a question · Delete Question #

Ask an LLM

“Can I delete a single question from my Google Q&A?”

“Is there a way to take down one question I posted?”

Tell an agent destructive · confirm first

Delete question {questionId} from business {businessId}.

Remove Q&A question {questionId} on {businessId}.

POST /v1/qna/answer/delete Delete an answer · Delete Answer #

Ask an LLM

“Can I delete one answer but keep the question?”

“Is it possible to remove an answer I posted on a location's Q&A?”

Tell an agent destructive · confirm first

Delete answer {answerId} from question {questionId} on {businessId}.

Remove answer {answerId} under question {questionId} for business {businessId}.

DELETE /v1/qna/question/deleteAll Delete all Q&A for a business · Delete All Questions and Answers #

Ask an LLM

“Can I wipe every question and answer from a location at once?”

“Is there a bulk delete for all Google Q&A on a business?”

Tell an agent destructive · confirm first

Delete all questions and answers for business {businessId}.

Clear the entire Q&A of {businessId}.

POST /v1/qna/get List all questions and answers · Get All Questions and Answers #

Ask an LLM

“Can I list all Q&A on my Google profile?”

“Can I page through every question and answer for a business?”

Tell an agent

Get questions and answers for {businessId} from index {startIndex}, page size {pageSize}.

List all Q&A on business {businessId}, {pageSize} at a time starting at {startIndex}.

POST /v1/qna/unanswered/get List unanswered questions · Get All Unanswered Questions and Answers #

Ask an LLM

“Which questions on my Google profile still have no answer?”

“Can I list only unanswered questions for a location?”

Tell an agent

List unanswered questions for {businessId} from {startIndex}, page size {pageSize}.

Find questions awaiting an answer on {businessId}, starting {startIndex}, {pageSize} per page.

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/birdeye:birdeye-google-q-a-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Birdeye Google Q&A API
  version: '1.0'
  description: 'Operations tagged Google Q&A 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: Google Q&A
  description: 'Note


    Applicable to be used only by paid listings clients, for their active locations, for the Google Q&A section, in the Google listing'
paths:
  /v1/qna/question/create:
    post:
      summary: Create Question
      operationId: create-question
      tags:
      - Google Q&A
      parameters:
      - name: businessId
        in: query
        required: true
        description: Id of the business.
        schema:
          type: string
        example: '12345678'
      responses:
        '200':
          description: HTTP 200 response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 2483
                  message: Question should have minimum 3 words
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                question:
                  type: string
                answer:
                  type: string
              required:
              - question
              - answer
      security:
      - apiKey: []
    servers:
    - url: https://api.birdeye.com
      description: Production
  /v1/qna/answer/create:
    post:
      summary: Create Answer
      operationId: create-answer
      tags:
      - Google Q&A
      parameters:
      - name: businessId
        in: query
        required: true
        description: Id of the business.
        schema:
          type: string
        example: '12345678'
      responses:
        '200':
          description: HTTP 200 response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 2462
                  message: Owner answer already added please edit answer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                questionId:
                  type: number
                answer:
                  type: string
              required:
              - questionId
              - answer
      security:
      - apiKey: []
    servers:
    - url: https://api.birdeye.com
      description: Production
  /v1/qna/question/update:
    put:
      summary: Update Question
      operationId: update-question
      tags:
      - Google Q&A
      parameters:
      - name: businessId
        in: query
        required: true
        description: Id of the business.
        schema:
          type: string
        example: '12345678'
      responses:
        '200':
          description: HTTP 200 response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 2482
                  message: Question Id is Invalid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                questionId:
                  type: number
                question:
                  type: string
              required:
              - questionId
              - question
      security:
      - apiKey: []
    servers:
    - url: https://api.birdeye.com
      description: Production
  /v1/qna/answer/update:
    put:
      summary: Update Answer
      operationId: update-answer
      tags:
      - Google Q&A
      parameters:
      - name: businessId
        in: query
        required: true
        description: Id of the business.
        schema:
          type: string
        example: '12345678'
      responses:
        '200':
          description: HTTP 200 response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 2482
                  message: Question Id is Invalid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                questionId:
                  type: number
                answerId:
                  type: number
                answer:
                  type: string
              required:
              - questionId
              - answerId
              - answer
      security:
      - apiKey: []
    servers:
    - url: https://api.birdeye.com
      description: Production
  /v1/qna/question/delete:
    post:
      summary: Delete Question
      operationId: delete-question
      tags:
      - Google Q&A
      parameters:
      - name: businessId
        in: query
        required: true
        description: Id of the business.
        schema:
          type: string
        example: '12345678'
      responses:
        '200':
          description: HTTP 200 response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 2482
                  message: Question Id is Invalid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                questionId:
                  type: number
              required:
              - questionId
      security:
      - apiKey: []
    servers:
    - url: https://api.birdeye.com
      description: Production
  /v1/qna/answer/delete:
    post:
      summary: Delete Answer
      operationId: delete-answer
      tags:
      - Google Q&A
      parameters:
      - name: businessId
        in: query
        required: true
        description: Id of the business.
        schema:
          type: string
        example: '12345678'
      responses:
        '200':
          description: HTTP 200 response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 2482
                  message: Question Id is Invalid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                questionId:
                  type: number
                answerId:
                  type: number
              required:
              - questionId
              - answerId
      security:
      - apiKey: []
    servers:
    - url: https://api.birdeye.com
      description: Production
  /v1/qna/question/deleteAll:
    delete:
      summary: Delete All Questions and Answers
      operationId: delete-all-questions-and-answers
      tags:
      - Google Q&A
      parameters:
      - name: businessId
        in: query
        required: true
        description: Id of the business.
        schema:
          type: string
        example: '12345678'
      responses:
        '200':
          description: HTTP 200 response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 2482
                  message: Question Id is Invalid
      security:
      - apiKey: []
    servers:
    - url: https://api.birdeye.com
      description: Production
  /v1/qna/get:
    post:
      summary: Get All Questions and Answers
      operationId: get-all-questions-and-answers
      tags:
      - Google Q&A
      parameters:
      - name: businessId
        in: query
        required: true
        description: Id of the business.
        schema:
          type: string
        example: '12345678'
      responses:
        '200':
          description: HTTP 200 response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 2466
                  message: Invalid input request
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                startIndex:
                  type: number
                pageSize:
                  type: number
              required:
              - startIndex
              - pageSize
      security:
      - apiKey: []
    servers:
    - url: https://api.birdeye.com
      description: Production
  /v1/qna/unanswered/get:
    post:
      summary: Get All Unanswered Questions and Answers
      operationId: get-all-unanswered-questions-and-answers
      tags:
      - Google Q&A
      parameters:
      - name: businessId
        in: query
        required: true
        description: Id of the business.
        schema:
          type: string
        example: '12345678'
      responses:
        '200':
          description: HTTP 200 response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 2466
                  message: Invalid input request
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                startIndex:
                  type: number
                pageSize:
                  type: number
              required:
              - startIndex
              - pageSize
      security:
      - apiKey: []
    servers:
    - url: https://api.birdeye.com
      description: Production
components:
  schemas:
    Apiary_getAllUnansweredQuestionsAndAnswers_Response200:
      type: object
      properties:
        totalCount:
          type: number
          description: Total number of questions
        questionsAndAnswers:
          type: array
          description: Questions and answers details
          items:
            type: object
            properties:
              questionId:
                type: number
                description: Unique question identifier.
              answeredByOwner:
                type: boolean
                description: Identified if question was answered by page owner.
              askedByOwner:
                type: boolean
                description: Identifies if question was asked by page owner.
              question:
                type: string
                description: text of question
              updatedBy:
                type: string
                description: Name of author of question
              time:
                type: string
                description: time at which question was created/updated hh:mm AM/PM
              updatedOn:
                type: string
                description: Date at which question was created/updated MMM DD, YYYY
              userProfileLogoUrl:
                type: string
                description: url link to google profile photo of author
              userCategory:
                type: string
                description: category of author MERCHANT, REGULAR_USER, LOCAL_GUIDE
              locationName:
                type: string
                description: Birdeye registered business name
              noOfAnswers:
                type: string
                description: number of answer available on question
              answers:
                type: object
                properties:
                  answerId:
                    type: number
                    description: Unique answer identifier.
                  answer:
                    type: string
                    description: Text of answer.
                  answeredByOwner:
                    type: boolean
                    description: Identifies if this answer was added by owner.
                  updatedBy:
                    type: string
                    description: Name of author of answer.
                  updatedOn:
                    type: string
                    description: 'Date at which answer was created/updated format : MMM DD, YYYY'
                  time:
                    type: string
                    description: 'time at which answer was created/updated format: hh:mm AM/PM'
                  userCategory:
                    type: string
                    description: category of author MERCHANT, REGULAR_USER, LOCAL_GUIDE
                  userProfileLogoUrl:
                    type: string
                    description: url link to google profile photo of author
                description: Answers details
    2482Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 2482
        message: Question Id is Invalid
    2466Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 2466
        message: Invalid input request
    Apiary_getAllQuestionsAndAnswers_Response200:
      type: object
      properties:
        totalCount:
          type: number
          description: Total number of questions
        questionsAndAnswers:
          type: array
          description: Questions and answers details
          items:
            type: object
            properties:
              questionId:
                type: number
                description: Unique question identifier.
              answeredByOwner:
                type: boolean
                description: Identified if question was answered by page owner.
              askedByOwner:
                type: boolean
                description: Identifies if question was asked by page owner.
              question:
                type: string
                description: text of question
              updatedBy:
                type: string
                description: Name of author of question
              time:
                type: string
                description: time at which question was created/updated hh:mm AM/PM
              updatedOn:
                type: string
                description: Date at which question was created/updated MMM DD, YYYY
              userProfileLogoUrl:
                type: string
                description: url link to google profile photo of author
              userCategory:
                type: string
                description: category of author MERCHANT, REGULAR_USER, LOCAL_GUIDE
              locationName:
                type: string
                description: Birdeye registered business name
              noOfAnswers:
                type: string
                description: number of answer available on question
              answers:
                type: object
                properties:
                  answerId:
                    type: number
                    description: Unique answer identifier.
                  answer:
                    type: string
                    description: Text of answer.
                  answeredByOwner:
                    type: boolean
                    description: Identifies if this answer was added by owner.
                  updatedBy:
                    type: string
                    description: Name of author of answer.
                  updatedOn:
                    type: string
                    description: 'Date at which answer was created/updated format : MMM DD, YYYY'
                  time:
                    type: string
                    description: 'time at which answer was created/updated format: hh:mm AM/PM'
                  userCategory:
                    type: string
                    description: category of author MERCHANT, REGULAR_USER, LOCAL_GUIDE
                  userProfileLogoUrl:
                    type: string
                    description: url link to google profile photo of author
                description: Answers details
    1167Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 1167
        message: API key is missing
    2478Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 2478
        message: Question is required
    2462Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 2462
        message: Owner answer already added please edit answer
    89Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 89
        message: Rate limit exceeded
    2461Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 2461
        message: No question found with provided request
    1011Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 1011
        message: Business id is invalid
    1161Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 1161
        message: Invalid API key
    2483Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 2483
        message: Question should have minimum 3 words
    2481Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 2481
        message: Q&A cannot be more than 4096 characters
    2485Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 2485
        message: Questions should be 10 characters minimum
    2480Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 2480
        message: Cannot modify non owner Q&A
    2479Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 2479
        message: Answer is required
  requestBodies:
    Delete_AnswerBody:
      content:
        application/json:
          schema:
            type: object
            properties:
              questionId:
                type: number
                description: unique question identifier
              answerId:
                type: number
                description: unique answer identifier
            required:
            - questionId
            - answerId
            example:
              questionId: 7812
              answerId: 7813
    Get_All_Questions_and_AnswersBody:
      content:
        application/json:
          schema:
            type: object
            properties:
              startIndex:
                type: number
                description: start index
              pageSize:
                type: number
                description: page size
            required:
            - startIndex
            - pageSize
            example:
              startIndex: 0
              pageSize: 25
  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

Birdeye Google Q&A API

Operations 9

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification