{
  "openapi": "3.0.1",
  "info": {
    "title": "Apple App Store Scraper: App Details and Search | $1/1K",
    "description": "$1 per 1,000 results, platform usage included. Apple App Store apps by search term, app ID or developer: name, price, rating, rating count, genre, size, version, release dates, description and screenshots, for any country. Public iTunes Search API.",
    "version": "0.1",
    "x-build-id": "u7L4dypahmtdBVaPK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/one_dollar_store~app-store-apps-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-one_dollar_store-app-store-apps-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/one_dollar_store~app-store-apps-scraper/runs": {
      "post": {
        "operationId": "runs-sync-one_dollar_store-app-store-apps-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/one_dollar_store~app-store-apps-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-one_dollar_store-app-store-apps-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Words to search for in the App Store, one per line. Each term returns up to the number set under results per search, in the order the App Store ranks them.",
            "items": {
              "type": "string"
            }
          },
          "appIds": {
            "title": "App IDs or links",
            "type": "array",
            "description": "Apps to fetch directly: a numeric ID (284882215) or an App Store link such as https://apps.apple.com/us/app/facebook/id284882215. Many IDs are fetched in batches.",
            "items": {
              "type": "string"
            }
          },
          "developerIds": {
            "title": "Developer IDs or links",
            "type": "array",
            "description": "Returns every app of a developer. Use the numeric ID (389801252) or a developer link such as https://apps.apple.com/us/developer/instagram-inc/id389801252.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country (App Store)",
            "enum": [
              "us",
              "gb",
              "ca",
              "au",
              "nz",
              "ie",
              "in",
              "de",
              "fr",
              "es",
              "it",
              "nl",
              "be",
              "at",
              "ch",
              "se",
              "no",
              "dk",
              "fi",
              "pl",
              "cz",
              "hu",
              "ro",
              "gr",
              "pt",
              "tr",
              "ru",
              "ua",
              "il",
              "sa",
              "ae",
              "eg",
              "za",
              "ng",
              "ke",
              "jp",
              "kr",
              "cn",
              "hk",
              "tw",
              "sg",
              "my",
              "th",
              "id",
              "vn",
              "ph",
              "pk",
              "bd",
              "lk",
              "br",
              "mx",
              "ar",
              "cl",
              "co",
              "pe"
            ],
            "type": "string",
            "description": "Which country's App Store to read. It sets prices, currency, rankings and which apps exist.",
            "default": "us"
          },
          "language": {
            "title": "Language",
            "enum": [
              "en_us",
              "ja_jp"
            ],
            "type": "string",
            "description": "Language of the text the App Store sends back, where an app has translations. Apple documents English and Japanese.",
            "default": "en_us"
          },
          "device": {
            "title": "Kind of app",
            "enum": [
              "software",
              "iPadSoftware",
              "macSoftware"
            ],
            "type": "string",
            "description": "iPhone apps, iPad apps or Mac apps. Applies to search terms and developer IDs.",
            "default": "software"
          },
          "genres": {
            "title": "Only these genres",
            "type": "array",
            "description": "Optional. Keep only apps in these genres, by name (Games, Productivity, Photo & Video, Finance, Health & Fitness) or by genre ID (6014). An app matches on its main genre or any of its genres.",
            "items": {
              "type": "string"
            }
          },
          "priceType": {
            "title": "Free or paid",
            "enum": [
              "any",
              "free",
              "paid"
            ],
            "type": "string",
            "description": "Optional. Keep only free apps or only paid apps. A paid app is one with a price above zero; in-app purchases are not counted.",
            "default": "any"
          },
          "minPrice": {
            "title": "Lowest price",
            "minimum": 0,
            "type": "number",
            "description": "Optional. Keep apps priced at or above this amount, in the currency of the chosen country."
          },
          "maxPrice": {
            "title": "Highest price",
            "minimum": 0,
            "type": "number",
            "description": "Optional. Keep apps priced at or below this amount, in the currency of the chosen country."
          },
          "minRating": {
            "title": "Lowest average rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Optional. Keep apps whose average user rating is at least this value (0 to 5). Apps with no rating yet are dropped when this is set."
          },
          "maxResultsPerSearch": {
            "title": "Results per search term",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "The most apps to take for each search term or developer (the App Store gives at most 200). Filters are applied after the App Store answers, so a filtered search can return fewer.",
            "default": 50
          },
          "maxItems": {
            "title": "Maximum results",
            "minimum": 10,
            "maximum": 100000,
            "type": "integer",
            "description": "The run stops after this many apps in total. Minimum 10.",
            "default": 500
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}