get:
  tags:
    - All Resources
    - Apple Music
    - Charts
  summary: 'Get metadata about Apple Music Charts'
  operationId: apple.music.charts.search
  description: |
    The endpoint is used to find chart ids based on the specific country codes, chart types, and breakdowns or select the chart metadata for the specific charts.
    This is useful when you want to identify specific chart ids (to use in other endpoints) but can provide broader filters like country_code or chart rank.$apple_music
    Either chart_id or country_code should be provided.
  security:
    - bearerAuth: []
  parameters:
    - $ref: '../parameters/apple_chart_id_array.yaml'
    - $ref: '../parameters/country_code_array.yaml'
    - $ref: '../parameters/min_rank.yaml'
    - $ref: '../parameters/max_rank.yaml'
  responses:
    200:
      $ref: '../responses/AppleMusicChartsResponse.yaml'
    400:
      $ref: '../responses/InvalidInput.yaml'
    401:
      $ref: '../responses/Unauthorized.yaml'
    500:
      $ref: '../responses/InternalError.yaml'