---
openapi: 3.1.0
info:
  title: Apple App Store Search — 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
      summary: Apple App Store Search
      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
      - 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: term
        in: query
        required: true
        description: Search term for the App Store.
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: App Store country (two-letter code).
        schema:
          type: string
          default: us
      - name: lang
        in: query
        required: false
        description: Language of the results.
        schema:
          type: string
      - name: device
        in: query
        required: false
        description: Device the results are listed for.
        schema:
          type: string
          enum:
          - iphone
          - ipad
      - name: page
        in: query
        required: false
        description: Page number of the results.
        schema:
          type: integer
          default: 1
      - name: num
        in: query
        required: false
        description: Number of results per page.
        schema:
          type: integer
      responses:
        '200':
          description: A Apple App Store Search result envelope.
