{ "openapi": "3.1.0", "info": { "title": "APK API", "version": "1.0.0", "description": "Google Play data API: 4 million apps (live and removed), developers, new releases, removals and title keywords. JSON, UTF-8, CORS enabled.\n\nEvery call costs 0–3 credits regardless of the number of rows (up to 100); /apps costs 1 credit per app. Plan credits are used first, then the prepaid balance; if a request fails on our side, the credits are returned. Remaining credits are in the `_credits` field of every response.\n\nDocumentation: https://apkapi.com/api-docs.php", "contact": { "url": "https://apkapi.com/api-docs.php" }, "termsOfService": "https://apkapi.com/legal/terms.php" }, "servers": [ { "url": "https://apkapi.com/api/v1" } ], "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "tags": [ { "name": "Apps" }, { "name": "Entwickler" }, { "name": "Änderungen im Store" }, { "name": "Markt" } ], "paths": { "/account": { "get": { "operationId": "account", "tags": [ "Account" ], "summary": "Your plan, plan credits and balance, the credit reset date and the per-minute limit.", "description": "Free: no credits are charged.", "responses": { "200": { "$ref": "#/components/responses/Ok" }, "401": { "$ref": "#/components/responses/Error" } } } }, "/app": { "get": { "operationId": "app", "tags": [ "Apps" ], "summary": "Der vollständige App-Eintrag: Titel, Beschreibung, Neuigkeiten, Installationen (Schwelle und genaue Zahl), Bewertung, Anzahl der Bewertungen und Rezensionen, Sterneverteilung, Preis, In-App-Käufe, Werbung, Kategorie, Altersfreigabe, Version, minimales Android, Veröffentlichungs- und Update-Datum, Icon, Screenshots, Video, Entwickler und seine Website. Bei entfernten Apps: die zuletzt gespeicherten Daten und das Entfernungsdatum.", "description": "Der vollständige App-Eintrag: Titel, Beschreibung, Neuigkeiten, Installationen (Schwelle und genaue Zahl), Bewertung, Anzahl der Bewertungen und Rezensionen, Sterneverteilung, Preis, In-App-Käufe, Werbung, Kategorie, Altersfreigabe, Version, minimales Android, Veröffentlichungs- und Update-Datum, Icon, Screenshots, Video, Entwickler und seine Website. Bei entfernten Apps: die zuletzt gespeicherten Daten und das Entfernungsdatum.\n\nCost: 1 credit per call.", "x-credits": 1, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "Paketname der App", "schema": { "type": "string" }, "example": "com.whatsapp" } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/apps": { "get": { "operationId": "apps", "tags": [ "Apps" ], "summary": "Bis zu 100 Apps in einem Aufruf: GET ?ids=a,b,c oder POST mit der Liste im Body (eine pro Zeile oder JSON {\"ids\": […]}). 1 Credit pro App; nicht gefundene stehen in not_found.", "description": "Bis zu 100 Apps in einem Aufruf: GET ?ids=a,b,c oder POST mit der Liste im Body (eine pro Zeile oder JSON {\"ids\": […]}). 1 Credit pro App; nicht gefundene stehen in not_found.\n\nCost: 1 credit per app.", "x-credits": 1, "parameters": [ { "name": "ids", "in": "query", "required": true, "description": "Paketnamen, kommagetrennt, bis 100", "schema": { "type": "string" }, "example": "com.whatsapp,org.telegram.messenger" } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "apps_post", "tags": [ "Apps" ], "summary": "Same as GET, with package names in the request body (one per line, or JSON {\"ids\": [...]}).", "description": "Bis zu 100 Apps in einem Aufruf: GET ?ids=a,b,c oder POST mit der Liste im Body (eine pro Zeile oder JSON {\"ids\": […]}). 1 Credit pro App; nicht gefundene stehen in not_found.\n\nCost: 1 credit per app.", "x-credits": 1, "parameters": [], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } }, "requestBody": { "required": true, "content": { "text/plain": { "schema": { "type": "string" }, "example": "com.whatsapp\norg.telegram.messenger" } } } } }, "/search": { "get": { "operationId": "search", "tags": [ "Apps" ], "summary": "Suche und Filter über die gesamte Datenbank. Mindestens ein Filter ist erforderlich. Ohne q wird nach Installationen sortiert.", "description": "Suche und Filter über die gesamte Datenbank. Mindestens ein Filter ist erforderlich. Ohne q wird nach Installationen sortiert.\n\nCost: 2 credits per call.", "x-credits": 2, "parameters": [ { "name": "q", "in": "query", "required": false, "description": "Suchwörter für Titel, Beschreibung und Entwicklername", "schema": { "type": "string" }, "example": "photo editor" }, { "name": "category", "in": "query", "required": false, "description": "Kategorie-ID, z. B. GAME_PUZZLE (siehe /v1/categories)", "schema": { "type": "string" } }, { "name": "developer_id", "in": "query", "required": false, "description": "Google-Play-Entwickler-ID", "schema": { "type": "string" } }, { "name": "min_installs", "in": "query", "required": false, "description": "Mindestinstallationen (Google-Play-Schwellen: 1000, 10000…)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "max_installs", "in": "query", "required": false, "description": "maximale Installationen", "schema": { "type": "integer", "minimum": 0 } }, { "name": "min_score", "in": "query", "required": false, "description": "Mindestbewertung, 0–5", "schema": { "type": "string" } }, { "name": "min_ratings", "in": "query", "required": false, "description": "Mindestanzahl Bewertungen", "schema": { "type": "integer", "minimum": 0 } }, { "name": "free", "in": "query", "required": false, "description": "true — nur kostenlose, false — nur kostenpflichtige", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "ads", "in": "query", "required": false, "description": "true — mit Werbung, false — ohne", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "iap", "in": "query", "required": false, "description": "true — mit In-App-Käufen", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "lang", "in": "query", "required": false, "description": "Titelsprache, ISO-Code: en, de, pt…", "schema": { "type": "string" } }, { "name": "released_from", "in": "query", "required": false, "description": "veröffentlicht ab Datum, YYYY-MM-DD", "schema": { "type": "string" } }, { "name": "released_to", "in": "query", "required": false, "description": "veröffentlicht bis einschließlich Datum", "schema": { "type": "string" } }, { "name": "updated_from", "in": "query", "required": false, "description": "aktualisiert ab Datum", "schema": { "type": "string" } }, { "name": "updated_to", "in": "query", "required": false, "description": "aktualisiert bis einschließlich Datum", "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "description": "live (im Store, Standard), removed oder all", "schema": { "type": "string", "enum": [ "live", "removed", "all" ] } }, { "name": "sort", "in": "query", "required": false, "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price", "schema": { "type": "string" } }, { "name": "order", "in": "query", "required": false, "description": "desc | asc", "schema": { "type": "string", "enum": [ "desc", "asc" ] } }, { "name": "page", "in": "query", "required": false, "description": "Seite, ab 1", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "Zeilen pro Seite, 1–100 (Standard 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/suggest": { "get": { "operationId": "suggest", "tags": [ "Apps" ], "summary": "Vorschläge nach Titelanfang: die 10 beliebtesten Treffer. Kostenlos.", "description": "Vorschläge nach Titelanfang: die 10 beliebtesten Treffer. Kostenlos.\n\nCost: 0 credits per call.", "x-credits": 0, "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Titelanfang, ab 2 Zeichen", "schema": { "type": "string" }, "example": "whats" } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/developer": { "get": { "operationId": "developer", "tags": [ "Entwickler" ], "summary": "Ein Entwickler und alle seine Apps: Anzahl (im Store und entfernt), Installationen gesamt, Durchschnittsbewertung, erste Veröffentlichung, Kategorien, Website. Im Business-Tarif: E-Mail, Telefon, Adresse und Firmenname.", "description": "Ein Entwickler und alle seine Apps: Anzahl (im Store und entfernt), Installationen gesamt, Durchschnittsbewertung, erste Veröffentlichung, Kategorien, Website. Im Business-Tarif: E-Mail, Telefon, Adresse und Firmenname.\n\nCost: 2 credits per call.", "x-credits": 2, "parameters": [ { "name": "id", "in": "query", "required": false, "description": "Entwickler-ID (aus einer App: developer.id)", "schema": { "type": "string" }, "example": "5191370068110375942" }, { "name": "name", "in": "query", "required": false, "description": "oder der genaue Entwicklername", "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "description": "all (Standard), live oder removed", "schema": { "type": "string", "enum": [ "live", "removed", "all" ] } }, { "name": "sort", "in": "query", "required": false, "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Seite, ab 1", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "Zeilen pro Seite, 1–100 (Standard 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/new": { "get": { "operationId": "new", "tags": [ "Änderungen im Store" ], "summary": "Neue Apps nach Datum der Erstveröffentlichung, neueste zuerst.", "description": "Neue Apps nach Datum der Erstveröffentlichung, neueste zuerst.\n\nCost: 2 credits per call.", "x-credits": 2, "parameters": [ { "name": "since", "in": "query", "required": false, "description": "ab Datum, YYYY-MM-DD (Standard: vor 7 Tagen)", "schema": { "type": "string" } }, { "name": "until", "in": "query", "required": false, "description": "bis einschließlich Datum", "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "description": "Kategorie-ID, z. B. GAME_PUZZLE (siehe /v1/categories)", "schema": { "type": "string" } }, { "name": "min_installs", "in": "query", "required": false, "description": "Mindestinstallationen (Google-Play-Schwellen: 1000, 10000…)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "lang", "in": "query", "required": false, "description": "Titelsprache, ISO-Code: en, de, pt…", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Seite, ab 1", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "Zeilen pro Seite, 1–100 (Standard 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/removed": { "get": { "operationId": "removed", "tags": [ "Änderungen im Store" ], "summary": "Apps, die aus Google Play verschwunden sind (in allen 19 geprüften Ländern nicht vorhanden), nach Entfernungsdatum. Der Eintrag behält die letzten Daten.", "description": "Apps, die aus Google Play verschwunden sind (in allen 19 geprüften Ländern nicht vorhanden), nach Entfernungsdatum. Der Eintrag behält die letzten Daten.\n\nCost: 2 credits per call.", "x-credits": 2, "parameters": [ { "name": "since", "in": "query", "required": false, "description": "ab Datum, YYYY-MM-DD (Standard: vor 7 Tagen)", "schema": { "type": "string" } }, { "name": "until", "in": "query", "required": false, "description": "bis einschließlich Datum", "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "description": "Kategorie-ID, z. B. GAME_PUZZLE (siehe /v1/categories)", "schema": { "type": "string" } }, { "name": "min_installs", "in": "query", "required": false, "description": "Mindestinstallationen (Google-Play-Schwellen: 1000, 10000…)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "sort", "in": "query", "required": false, "description": "removed_at | installs | score", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Seite, ab 1", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "Zeilen pro Seite, 1–100 (Standard 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/keywords": { "get": { "operationId": "keywords", "tags": [ "Markt" ], "summary": "Wörter und Phrasen aus App-Titeln je Sprache: wie viele Apps und Entwickler sie nutzen, wie viele davon stark sind (100 Tsd.+ Installationen), Installationen gesamt, Anteil des Marktführers und ein Opportunity-Score.", "description": "Wörter und Phrasen aus App-Titeln je Sprache: wie viele Apps und Entwickler sie nutzen, wie viele davon stark sind (100 Tsd.+ Installationen), Installationen gesamt, Anteil des Marktführers und ein Opportunity-Score.\n\nCost: 2 credits per call.", "x-credits": 2, "parameters": [ { "name": "lang", "in": "query", "required": false, "description": "Sprache, Standard en", "schema": { "type": "string" }, "example": "en" }, { "name": "q", "in": "query", "required": false, "description": "Wort oder Phrase", "schema": { "type": "string" }, "example": "vpn" }, { "name": "phrase", "in": "query", "required": false, "description": "true — nur Zwei-Wort-Phrasen, false — nur einzelne Wörter", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "min_apps", "in": "query", "required": false, "description": "Mindestanzahl Apps", "schema": { "type": "integer", "minimum": 0 } }, { "name": "max_apps", "in": "query", "required": false, "description": "maximale Anzahl Apps", "schema": { "type": "integer", "minimum": 0 } }, { "name": "sort", "in": "query", "required": false, "description": "opportunity | apps | installs | strong | devs | max_installs", "schema": { "type": "string" } }, { "name": "order", "in": "query", "required": false, "description": "desc | asc", "schema": { "type": "string", "enum": [ "desc", "asc" ] } }, { "name": "page", "in": "query", "required": false, "description": "Seite, ab 1", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "Zeilen pro Seite, 1–100 (Standard 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/categories": { "get": { "operationId": "categories", "tags": [ "Markt" ], "summary": "Alle Kategorien mit Anzahl der Apps und Installationen gesamt. Kostenlos.", "description": "Alle Kategorien mit Anzahl der Apps und Installationen gesamt. Kostenlos.\n\nCost: 0 credits per call.", "x-credits": 0, "parameters": [ { "name": "status", "in": "query", "required": false, "description": "live (im Store, Standard), removed oder all", "schema": { "type": "string", "enum": [ "live", "removed", "all" ] } } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/free_domains": { "get": { "operationId": "free_domains", "tags": [ "Markt" ], "summary": "Apps, deren Website-Domain des Entwicklers frei registrierbar ist, mit der Beliebtheit der App. Tarif Pro und höher.", "description": "Apps, deren Website-Domain des Entwicklers frei registrierbar ist, mit der Beliebtheit der App. Tarif Pro und höher.\n\nCost: 3 credits per call. Plan: Pro or higher.", "x-credits": 3, "parameters": [ { "name": "category", "in": "query", "required": false, "description": "Kategorie-ID, z. B. GAME_PUZZLE (siehe /v1/categories)", "schema": { "type": "string" } }, { "name": "min_installs", "in": "query", "required": false, "description": "Mindestinstallationen (Google-Play-Schwellen: 1000, 10000…)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "status", "in": "query", "required": false, "description": "live (im Store, Standard), removed oder all", "schema": { "type": "string", "enum": [ "live", "removed", "all" ] } }, { "name": "tld", "in": "query", "required": false, "description": "Domain-Endung, z. B. com", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Seite, ab 1", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "Zeilen pro Seite, 1–100 (Standard 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/charts": { "get": { "operationId": "charts", "tags": [ "Markt" ], "summary": "Ein Google-Play-Chart für ein Land und eine Kategorie: bis zu 200 Plätze, Platzveränderung seit dem vorherigen Stand (change: um wie viele Plätze gestiegen, \"new\" für Neueinsteiger), Icon und Installationen.", "description": "Ein Google-Play-Chart für ein Land und eine Kategorie: bis zu 200 Plätze, Platzveränderung seit dem vorherigen Stand (change: um wie viele Plätze gestiegen, \"new\" für Neueinsteiger), Icon und Installationen.\n\nCost: 2 credits per call.", "x-credits": 2, "parameters": [ { "name": "country", "in": "query", "required": true, "description": "Land, ISO-Code: US, DE, BR…", "schema": { "type": "string" }, "example": "US" }, { "name": "category", "in": "query", "required": true, "description": "Kategorie, z. B. GAME_PUZZLE", "schema": { "type": "string" }, "example": "GAME_PUZZLE" }, { "name": "collection", "in": "query", "required": false, "description": "free | paid | grossing", "schema": { "type": "string", "enum": [ "free", "paid", "grossing" ] } }, { "name": "page", "in": "query", "required": false, "description": "Seite, ab 1", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "Zeilen pro Seite, 1–100 (Standard 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/rankings": { "get": { "operationId": "rankings", "tags": [ "Markt" ], "summary": "Alle Charts mit der App im letzten Stand: Land, Kategorie, Kollektion, Platz; Anzahl der Charts und Länder und bester Platz.", "description": "Alle Charts mit der App im letzten Stand: Land, Kategorie, Kollektion, Platz; Anzahl der Charts und Länder und bester Platz.\n\nCost: 1 credit per call.", "x-credits": 1, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "Paketname der App", "schema": { "type": "string" }, "example": "com.whatsapp" }, { "name": "country", "in": "query", "required": false, "description": "nur ein Land", "schema": { "type": "string" } }, { "name": "collection", "in": "query", "required": false, "description": "free | paid | grossing", "schema": { "type": "string", "enum": [ "free", "paid", "grossing" ] } } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/availability": { "get": { "operationId": "availability", "tags": [ "Markt" ], "summary": "Länder, in denen die App bei Google Play verfügbar ist (laut hreflang in der Store-Sitemap). Bei 190+ Ländern wird worldwide = true ohne Liste zurückgegeben.", "description": "Länder, in denen die App bei Google Play verfügbar ist (laut hreflang in der Store-Sitemap). Bei 190+ Ländern wird worldwide = true ohne Liste zurückgegeben.\n\nCost: 1 credit per call.", "x-credits": 1, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "Paketname der App", "schema": { "type": "string" }, "example": "com.whatsapp" } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/markets": { "get": { "operationId": "markets", "tags": [ "Markt" ], "summary": "Marktwettbewerb auf Basis der kostenlosen Charts: Einstiegsschwelle für Top 100 und Top 200 (Installationen der App auf diesem Platz), Anteil neuer (12 Monate) und lokaler (≤3 Länder) Apps in den Top-Plätzen und Größe des lokalen Markts. Ohne Parameter: alle Länder; country: die Kategorien eines Landes; category: eine Kategorie in allen Ländern.", "description": "Marktwettbewerb auf Basis der kostenlosen Charts: Einstiegsschwelle für Top 100 und Top 200 (Installationen der App auf diesem Platz), Anteil neuer (12 Monate) und lokaler (≤3 Länder) Apps in den Top-Plätzen und Größe des lokalen Markts. Ohne Parameter: alle Länder; country: die Kategorien eines Landes; category: eine Kategorie in allen Ländern.\n\nCost: 1 credit per call.", "x-credits": 1, "parameters": [ { "name": "country", "in": "query", "required": false, "description": "Land, ISO-Code", "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "description": "Kategorie-ID, z. B. GAME_PUZZLE (siehe /v1/categories)", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "description": "entry100 | entry200 | new_share | local_share | local_apps | local_installs | local_new", "schema": { "type": "string" } }, { "name": "order", "in": "query", "required": false, "description": "desc | asc", "schema": { "type": "string", "enum": [ "desc", "asc" ] } }, { "name": "page", "in": "query", "required": false, "description": "Seite, ab 1", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "Zeilen pro Seite, 1–100 (Standard 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/stats": { "get": { "operationId": "stats", "tags": [ "Markt" ], "summary": "Größe der Datenbank: Apps im Store und entfernte, Entwickler, neue und entfernte der letzten 7 Tage, Zeit der letzten Aktualisierung. Kostenlos.", "description": "Größe der Datenbank: Apps im Store und entfernte, Entwickler, neue und entfernte der letzten 7 Tage, Zeit der letzten Aktualisierung. Kostenlos.\n\nCost: 0 credits per call.", "x-credits": 0, "parameters": [], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/health": { "get": { "operationId": "health", "tags": [ "Account" ], "summary": "Service status. No key required.", "security": [], "responses": { "200": { "$ref": "#/components/responses/Ok" } } } } }, "components": { "securitySchemes": { "ApiKeyHeader": { "type": "apiKey", "in": "header", "name": "X-API-Key" }, "BearerAuth": { "type": "http", "scheme": "bearer" } }, "schemas": { "Credits": { "type": "object", "properties": { "cost": { "type": "integer", "description": "credits this request cost" }, "remaining": { "type": "integer", "description": "credits left (plan + balance)" } } }, "Ok": { "type": "object", "required": [ "ok" ], "additionalProperties": true, "properties": { "ok": { "type": "boolean", "const": true }, "results": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "total": { "type": "integer" }, "page": { "type": "integer" }, "per": { "type": "integer" }, "pages": { "type": "integer" }, "_credits": { "$ref": "#/components/schemas/Credits" } } }, "Error": { "type": "object", "required": [ "ok", "error", "code" ], "properties": { "ok": { "type": "boolean", "const": false }, "error": { "type": "string" }, "code": { "type": "string", "examples": [ "missing_api_key", "invalid_api_key", "account_blocked", "insufficient_credits", "rate_limited", "invalid_param", "invalid_request", "not_found", "upstream_error", "service_unavailable" ] } } } }, "responses": { "Ok": { "description": "Success", "headers": { "X-Cache": { "description": "HIT — served from cache, MISS — fresh query to the database", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } } }, "Error": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }