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

> ## Agent Instructions
> Quiver Quantitative API: base URL https://api.quiverquant.com, endpoints under /beta/. Authenticate every request with the header `Authorization: Bearer <API key>`. Keys are on https://api.quiverquant.com/dashboard/ after subscribing at https://api.quiverquant.com/pricing/.
> AI agents can use the Quiver MCP server at https://mcp.quiverquant.com/ (streamable HTTP; OAuth sign-in, or the API key as a Bearer token). Setup: https://api.quiverquant.com/docs/mcp-server.
> Each dataset needs a plan (https://api.quiverquant.com/docs/plans-and-access) and each endpoint has a per-account rate limit (https://api.quiverquant.com/docs/rate-limits).

# App Ratings

> Returns the last week of app ratings data.

**Plan:** Trader or above. A Hobbyist plan gets a `403` from this endpoint. See [Plans and data access](/docs/plans-and-access.md).


## OpenAPI

````yaml /openapi.json get /beta/live/appratings
openapi: 3.0.3
info:
  title: Quiver API
  version: v1
  description: Tap into the power of alternative data
  contact:
    name: 'Us: info@quiverquant.com'
    email: info@quiverquant.com
  license:
    name: Terms of Service
    url: https://www.quiverquant.com/termsofservice/
servers:
  - url: https://api.quiverquant.com
security: []
tags:
  - name: Congress
    description: Stock trades, holdings and profiles of members of Congress.
  - name: Trump trades
    description: Stock trades by Donald Trump.
  - name: Insiders and institutions
    description: Insider trades, 13F holdings, shareholders and executive pay.
  - name: Government contracts
    description: Federal contracts awarded to public companies.
  - name: Lobbying and donations
    description: Corporate lobbying, revolving door lobbyists and PAC donations.
  - name: Market data
    description: Daily prices, off-exchange trading and Polymarket trades.
  - name: Patents
    description: Patents granted to public companies, and patent-based signals.
  - name: Company data
    description: Layoff notices, app ratings and the Quiver newsfeed.
  - name: New Constructs
    description: New Constructs ratings, a separate subscription.
paths:
  /beta/live/appratings:
    get:
      tags:
        - Company data
      summary: App Ratings
      description: Returns the last week of app ratings data.
      operationId: live_appratings_retrieve
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppRatingResponse'
          description: ''
      security:
        - WebPlatformTokenAuth: []
components:
  schemas:
    AppRatingResponse:
      title: AppRatingResponse
      description: JSON Response structure for app rating endpoint.
      type: array
      items:
        $ref: '#/components/schemas/AppRating'
    AppRating:
      title: AppRating
      description: Base pydantic model used to hold standard config.
      type: object
      properties:
        Ticker:
          title: Ticker
          description: Company ticker of app's publisher
          type: string
        App:
          title: App
          description: App's title
          type: string
        Created:
          title: Created
          description: Initial publication date of app
          type: string
          format: date-time
        Publisher:
          title: Publisher
          description: Full name of app's publisher
          type: string
        Rating:
          title: Rating
          description: Average rating (on a 0-5 scale) of app
          type: number
        Count:
          title: Count
          description: Total number of reviews of app
          type: integer
        Time:
          title: Time
          description: Time that this row of ratings data was scraped
          type: string
          format: date-time
      required:
        - Ticker
        - App
        - Created
        - Publisher
        - Rating
        - Count
        - Time
  securitySchemes:
    WebPlatformTokenAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.