> ## Documentation Index
> Fetch the complete documentation index at: https://birdeye-0229a3ce-developerportalchanges.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard



## OpenAPI

````yaml GET /v1/reports/smb
openapi: 3.0.0
info:
  title: Birdeye
  version: 0.0.1
  description: >-
    Birdeye helps businesses grow through happy customers. Over 80,000
    businesses use Birdeye everyday to attract new leads with Listings, Reviews
    and Referrals, convert them into customers with Webchat, Appointments, and
    Payments, and delight those customers with Surveys, Ticketing, and Insights
    - all in one place.


    The Birdeye APIs are built on HTTP and are RESTful APIs.


    * Uses resource-oriented URLs.


    * Uses built-in HTTP capabilities for passing parameters and authentication.


    * Responds with standard HTTP response codes to indicate errors.


    * Requests and responses payload attached with all the mentioned APIs, you
    may choose your preferred language per the integration requirement.


    ### Authentication and Rate limiting


    > __NOTE:__

    > - __All API requests targeting business accounts must include the
    x-api-key header. This header is required and mandatory for successful
    authentication and access to the API endpoints.__

    >

    > - __To protect your API key and prevent unauthorized access, please ensure
    all API requests are made from your backend server. Do not call the APIs
    directly from the browser or expose your API key in any client-side code.__


    To call a Birdeye API, you need a valid API key. It can be fetched via the
    Birdeye dashboard and is a confidential key.


    There is a limit to calling APIs with each API key [connect with the support
    team to get the current limit]. If too many requests are made within the
    threshold timeframe, an error will be returned in the response.


    ### Pagination


    Multiple API supporting pagination. These APIs have two parameters sindex
    and count.


    * <b>sindex:</b> is the start index


    * <b>count:</b> No. of records, you want to fetch.


    > __Note__

    > - _Deep Pagination with record window greater than 100k is not supported.
    Either reduce the sindex + count to be less than equal to 100k or use
    appropriate filters to narrow down your result set._


    <b>For example :</b>


    * Suppose you have to fetch 20 records:

    <pre><code>

    API call 1 -> sindex=0, count 10

    API call 2 -> sindex -> 10, count 10.

    </pre></code>


    * To fetch 100kth record:

    <pre><code>

    sindex = 99000 and count = 1000

    will just work fine as sindex + count = 100000 which is less than 100,000.

    </pre></code>


    * If you fetch more than 100kth records:

    <pre><code>

    sindex = 99000 and count = 1001, sindex + count = 100001

    which is greater than 100,000. Thus, you'll receive an error in response.

    </pre></code>


    ### HTTP Status Codes


    Every API response will have an HTTP status code.


    * <b>200 - OK:</b> API request is successful


    * <b>202 - Accepted:</b> The API request has been accepted for processing.


    * <b>400 - Bad Request:</b> The API request was unacceptable, often due to a
    missing or invalid parameter.


    * <b>404 - Not Found:</b> The requested resource does not exist.


    * <b>429 - Rate Limited:</b> You have made too many requests within the
    threshold timeframe.


    * <b>500 - Internal Server Error:</b> Something went wrong on our end.
    Please get in touch with support.


    ### Error Response


    Birdeye API will return a validation error in case of missing/invalid input
    in the request. The response will return the errorCode and errorMessage.


    For example :

    <pre><code>

    {
        "code": 1161,
        "message": "Invalid API key"
    }

    </pre></code>
servers:
  - url: https://api.birdeye.com/resources
