get:
  tags:
    - All Resources
    - Artists
  summary: 'Query for Spotify popularity'
  operationId: popularity.search
  description: >-
    Resource route for getting a list of `Popularity`
    with filtering based on provided parameters. At least one of the identifying keys is
    required in the request: `artist_id` / `product_id` / `track_id` or `isrc`.
  security:
    - bearerAuth: []
  parameters:
    - $ref: '../parameters/start_date.yaml'
    - $ref: '../parameters/end_date.yaml'
    - $ref: '../parameters/artist_id_query_required.yaml'
    - $ref: '../parameters/group_by_field.yaml'
    - $ref: '../parameters/limit_range.yaml'
    - $ref: '../parameters/cursor.yaml'
    - $ref: '../parameters/bigtable_limit.yaml'
    - $ref: '../parameters/offset.yaml'
    - $ref: '../parameters/sort_by_popularity.yaml'
    - $ref: '../parameters/sort_order.yaml'
  responses:
    200:
      $ref: '../responses/PopularityResponse.yaml'
    400:
      $ref: '../responses/InvalidInput.yaml'
    401:
      $ref: '../responses/Unauthorized.yaml'
    500:
      $ref: '../responses/InternalError.yaml'