---
openapi: 3.1.0
info:
  title: Apple App Store Top Charts — SearchApi
  version: 3.1.0
  description: Generated from the SearchApi engine catalog. Parameters marked in the
    catalog as unverified are described from its records rather than from the vendor's
    specification.
servers:
- url: https://www.searchapi.io/api/v1
paths:
  "/search":
    get:
      operationId: apple_app_store_top_charts
      summary: Apple App Store Top Charts
      parameters:
      - name: engine
        in: query
        required: true
        description: Engine that retrieves the data; fixed per API (see Apis::BY_ENGINE
          keys).
        schema:
          type: string
          const: apple_app_store_top_charts
      - name: api_key
        in: query
        required: true
        description: 'SearchApi.io API key; alternatively send ''Authorization: Bearer
          <key>''.'
        schema:
          type: string
      - name: zero_retention
        in: query
        required: false
        description: 'Enterprise-only: disables all logging and persistent storage
          of the search.'
        schema:
          type: boolean
          default: false
      - name: chart
        in: query
        required: false
        description: Chart to fetch.
        schema:
          type: string
          enum:
          - top_free
          - top_paid
      - name: category
        in: query
        required: false
        description: App category filter.
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: App Store country (two-letter code).
        schema:
          type: string
          default: us
      - name: device
        in: query
        required: false
        description: Device the chart is listed for.
        schema:
          type: string
          enum:
          - iphone
          - ipad
      responses:
        '200':
          description: A Apple App Store Top Charts result envelope.