security: []
tags:
  - name: Business
    description: Create and maintain your business on Birdeye.
  - name: Custom Fields
    description: Create, delete , update , associate and get custom fields easily.
  - name: User
    description: Delete and manage user profiles and permissions easily.
  - name: Reviews
    description: Consistently generate more reviews and higher ratings.
  - name: Contact
    description: >-
      Manage contacts across locations effortlessly with a robust Contact
      Management System.
  - name: Contact V2
    description: >-
      Easily manage contacts across multiple locations using enhanced Contact
      APIs, featuring built-in support for communication preference flags.
  - name: Campaign
    description: >-
      Create a short link for review requests and set review sources in the
      template.
  - name: Aggregation
    description: Access your public data from 150+ review sites.
  - name: Report
    description: >-
      Various reporting data points across Birdeye modules like reviews,
      insights and competitors etc for all your data visualisation
  - name: Survey
    description: >-
      Engage each customer at the right time with NPS or CSAT surveys to improve
      your service.
  - name: Business Media
    description: >-
      Add, delete and manage business media.


      > __Supported Media Size__

      > - _Photo: JPG or PNG. 720 x 720px. 10KB min._

      > - _Video: 30 sec long. 720p or more upto 75MB._


      > __Note__

      > - _Uploaded media will be pushed to your google business profile (if
      connected) and other long tail directories only._
  - name: Social
    description: Create and track Social posting for all channels.
  - name: Employee
  - name: Conversation
    description: >-
      Connect with customers across a range of digital channels from one unified
      inbox.
  - name: Subscription
    description: >-
      Subscribe or Unsubscribe multiple webhooks with different URLs or Events
      for a subscription and deliver real-time notifications.
  - name: Webhook
    description: >-
      Configure multiple webhooks with different URLs for a subscription and
      deliver real-time notifications.
  - name: Competitor
    description: Make competitive insights your unfair advantage.
  - name: Competitor AI
    description: Competitive intelligence, simplified by AI.
  - name: Insight AI
    description: Insight intelligence, simplified by AI.
  - 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_
  - name: Google Services
    description: >-
      > __Note__

      > - _Applicable to be used only by paid listings clients, for their active
      locations, for the Google Services section, in the Google listing._

      > - _No two services should have the same service name. It is recommended
      that all services created should  HAVE UNIQUE service names._

      > - _You CAN have the same service across two diff categories e.g.:
      Emergency counselling as a $100 paid service can be a service created &
      mapped to category A - Mental health and category B - Psychotherapy - both
      categories being present for the same location._
  - name: FAQ
    description: >-
      To retrieve all Question and Answer (QnA) entries across locations using
      FAQ APIs, enabling smart support and knowledge features for businesses.
  - name: Listing
    description: >-
      Keep your business information accurate and consistent across 50+
      websites.
  - name: GMB Products
    description: >-
      To manage products, locations, and business details through Listing GMB
      platform
  - name: Search AI
    description: >-
      Search AI provides a comprehensive view of your business performance
      across AI-powered search platforms, including data accuracy, sentiment
      analysis, citations, brand ranking, and overall visibility.
  - name: Ticketing
    description: >-
      Create standout customer support with ticketing across reviews, untagged,
      and survey responses.
  - name: Integration
    description: Birdeye integrates with various software or tools you use.
  - name: Change Logs
    description: >-
      * <b>07/03/2026</b> - Updated `mainBusinessDescription` and microsite
      `internalListing.description` fields in Create, Update and Get Listing
      APIs to be optional instead of required, with support for clearing the
      existing value by sending an empty string (V2BIRD-1690).


      * <b>06/10/2026</b> - Updated Get Contact API to support an optional
      `experienceScore` boolean field in the request body (default: false). When
      set to true, the response includes the customer's experience score and
      source.


      * <b>05/25/2026</b> - Added Update Custom card (PUT) and Delete Custom
      card (DELETE) API documentation under the Business profile custom card
      section.


      * <b>05/11/2026</b> - Added support for backdated survey responses in the
      POST Survey Response API. The `created` field (UTC Epoch milliseconds) is
      optional; if omitted, the server defaults to the current UTC timestamp.


      * <b>04/22/2026</b> - Provide subLocality field support in Get, Create and
      Update Listings APIs for NZ Locations.


      * <b>04/16/2026</b> - Added Archived Get Reviews API  under Reviews group.


      * <b>04/06/2026</b> - Updated Get Reviews API documentation to improve
      clarity on review statuses and how to retrieve all review types.


      * <b>03/24/2026</b> - Added Social Open URL Performance Report API and
      Insight AI APIs to retrieve location-wise metrics and benchmark score.


      * <b>03/18/2026</b> - Added Create Custom Card Time API under custom
      fields section.


      * <b>03/03/2026</b> - Added Response Time (overtime & by-location) and
      Response Rate(overtime & by-location) APIs under reports section and
      created group for Competitor AI.


      * <b>03/02/2026</b> - Added sendInvite (boolean, default - true) field in
      Create User Signup v2 API request body and attributes.


      * <b>02/11/2026</b> - Updated the API key identifier for applicable APIs
      by moving it from a query parameter to the x-api-key request header.


      * <b>02/03/2026</b> - Added the "Get All QnA" API under FAQ group to
      enable retrieval of QnA entries across business locations, with full
      request and response documentation


      * <b>01/19/2026</b> - Added a note under the Authentication and Rate
      limiting section specifying that the x-api-key header is mandatory for all
      API requests targeting EU region business accounts.


      * <b>01/13/2026</b> - Added Create User (Signup) API under User module to
      create and invite users for a business.


      * <b>09/22/2025</b> - Added GMB Products APIs to onboard/connect Google
      Merchant accounts and manage product listing actions.


      * <b>08/21/2025</b> - Added Single main business description Support.


      * <b>08/19/2025</b> - Added competitor /raptor public APIs for reviews
      aggregates.


      * <b>06/26/2025</b> - Added Contact V2 APIs with communication preference
      flag support.


      * <b>12/13/2024</b> - Added inline reply support for GetReviews APIs.


      * <b>09/27/2024</b> - Added update for Google Opening Soon (BIRD-56987)


      * <b>06/25/2024</b> - Updated Listings Insights API (BIRDEYE-137367)


      * <b>05/29/2024</b> - Added Google Q&A Developers API Section


      * <b>05/13/2024</b> - Added epoc date support for GetReviews APIs.


      * <b>03/22/2024</b> - Add Update Hierarchy API (BIRD-32609)


      * <b>03/19/2024</b> - Added Ticket APIs Create, Get, Update APIs under
      Ticket module


      * <b>02/26/2024</b> - Updated logoUrl description in Get, Update APIs
      under Business module and Create, Get, Update APIs under Listing module
      (BIRD-29386)


      * <b>12/21/2023</b> - Add listing phase 2 api changes (BIRD-16589)


      * <b>11/08/2023</b> - Add survey changes (BIRD-11944) and listing changes
      (BIRD-14345)


      * <b>11/08/2023</b> - Added CRUD APIs for Apple chat


      * <b>10/15/2023</b> - Added CRUD APIs for Business Media.


      * <b>10/11/2023</b> - Added new APIs under Listing module, Create, Update,
      Get, Deactive Listings


      * <b>09/18/2023</b> - Added new API under Contact module i.e, Get opt-out
      contact data


      * <b>08/25/2023</b> - Added new APIs under Business and Listing modules,
      Get Category List API, Get GMB Attributes API & Get Timezone List


      * <b>07/21/2023</b> - Added new API under Business module i.e, Business
      Search API.


      * <b>06/30/2023</b> - Added support for service area based information in
      Get Business API and Update Business API.


      * <b>10/04/2024</b> - Added support to fetch ticketId associated with the
      survey responses in List Response API.
