{
    "info": {
        "name": "APK API",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
        "description": "APK API — Google Play data. Set the apiKey variable to your key from https://apkapi.com/cabinet.php?tab=keys. Docs: https://apkapi.com/api-docs.php"
    },
    "variable": [
        {
            "key": "baseUrl",
            "value": "https://apkapi.com/api/v1"
        },
        {
            "key": "apiKey",
            "value": "YOUR_KEY"
        }
    ],
    "item": [
        {
            "name": "Account",
            "item": [
                {
                    "name": "/account",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/account",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "account"
                            ],
                            "query": []
                        },
                        "description": "Your plan, tokens and limits. Free."
                    }
                }
            ]
        },
        {
            "name": "Sovellukset",
            "item": [
                {
                    "name": "/app",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/app?id=com.whatsapp",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "app"
                            ],
                            "query": [
                                {
                                    "key": "id",
                                    "value": "com.whatsapp",
                                    "description": "sovelluksen pakettinimi"
                                }
                            ]
                        },
                        "description": "Sovelluksen täydet tiedot: nimi, kuvaus, “Mitä uutta”, asennukset (kynnys ja tarkka luku), arvosana, arvosanojen ja arvostelujen määrä, tähtijakauma, hinta, ostot, mainokset, kategoria, ikäluokitus, versio, Android-vähimmäisversio, julkaisu- ja päivityspäivät, kuvake, kuvakaappaukset, video, kehittäjä ja hänen sivustonsa. Poistetuille: viimeisimmät tallennetut tiedot ja poistumispäivä. Cost: 1 token(s)."
                    }
                },
                {
                    "name": "/apps",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/apps?ids=com.whatsapp,org.telegram.messenger",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "apps"
                            ],
                            "query": [
                                {
                                    "key": "ids",
                                    "value": "com.whatsapp,org.telegram.messenger",
                                    "description": "pakettinimet pilkulla erotettuina, enintään 100"
                                }
                            ]
                        },
                        "description": "Enintään 100 sovelluksen tiedot yhdellä pyynnöllä: GET ?ids=a,b,c tai POST, jossa luettelo rungossa (yksi per rivi tai JSON {\"ids\": […]}). 1 token per sovellus; tuntemattomat palautetaan kentässä not_found. Cost: 1 token(s)."
                    }
                },
                {
                    "name": "/apps",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            },
                            {
                                "key": "Content-Type",
                                "value": "text/plain"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/apps",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "apps"
                            ],
                            "query": []
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "com.whatsapp\norg.telegram.messenger"
                        },
                        "description": "POST variant: one package name per line in the body."
                    }
                },
                {
                    "name": "/search",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/search?q=photo editor&per=20",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "search"
                            ],
                            "query": [
                                {
                                    "key": "q",
                                    "value": "photo editor",
                                    "description": "hakusanat nimestä, kuvauksesta ja kehittäjän nimestä"
                                },
                                {
                                    "key": "category",
                                    "value": "",
                                    "description": "kategorian tunnus, esim. GAME_PUZZLE (katso /v1/categories)",
                                    "disabled": true
                                },
                                {
                                    "key": "developer_id",
                                    "value": "",
                                    "description": "Google Playn kehittäjätunnus",
                                    "disabled": true
                                },
                                {
                                    "key": "min_installs",
                                    "value": "",
                                    "description": "asennuksia vähintään (Google Playn kynnys: 1000, 10000…)",
                                    "disabled": true
                                },
                                {
                                    "key": "max_installs",
                                    "value": "",
                                    "description": "asennuksia enintään",
                                    "disabled": true
                                },
                                {
                                    "key": "min_score",
                                    "value": "",
                                    "description": "pienin arvosana, 0–5",
                                    "disabled": true
                                },
                                {
                                    "key": "min_ratings",
                                    "value": "",
                                    "description": "arvosanoja vähintään",
                                    "disabled": true
                                },
                                {
                                    "key": "free",
                                    "value": "",
                                    "description": "true — vain ilmaiset, false — vain maksulliset",
                                    "disabled": true
                                },
                                {
                                    "key": "ads",
                                    "value": "",
                                    "description": "true — mainoksilla, false — ilman",
                                    "disabled": true
                                },
                                {
                                    "key": "iap",
                                    "value": "",
                                    "description": "true — sovelluksen sisäisillä ostoilla",
                                    "disabled": true
                                },
                                {
                                    "key": "lang",
                                    "value": "",
                                    "description": "nimen kieli, ISO-koodi: en, de, pt…",
                                    "disabled": true
                                },
                                {
                                    "key": "released_from",
                                    "value": "",
                                    "description": "julkaistu tästä päivästä alkaen, YYYY-MM-DD",
                                    "disabled": true
                                },
                                {
                                    "key": "released_to",
                                    "value": "",
                                    "description": "julkaistu viimeistään tänä päivänä",
                                    "disabled": true
                                },
                                {
                                    "key": "updated_from",
                                    "value": "",
                                    "description": "päivitetty tästä päivästä alkaen",
                                    "disabled": true
                                },
                                {
                                    "key": "updated_to",
                                    "value": "",
                                    "description": "päivitetty viimeistään tänä päivänä",
                                    "disabled": true
                                },
                                {
                                    "key": "status",
                                    "value": "",
                                    "description": "live (kaupassa, oletus), removed tai all",
                                    "disabled": true
                                },
                                {
                                    "key": "sort",
                                    "value": "",
                                    "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price",
                                    "disabled": true
                                },
                                {
                                    "key": "order",
                                    "value": "",
                                    "description": "desc | asc",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "",
                                    "description": "sivu, alkaen 1",
                                    "disabled": true
                                },
                                {
                                    "key": "per",
                                    "value": "20",
                                    "description": "riviä sivulla, 1–100 (oletus 20)"
                                }
                            ]
                        },
                        "description": "Haku ja suodattimet koko tietokannasta. Vähintään yksi suodatin vaaditaan. Ilman q-parametria lajittelu on asennusten mukaan. Cost: 2 token(s)."
                    }
                },
                {
                    "name": "/suggest",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/suggest?q=whats",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "suggest"
                            ],
                            "query": [
                                {
                                    "key": "q",
                                    "value": "whats",
                                    "description": "nimen alku, vähintään 2 merkkiä"
                                }
                            ]
                        },
                        "description": "Ehdotukset nimen alun perusteella: 10 suosituinta osumaa. Ilmainen. Cost: 0 token(s)."
                    }
                }
            ]
        },
        {
            "name": "Kehittäjät",
            "item": [
                {
                    "name": "/developer",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/developer?id=5191370068110375942&per=20",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "developer"
                            ],
                            "query": [
                                {
                                    "key": "id",
                                    "value": "5191370068110375942",
                                    "description": "kehittäjän tunnus (sovelluksen tiedoista: developer.id)"
                                },
                                {
                                    "key": "name",
                                    "value": "",
                                    "description": "tai kehittäjän tarkka nimi",
                                    "disabled": true
                                },
                                {
                                    "key": "status",
                                    "value": "",
                                    "description": "all (oletus), live tai removed",
                                    "disabled": true
                                },
                                {
                                    "key": "sort",
                                    "value": "",
                                    "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "",
                                    "description": "sivu, alkaen 1",
                                    "disabled": true
                                },
                                {
                                    "key": "per",
                                    "value": "20",
                                    "description": "riviä sivulla, 1–100 (oletus 20)"
                                }
                            ]
                        },
                        "description": "Kehittäjä ja kaikki hänen sovelluksensa: määrä (kaupassa ja poistetut), asennukset yhteensä, keskiarvosana, ensimmäinen julkaisu, kategoriat, sivusto. Business-tasolla: sähköposti, puhelin, osoite ja oikeudellinen nimi. Cost: 2 token(s)."
                    }
                }
            ]
        },
        {
            "name": "Muutokset kaupassa",
            "item": [
                {
                    "name": "/new",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/new?per=20",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "new"
                            ],
                            "query": [
                                {
                                    "key": "since",
                                    "value": "",
                                    "description": "päivästä alkaen, YYYY-MM-DD (oletus: 7 päivää sitten)",
                                    "disabled": true
                                },
                                {
                                    "key": "until",
                                    "value": "",
                                    "description": "viimeistään tänä päivänä",
                                    "disabled": true
                                },
                                {
                                    "key": "category",
                                    "value": "",
                                    "description": "kategorian tunnus, esim. GAME_PUZZLE (katso /v1/categories)",
                                    "disabled": true
                                },
                                {
                                    "key": "min_installs",
                                    "value": "",
                                    "description": "asennuksia vähintään (Google Playn kynnys: 1000, 10000…)",
                                    "disabled": true
                                },
                                {
                                    "key": "lang",
                                    "value": "",
                                    "description": "nimen kieli, ISO-koodi: en, de, pt…",
                                    "disabled": true
                                },
                                {
                                    "key": "sort",
                                    "value": "",
                                    "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "",
                                    "description": "sivu, alkaen 1",
                                    "disabled": true
                                },
                                {
                                    "key": "per",
                                    "value": "20",
                                    "description": "riviä sivulla, 1–100 (oletus 20)"
                                }
                            ]
                        },
                        "description": "Uudet sovellukset ensimmäisen julkaisun päivän mukaan, uusimmat ensin. Cost: 2 token(s)."
                    }
                },
                {
                    "name": "/removed",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/removed?per=20",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "removed"
                            ],
                            "query": [
                                {
                                    "key": "since",
                                    "value": "",
                                    "description": "päivästä alkaen, YYYY-MM-DD (oletus: 7 päivää sitten)",
                                    "disabled": true
                                },
                                {
                                    "key": "until",
                                    "value": "",
                                    "description": "viimeistään tänä päivänä",
                                    "disabled": true
                                },
                                {
                                    "key": "category",
                                    "value": "",
                                    "description": "kategorian tunnus, esim. GAME_PUZZLE (katso /v1/categories)",
                                    "disabled": true
                                },
                                {
                                    "key": "min_installs",
                                    "value": "",
                                    "description": "asennuksia vähintään (Google Playn kynnys: 1000, 10000…)",
                                    "disabled": true
                                },
                                {
                                    "key": "sort",
                                    "value": "",
                                    "description": "removed_at | installs | score",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "",
                                    "description": "sivu, alkaen 1",
                                    "disabled": true
                                },
                                {
                                    "key": "per",
                                    "value": "20",
                                    "description": "riviä sivulla, 1–100 (oletus 20)"
                                }
                            ]
                        },
                        "description": "Google Playsta poistuneet sovellukset (ei löydy yhdestäkään tarkistamastamme 19 maasta) poistumispäivän mukaan. Sovelluksen tiedot säilyttävät viimeiset tiedot. Cost: 2 token(s)."
                    }
                }
            ]
        },
        {
            "name": "Markkina",
            "item": [
                {
                    "name": "/keywords",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/keywords?lang=en&q=vpn&per=20",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "keywords"
                            ],
                            "query": [
                                {
                                    "key": "lang",
                                    "value": "en",
                                    "description": "kieli, oletus en"
                                },
                                {
                                    "key": "q",
                                    "value": "vpn",
                                    "description": "sana tai fraasi"
                                },
                                {
                                    "key": "phrase",
                                    "value": "",
                                    "description": "true — vain kahden sanan fraasit, false — vain yksittäiset sanat",
                                    "disabled": true
                                },
                                {
                                    "key": "min_apps",
                                    "value": "",
                                    "description": "sovelluksia vähintään",
                                    "disabled": true
                                },
                                {
                                    "key": "max_apps",
                                    "value": "",
                                    "description": "sovelluksia enintään",
                                    "disabled": true
                                },
                                {
                                    "key": "sort",
                                    "value": "",
                                    "description": "opportunity | apps | installs | strong | devs | max_installs",
                                    "disabled": true
                                },
                                {
                                    "key": "order",
                                    "value": "",
                                    "description": "desc | asc",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "",
                                    "description": "sivu, alkaen 1",
                                    "disabled": true
                                },
                                {
                                    "key": "per",
                                    "value": "20",
                                    "description": "riviä sivulla, 1–100 (oletus 20)"
                                }
                            ]
                        },
                        "description": "Sanat ja fraasit sovellusten nimistä kielikohtaisesti: kuinka monta sovellusta ja kehittäjää niitä käyttää, kuinka moni niistä on vahva (yli 100 000 asennusta), asennukset yhteensä, johtajan osuus ja mahdollisuuspisteet (opportunity). Cost: 2 token(s)."
                    }
                },
                {
                    "name": "/categories",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/categories?",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "categories"
                            ],
                            "query": [
                                {
                                    "key": "status",
                                    "value": "",
                                    "description": "live (kaupassa, oletus), removed tai all",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "Kaikki kategoriat sovellusmäärineen ja asennuksineen yhteensä. Ilmainen. Cost: 0 token(s)."
                    }
                },
                {
                    "name": "/free_domains",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/free_domains?per=20",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "free_domains"
                            ],
                            "query": [
                                {
                                    "key": "category",
                                    "value": "",
                                    "description": "kategorian tunnus, esim. GAME_PUZZLE (katso /v1/categories)",
                                    "disabled": true
                                },
                                {
                                    "key": "min_installs",
                                    "value": "",
                                    "description": "asennuksia vähintään (Google Playn kynnys: 1000, 10000…)",
                                    "disabled": true
                                },
                                {
                                    "key": "status",
                                    "value": "",
                                    "description": "live (kaupassa, oletus), removed tai all",
                                    "disabled": true
                                },
                                {
                                    "key": "tld",
                                    "value": "",
                                    "description": "verkkotunnuksen pääte, esim. com",
                                    "disabled": true
                                },
                                {
                                    "key": "sort",
                                    "value": "",
                                    "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "",
                                    "description": "sivu, alkaen 1",
                                    "disabled": true
                                },
                                {
                                    "key": "per",
                                    "value": "20",
                                    "description": "riviä sivulla, 1–100 (oletus 20)"
                                }
                            ]
                        },
                        "description": "Sovellukset, joiden kehittäjän sivuston verkkotunnus on rekisteröitävissä, sovelluksen suosiotietoineen. Avautuu ensimmäisen tokenioston jälkeen. Cost: 3 token(s)."
                    }
                },
                {
                    "name": "/charts",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/charts?country=US&category=GAME_PUZZLE&per=20",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "charts"
                            ],
                            "query": [
                                {
                                    "key": "country",
                                    "value": "US",
                                    "description": "maa, ISO-koodi: US, DE, BR…"
                                },
                                {
                                    "key": "category",
                                    "value": "GAME_PUZZLE",
                                    "description": "kategoria, esim. GAME_PUZZLE"
                                },
                                {
                                    "key": "collection",
                                    "value": "",
                                    "description": "free | paid | grossing",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "",
                                    "description": "sivu, alkaen 1",
                                    "disabled": true
                                },
                                {
                                    "key": "per",
                                    "value": "20",
                                    "description": "riviä sivulla, 1–100 (oletus 20)"
                                }
                            ]
                        },
                        "description": "Yhden maan ja kategorian Google Play -huippulista: enintään 200 sijaa, sijamuutos edellisestä tilanteesta (change: kuinka monta sijaa noussut, \"new\" — uusi listalla), kuvake ja asennukset. Cost: 2 token(s)."
                    }
                },
                {
                    "name": "/rankings",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/rankings?id=com.whatsapp",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "rankings"
                            ],
                            "query": [
                                {
                                    "key": "id",
                                    "value": "com.whatsapp",
                                    "description": "sovelluksen pakettinimi"
                                },
                                {
                                    "key": "country",
                                    "value": "",
                                    "description": "vain yksi maa",
                                    "disabled": true
                                },
                                {
                                    "key": "collection",
                                    "value": "",
                                    "description": "free | paid | grossing",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "Kaikki listat, joilla sovellus on viimeisimmässä tilanteessa: maa, kategoria, kokoelma, sija; listojen ja maiden määrä sekä paras sija. Cost: 1 token(s)."
                    }
                },
                {
                    "name": "/availability",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/availability?id=com.whatsapp",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "availability"
                            ],
                            "query": [
                                {
                                    "key": "id",
                                    "value": "com.whatsapp",
                                    "description": "sovelluksen pakettinimi"
                                }
                            ]
                        },
                        "description": "Maat, joissa sovellus on saatavilla Google Playssa (kaupan sitemapin hreflangin mukaan). Jos maita on yli 190, palautetaan worldwide = true ilman luetteloa. Cost: 1 token(s)."
                    }
                },
                {
                    "name": "/markets",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/markets?per=20",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "markets"
                            ],
                            "query": [
                                {
                                    "key": "country",
                                    "value": "",
                                    "description": "maa, ISO-koodi",
                                    "disabled": true
                                },
                                {
                                    "key": "category",
                                    "value": "",
                                    "description": "kategorian tunnus, esim. GAME_PUZZLE (katso /v1/categories)",
                                    "disabled": true
                                },
                                {
                                    "key": "sort",
                                    "value": "",
                                    "description": "entry100 | entry200 | new_share | local_share | local_apps | local_installs | local_new",
                                    "disabled": true
                                },
                                {
                                    "key": "order",
                                    "value": "",
                                    "description": "desc | asc",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "",
                                    "description": "sivu, alkaen 1",
                                    "disabled": true
                                },
                                {
                                    "key": "per",
                                    "value": "20",
                                    "description": "riviä sivulla, 1–100 (oletus 20)"
                                }
                            ]
                        },
                        "description": "Markkinoiden kilpailu ilmaisten listojen perusteella: pääsykynnys top 100- ja top 200 -listoille (sovelluksen asennukset kyseisellä sijalla), uusien (12 kuukauden aikana) ja paikallisten (≤3 maata) sovellusten osuus kärjessä sekä paikallisen markkinan koko. Ilman parametreja: kaikki maat; country: yhden maan kategoriat; category: yksi kategoria kaikissa maissa. Cost: 1 token(s)."
                    }
                },
                {
                    "name": "/stats",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-API-Key",
                                "value": "{{apiKey}}"
                            }
                        ],
                        "url": {
                            "raw": "{{baseUrl}}/stats",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "stats"
                            ],
                            "query": []
                        },
                        "description": "Tietokannan koko: sovellukset kaupassa ja poistetut, kehittäjät, uudet ja poistetut 7 päivässä, viimeisimmän päivityksen aika. Ilmainen. Cost: 0 token(s)."
                    }
                }
            ]
        }
    ]
}