get:
  tags:
    - All Resources
    - Apple Music
    - Charts
    - Tracks
  summary: 'Get metadata about Apple Music Tracks'
  operationId: apple.music.charts.tracks.search
  description: |
    The endpoint is used to search the tracks in the specific Apple Music chart and for the specific date. This is useful if you want to display chart states (whole or partial).
    This endpoint supports additional filtering by the track_id and isrc parameters.
    If no date is provided - the endpoint will return the data for the latest available date.
  security:
    - bearerAuth: []
  parameters:
    - $ref: '../parameters/apple_chart_id_required.yaml'
    - $ref: '../parameters/chart_date.yaml'
    - $ref: '../parameters/apple_chart_track_state_includes_array.yaml'
    - $ref: '../parameters/chart_track_metrics_dimension.yaml'
    - $ref: '../parameters/apple_track_id_array.yaml'
    - $ref: '../parameters/isrc_array.yaml'
    - $ref: '../parameters/min_position.yaml'
    - $ref: '../parameters/max_position.yaml'

  responses:
    200:
      $ref: '../responses/AppleMusicChartTrackStatesResponse.yaml'
    400:
      $ref: '../responses/InvalidInput.yaml'
    401:
      $ref: '../responses/Unauthorized.yaml'
    500:
      $ref: '../responses/InternalError.yaml'