App Store Keyword Search (US, English, Top 100 Apps)

{
  "type": "object",
  "required": [
    "keyword",
    "location_code",
    "language_code",
    "depth"
  ],
  "properties": {
    "depth": {
      "enum": [
        100
      ],
      "type": "integer",
      "default": 100,
      "description": "The number of results to collect; only 100 is offered."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "The search term, as a user would type it in the App Store."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The results language; only en (English) is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The store searched; only 2840 (United States) is offered."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string",
                  "description": "The app's name."
                },
                "app_id": {
                  "type": "string",
                  "description": "The app's numeric Apple ID."
                },
                "rating": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Average star rating, 0 to 5; null when the store shows none."
                    },
                    "votes_count": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Number of ratings; null when the store shows none."
                    }
                  }
                },
                "rank_absolute": {
                  "type": "number",
                  "description": "The app's rank, from 1."
                }
              }
            },
            "description": "The apps, in rank order."
          },
          "keyword": {
            "type": "string",
            "description": "The search term, as sent."
          },
          "datetime": {
            "type": "string",
            "description": "When the results were retrieved (UTC)."
          },
          "items_count": {
            "type": "number",
            "description": "The number of entries in items."
          },
          "se_results_count": {
            "type": "number",
            "description": "The total number of results the store reported for the term."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}