paths:
  /v1/reports/smb:
    get:
      tags:
        - Report
      summary: Get Dashboard data
      operationId: getDashboardData
      parameters:
        - name: bid
          in: query
          description: Id of the Business.
          required: true
          example: '12345678'
          schema:
            type: string
        - name: Accept
          in: header
          description: e.g. application/json
          required: false
          example: application/json
          schema:
            type: string
        - name: x-api-key
          in: header
          description: >-
            e.g. [Required] Partner specific API key provided by Birdeye for
            data exchange.
          required: false
          example: >-
            [Required] Partner specific API key provided by Birdeye for data
            exchange.
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  allTime:
                    type: object
                    properties:
                      avgRating:
                        type: object
                        properties:
                          percentChange:
                            type: number
                          rating:
                            type: number
                      benchmark:
                        type: object
                        properties:
                          industryRating:
                            type: number
                          industryReviewCount:
                            type: number
                          percentChange:
                            type: number
                          rating:
                            type: number
                      custCommn:
                        type: object
                        properties: {}
                      reviewCount:
                        type: object
                        properties:
                          count:
                            type: number
                          percentChange:
                            type: number
                      sentiments:
                        type: object
                        properties:
                          negative:
                            type: number
                          neutral:
                            type: number
                          positive:
                            type: number
                      visitors:
                        type: object
                        properties: {}
                  last30Days:
                    type: object
                    properties:
                      avgRating:
                        type: object
                        properties:
                          rating:
                            type: number
                      benchmark:
                        type: object
                        properties:
                          industryRating:
                            type: number
                          industryReviewCount:
                            type: number
                          percentChange:
                            type: number
                          rating:
                            type: number
                      custCommn:
                        type: object
                        properties:
                          reviewRequest:
                            type: number
                          reviewRequestSms:
                            type: number
                          shareReview:
                            type: number
                      reviewCount:
                        type: object
                        properties:
                          count:
                            type: number
                          percentChange:
                            type: number
                      sentiments:
                        type: object
                        properties:
                          negative:
                            type: number
                          neutral:
                            type: number
                          positive:
                            type: number
                      visitors:
                        type: object
                        properties: {}
                  negativeReviews:
                    type: array
                    items:
                      type: object
                      properties:
                        comments:
                          type: string
                        rating:
                          type: number
                        response:
                          type: string
                        reviewDate:
                          type: string
                        reviewId:
                          type: string
                        reviewUrl:
                          type: string
                        reviewer:
                          type: object
                          properties:
                            city:
                              type: string
                            nickName:
                              type: string
                            state:
                              type: string
                            thumbnailUrl:
                              type: string
                        sourceType:
                          type: string
                      required:
                        - comments
                        - rating
                        - response
                        - reviewDate
                        - reviewId
                        - reviewUrl
                        - reviewer
                        - sourceType
                  positiveReviews:
                    type: array
                    items:
                      type: object
                      properties:
                        comments:
                          type: string
                        rating:
                          type: number
                        response:
                          type: string
                        reviewDate:
                          type: string
                        reviewId:
                          type: string
                        reviewUrl:
                          type: string
                        reviewer:
                          type: object
                          properties:
                            city:
                              type: string
                            nickName:
                              type: string
                            state:
                              type: string
                            thumbnailUrl:
                              type: string
                        sourceType:
                          type: string
                      required:
                        - comments
                        - rating
                        - response
                        - reviewDate
                        - reviewId
                        - reviewUrl
                        - reviewer
                        - sourceType
                  syndication:
                    type: object
                    properties:
                      presenceCount:
                        type: number
                      reviewDistribution:
                        type: array
                        items:
                          type: object
                          properties:
                            count:
                              type: number
                            name:
                              type: string
                          required:
                            - count
                            - name
                      reviewListings:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: number
                            name:
                              type: string
                            url:
                              type: string
                          required:
                            - id
                            - name
                            - url
                example:
                  allTime:
                    avgRating:
                      percentChange: 0
                      rating: 4.3
                    benchmark:
                      industryRating: 4.1
                      industryReviewCount: 75785
                      percentChange: 4
                      rating: 4.3
                    custCommn: {}
                    reviewCount:
                      count: 376
                      percentChange: 0
                    sentiments:
                      negative: 45
                      neutral: 36
                      positive: 295
                    visitors: {}
                  last30Days:
                    avgRating:
                      rating: 0
                    benchmark:
                      industryRating: 0
                      industryReviewCount: 0
                      percentChange: 0
                      rating: 0
                    custCommn:
                      reviewRequest: 0
                      reviewRequestSms: 0
                      shareReview: 0
                    reviewCount:
                      count: 0
                      percentChange: 0
                    sentiments:
                      negative: 0
                      neutral: 0
                      positive: 0
                    visitors: {}
                  negativeReviews:
                    - comments: >-
                        One word...inconsistent. We had high hopes for this
                        place but alas it was not to be. While the servers were
                        polite, they lacked the professionalism normally
                        expected at most dining establishments...you know,
                        simple things like the waiter introducing himself by
                        name or dropping by to see how we liked the food or
                        refilling our drinks. The minestrone soup was pretty
                        good but the fried calamari was bland, rubbery,
                        obviously over cooked, and did I mention bland. The
                        linguini pescatora was also inconsistent. The pasta in
                        the dish was excellent but the calamari was once again
                        over cooked and rubbery, I got a couple of clams that
                        were not cleaned resulting in a few mouthfuls of dirt,
                        and the shrimp was once again over cooked. We also
                        ordered the margherita pizza with mushrooms and that was
                        pretty good. Overall, we cannot recommend this place.
                      rating: 1
                      response: ''
                      reviewDate: Jan 30, 2015
                      reviewId: '2335311245464'
                      reviewUrl: >-
                        http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=60fLFX4lRvHnodkhoWC2lw&nb=1
                      reviewer:
                        city: Yorba Linda
                        nickName: wendy w.
                        state: CA
                        thumbnailUrl: >-
                          http://d2xt3xymj142xp.cloudfront.net/reviewer/9a070cf98f014f5d9b06987dcc9c48fe.jpeg
                      sourceType: citysearch
                    - comments: >-
                        Veal Scaloppini, mushrooms, marsala wine, seasonal
                        vegetables and potatoes $24.

                        Flavor was great but disappointed in portion 2 small
                        thin slice, I had better portion in North Beach...my
                        shoe sole was large than this portion. I'm petite size
                        woman; still left hungry....not a hungry man plate.
                        Don't waste your money on this one, men.
                      rating: 2
                      response: ''
                      reviewDate: Jan 26, 2015
                      reviewId: '2335208845791'
                      reviewUrl: >-
                        http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=FKcQE7naP_Wb4D2ylDsLaQ&nb=1
                      reviewer:
                        city: San Francisco
                        nickName: Catalina W.
                        state: CA
                        thumbnailUrl: >-
                          http://d2xt3xymj142xp.cloudfront.net/reviewer/9a070cf98f014f5d9b06987dcc9c48fe.jpeg
                      sourceType: citysearch
                    - comments: >-
                        I have to say that this restaurant is very nice but very
                        Loud!:( The bread was old:( The prosciutto appetizer was
                        ridiculous! They only used one slice on six slices of
                        bread:( My husband's main course of the Veal Scallopini
                        was a complete shame! Great sauce but come on! 4 very
                        thin slices of veal w/veggies & red potatoes, he was
                        starving when we got home!:( At $24!!! Ridiculously
                        stingy! My lamb shank & mashed potatoes was superb! No
                        veggies though:( $19 We won't be returning, I was not
                        impressed, I'd rather go to North Beach w/ real Italian
                        dining:) they do have good food but they need to step it
                        up a notch for the prices they charge, I hope they read
                        they're review's so they can change things, Good luck
                      rating: 2
                      response: ''
                      reviewDate: Jan 26, 2015
                      reviewId: '2337522245554'
                      reviewUrl: >-
                        http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=Xn9XOjZYNknHQu5eF9MteQ&nb=1
                      reviewer:
                        city: San Francisco
                        nickName: Adele R.
                        state: CA
                      sourceType: citysearch
                  positiveReviews:
                    - comments: >-
                        Service is awesome- everyone is from Italy and are so
                        sweet and low the menu/specials from head to toe. Great
                        wine selection that's pretty reasonable. The Bruschetta
                        varieties are unique and yummy. Sometimes main dishes
                        can be hit or miss-not very consistent but it's a new
                        restaurant that I can see establish itself a few great
                        dishes overtime.
                      rating: 4
                      response: ''
                      reviewDate: Jan 23, 2015
                      reviewId: '2334445645625'
                      reviewUrl: >-
                        http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=YYtOE3hvBjp4jYtLgtgBoQ&nb=1
                      reviewer:
                        city: San Francisco
                        nickName: Anastasia P.
                        state: CA
                        thumbnailUrl: >-
                          http://d2xt3xymj142xp.cloudfront.net/reviewer/9a070cf98f014f5d9b06987dcc9c48fe.jpeg
                      sourceType: citysearch
                    - comments: >-
                        I've been here 3 times in the past year, & it's been
                        good every time.
                      rating: 4
                      response: ''
                      reviewDate: Jan 23, 2015
                      reviewId: '2333514245697'
                      reviewUrl: >-
                        http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=3kiZtC-tj-FGLO3GPRqNDA&nb=1
                      reviewer:
                        city: Daly City
                        nickName: Matt L.
                        state: CA
                      sourceType: Citysearch
                    - comments: >-
                        Owner is awesome! ! Came here tonight with my parents
                        and sister's family. .highly recommended! ! I will
                        definitely come back here again!
                      rating: 5
                      response: ''
                      reviewDate: Jan 21, 2015
                      reviewId: '2336865297689'
                      reviewUrl: >-
                        http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=U8mRtt5vA93l0n7j2H1J_w&nb=1
                      reviewer:
                        city: San Francisco
                        nickName: Johnny C.
                        state: CA
                        thumbnailUrl: >-
                          http://d2xt3xymj142xp.cloudfront.net/reviewer/9a070cf98f014f5d9b06987dcc9c48fe.jpeg
                      sourceType: Citysearch
                  syndication:
                    presenceCount: 0
                    reviewDistribution:
                      - count: 328
                        name: citysearch
                      - count: 8
                        name: Google
                      - count: 1
                        name: Yellow Pages
                      - count: 16
                        name: Foursquare
                      - count: 23
                        name: Facebook
                    reviewListings:
                      - id: 2
                        name: Google
                        url: >-
                          https://plus.google.com/112610500708977805079/about?gl=US&hl=en-US
                      - id: 3
                        name: Citysearch
                        url: >-
                          http://www.citysearch.com/biz/maria-da-vittorio-san-francisco
                      - id: 4
                        name: Yahoo! Local
                        url: >-
                          https://local.yahoo.com/info-148859369-maria-da-vittorio-san-francisco
                      - id: 5
                        name: Yellow Pages
                        url: >-
                          http://www.yellowpages.com/san-francisco-ca/mip/maria-da-vittorio-478366944
                      - id: 10
                        name: Foursquare
                        url: >-
                          https://foursquare.com/v/maria-da-vittorio/5195394d498e344eeb952b4f
                      - id: 16
                        name: Superpages
                        url: >-
                          http://www.superpages.com/bp/San-Francisco-CA/maria-Da-Vittorio-L2450131113.htm
                      - id: 33
                        name: Merchant Circle
                        url: >-
                          http://www.merchantcircle.com/business/maria.Da.Vittorio.415-592-8398
                      - id: 63
                        name: YellowBot
                        url: >-
                          http://www.yellowbot.com/maria-da-vittorio-san-francisco-ca.html
                      - id: 84
                        name: MapQuest
                        url: >-
                          http://www.mapquest.com/us/california/italian-restaurants-san-francisco/maria-da-vittorio-284984723
                      - id: 110
                        name: Facebook
                        url: https://www.facebook.com/mariadavittorio
              examples:
                response:
                  value:
                    allTime:
                      avgRating:
                        percentChange: 0
                        rating: 4.3
                      benchmark:
                        industryRating: 4.1
                        industryReviewCount: 75785
                        percentChange: 4
                        rating: 4.3
                      custCommn: {}
                      reviewCount:
                        count: 376
                        percentChange: 0
                      sentiments:
                        negative: 45
                        neutral: 36
                        positive: 295
                      visitors: {}
                    last30Days:
                      avgRating:
                        rating: 0
                      benchmark:
                        industryRating: 0
                        industryReviewCount: 0
                        percentChange: 0
                        rating: 0
                      custCommn:
                        reviewRequest: 0
                        reviewRequestSms: 0
                        shareReview: 0
                      reviewCount:
                        count: 0
                        percentChange: 0
                      sentiments:
                        negative: 0
                        neutral: 0
                        positive: 0
                      visitors: {}
                    negativeReviews:
                      - comments: >-
                          One word...inconsistent. We had high hopes for this
                          place but alas it was not to be. While the servers
                          were polite, they lacked the professionalism normally
                          expected at most dining establishments...you know,
                          simple things like the waiter introducing himself by
                          name or dropping by to see how we liked the food or
                          refilling our drinks. The minestrone soup was pretty
                          good but the fried calamari was bland, rubbery,
                          obviously over cooked, and did I mention bland. The
                          linguini pescatora was also inconsistent. The pasta in
                          the dish was excellent but the calamari was once again
                          over cooked and rubbery, I got a couple of clams that
                          were not cleaned resulting in a few mouthfuls of dirt,
                          and the shrimp was once again over cooked. We also
                          ordered the margherita pizza with mushrooms and that
                          was pretty good. Overall, we cannot recommend this
                          place.
                        rating: 1
                        response: ''
                        reviewDate: Jan 30, 2015
                        reviewId: '2335311245464'
                        reviewUrl: >-
                          http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=60fLFX4lRvHnodkhoWC2lw&nb=1
                        reviewer:
                          city: Yorba Linda
                          nickName: wendy w.
                          state: CA
                          thumbnailUrl: >-
                            http://d2xt3xymj142xp.cloudfront.net/reviewer/9a070cf98f014f5d9b06987dcc9c48fe.jpeg
                        sourceType: citysearch
                      - comments: >-
                          Veal Scaloppini, mushrooms, marsala wine, seasonal
                          vegetables and potatoes $24.

                          Flavor was great but disappointed in portion 2 small
                          thin slice, I had better portion in North Beach...my
                          shoe sole was large than this portion. I'm petite size
                          woman; still left hungry....not a hungry man plate.
                          Don't waste your money on this one, men.
                        rating: 2
                        response: ''
                        reviewDate: Jan 26, 2015
                        reviewId: '2335208845791'
                        reviewUrl: >-
                          http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=FKcQE7naP_Wb4D2ylDsLaQ&nb=1
                        reviewer:
                          city: San Francisco
                          nickName: Catalina W.
                          state: CA
                          thumbnailUrl: >-
                            http://d2xt3xymj142xp.cloudfront.net/reviewer/9a070cf98f014f5d9b06987dcc9c48fe.jpeg
                        sourceType: citysearch
                      - comments: >-
                          I have to say that this restaurant is very nice but
                          very Loud!:( The bread was old:( The prosciutto
                          appetizer was ridiculous! They only used one slice on
                          six slices of bread:( My husband's main course of the
                          Veal Scallopini was a complete shame! Great sauce but
                          come on! 4 very thin slices of veal w/veggies & red
                          potatoes, he was starving when we got home!:( At
                          $24!!! Ridiculously stingy! My lamb shank & mashed
                          potatoes was superb! No veggies though:( $19 We won't
                          be returning, I was not impressed, I'd rather go to
                          North Beach w/ real Italian dining:) they do have good
                          food but they need to step it up a notch for the
                          prices they charge, I hope they read they're review's
                          so they can change things, Good luck
                        rating: 2
                        response: ''
                        reviewDate: Jan 26, 2015
                        reviewId: '2337522245554'
                        reviewUrl: >-
                          http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=Xn9XOjZYNknHQu5eF9MteQ&nb=1
                        reviewer:
                          city: San Francisco
                          nickName: Adele R.
                          state: CA
                        sourceType: citysearch
                    positiveReviews:
                      - comments: >-
                          Service is awesome- everyone is from Italy and are so
                          sweet and low the menu/specials from head to toe.
                          Great wine selection that's pretty reasonable. The
                          Bruschetta varieties are unique and yummy. Sometimes
                          main dishes can be hit or miss-not very consistent but
                          it's a new restaurant that I can see establish itself
                          a few great dishes overtime.
                        rating: 4
                        response: ''
                        reviewDate: Jan 23, 2015
                        reviewId: '2334445645625'
                        reviewUrl: >-
                          http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=YYtOE3hvBjp4jYtLgtgBoQ&nb=1
                        reviewer:
                          city: San Francisco
                          nickName: Anastasia P.
                          state: CA
                          thumbnailUrl: >-
                            http://d2xt3xymj142xp.cloudfront.net/reviewer/9a070cf98f014f5d9b06987dcc9c48fe.jpeg
                        sourceType: citysearch
                      - comments: >-
                          I've been here 3 times in the past year, & it's been
                          good every time.
                        rating: 4
                        response: ''
                        reviewDate: Jan 23, 2015
                        reviewId: '2333514245697'
                        reviewUrl: >-
                          http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=3kiZtC-tj-FGLO3GPRqNDA&nb=1
                        reviewer:
                          city: Daly City
                          nickName: Matt L.
                          state: CA
                        sourceType: Citysearch
                      - comments: >-
                          Owner is awesome! ! Came here tonight with my parents
                          and sister's family. .highly recommended! ! I will
                          definitely come back here again!
                        rating: 5
                        response: ''
                        reviewDate: Jan 21, 2015
                        reviewId: '2336865297689'
                        reviewUrl: >-
                          http://www.citysearch.com/biz/maria-da-vittorio-san-francisco?hrid=U8mRtt5vA93l0n7j2H1J_w&nb=1
                        reviewer:
                          city: San Francisco
                          nickName: Johnny C.
                          state: CA
                          thumbnailUrl: >-
                            http://d2xt3xymj142xp.cloudfront.net/reviewer/9a070cf98f014f5d9b06987dcc9c48fe.jpeg
                        sourceType: Citysearch
                    syndication:
                      presenceCount: 0
                      reviewDistribution:
                        - count: 328
                          name: citysearch
                        - count: 8
                          name: Google
                        - count: 1
                          name: Yellow Pages
                        - count: 16
                          name: Foursquare
                        - count: 23
                          name: Facebook
                      reviewListings:
                        - id: 2
                          name: Google
                          url: >-
                            https://plus.google.com/112610500708977805079/about?gl=US&hl=en-US
                        - id: 3
                          name: Citysearch
                          url: >-
                            http://www.citysearch.com/biz/maria-da-vittorio-san-francisco
                        - id: 4
                          name: Yahoo! Local
                          url: >-
                            https://local.yahoo.com/info-148859369-maria-da-vittorio-san-francisco
                        - id: 5
                          name: Yellow Pages
                          url: >-
                            http://www.yellowpages.com/san-francisco-ca/mip/maria-da-vittorio-478366944
                        - id: 10
                          name: Foursquare
                          url: >-
                            https://foursquare.com/v/maria-da-vittorio/5195394d498e344eeb952b4f
                        - id: 16
                          name: Superpages
                          url: >-
                            http://www.superpages.com/bp/San-Francisco-CA/maria-Da-Vittorio-L2450131113.htm
                        - id: 33
                          name: Merchant Circle
                          url: >-
                            http://www.merchantcircle.com/business/maria.Da.Vittorio.415-592-8398
                        - id: 63
                          name: YellowBot
                          url: >-
                            http://www.yellowbot.com/maria-da-vittorio-san-francisco-ca.html
                        - id: 84
                          name: MapQuest
                          url: >-
                            http://www.mapquest.com/us/california/italian-restaurants-san-francisco/maria-da-vittorio-284984723
                        - id: 110
                          name: Facebook
                          url: https://www.facebook.com/mariadavittorio
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/1161Model'
              examples:
                response:
                  value:
                    code: 1161
                    message: Invalid API key
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/1011Model'
              examples:
                response:
                  value:
                    code: 1011
                    message: Business id is invalid
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/89Model'
              examples:
                response:
                  value:
                    code: 89
                    message: Rate limit exceeded
components:
  schemas:
    1161Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 1161
        message: Invalid API key
    1011Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 1011
        message: Business id is invalid
    89Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 89
        message: Rate limit exceeded

````