> ## Documentation Index
> Fetch the complete documentation index at: https://docs.birdeye.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard

> Get Dashboard Data API gives you an overview of business data with data points like review & rating count, sentiment of reviews, negative/positive reviews, and past 30 days' reviews with review responses.



## OpenAPI

````yaml api/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
      description: >-
        Get Dashboard Data API gives you an overview of business data with data
        points like review & rating count, sentiment of reviews,
        negative/positive reviews, and past 30 days' reviews with review
        responses.
      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
            default: application/json
        - 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
              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
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/1167Model'
              x-apiary-response-models:
                - $ref: '#/components/schemas/1167Model'
                - $ref: '#/components/schemas/1161Model'
              x-apiary-response-examples:
                error_1167:
                  value:
                    code: 1167
                    message: API key is missing
                error_1161:
                  value:
                    code: 1161
                    message: Invalid API key
              examples:
                response:
                  value:
                    code: 1167
                    message: API key is missing
        '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:
    1167Model:
      type: object
      properties:
        code:
          type: number
        message:
          type: string
      example:
        code: 1167
        message: API key is missing
    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

````