PGScout is a webservice that takes coordinates and encounter ID of a Pokémon in Pokémon GO and returns their stats like individual values, CP and level.
Bonus feature #1: PGScout also pulls the moveset rating A to F from GamePress. So you will instantly know whether your Pokémon has an optimal moveset for attack and/or defense. See Vaporeon on GamePress for an example of moveset ratings.
Bonus feature #2: PGScout also works if you don't have the encounter_id and spawn_point_id of the Pokémon which are usually necessary to perform the encounter request. Location and Pokédex ID is enough for PGScout to work. It will scan the area for the desired Pokémon and perform the encounter afterwards.
If you like this tool and feel the urgent need to thank me, the best way to do it is via BitCoin (1PNdXhzvvz2ytCf8mbFdF9MQaABzpjSbJi) or PayPal. Seriously, that would be so awesome! :-D If you can't or don't want to use PayPal or BitCoin some level 30+ accounts. You can find me on the PGTools Discord Server and on various other Pokémon GO related Discords as "sLoPPydrive".
Come join the official PGTools Discord Server for PGScout, PGNumbra, PGPool and the PGTools RocketMap and PokeAlarm forks to get help or just hang around. You are very welcome. :)
PGScout or its author takes no responsibility if your accounts get banned in any way. As with any other 3rd party software breaking the ToS there is absolutely no guarantee that your accounts stay safe. This software is purely for educational purpose.
PGScout cannot work on itself. You need the following things:
- One or more Pokémon GO accounts (level 30+ needed). See Reddit discussion here. As of 2017-04-28 everything below level 30 seems to be scrambled and totally random for everyone. :-/
- A Bossland PokeHash Key
An incoming web-request to PGScout will create a job that is being put in a queue. All configured accounts will attach to this queue, pull jobs, perform the corresponding encounters and attach the found information back to the job, marking the job as completed. The incoming web-request waits for the job to be completed and returns the result JSON encoded to the requesting client.
Just copy config.ini.sample to config.ini and change what you want/need to change.
Configuration parameters can also be given on the commandline:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
Specify configuration file.
-hs HOST, --host HOST
Host or IP to bind to.
-p PORT, --port PORT Port to bind to.
-hk HASH_KEY, --hash-key HASH_KEY
Hash key(s) to use.
-pf PROXIES_FILE, --proxies-file PROXIES_FILE
Load proxy list from text file (one proxy per line).
-l LEVEL, --level LEVEL
Minimum trainer level required. Lower levels will
yield an error.
-mqj MAX_QUEUED_JOBS, --max-queued-jobs MAX_QUEUED_JOBS
Maximum number of queued scout jobs before rejecting
new jobs. 0 (default) means no restriction.
-mjttl MAX_JOB_TTL, --max-job-ttl MAX_JOB_TTL
Maximum number of minutes a job is allowed to be
queued before it expires (Time-To-Live). Expired jobs
will be rejected when its their turn. 0 (default)
means no restriction.
-sb SHADOWBAN_THRESHOLD, --shadowban-threshold SHADOWBAN_THRESHOLD
Mark an account as shadowbanned after this many
errors. If --pgpool_url is specified the account gets
swapped out.
-iv INITIAL_VIEW, --initial-view INITIAL_VIEW
Initial view. Can be one of "logs", "scouts" or
"pokemon". Default is "logs".
-pgpu PGPOOL_URL, --pgpool-url PGPOOL_URL
Address of PGPool to load accounts from and/or update
their details.
-pgpsid PGPOOL_SYSTEM_ID, --pgpool-system-id PGPOOL_SYSTEM_ID
System ID for PGPool. Required if --pgpool-url given.
-pgpn PGPOOL_NUM_ACCOUNTS, --pgpool-num-accounts PGPOOL_NUM_ACCOUNTS
Use this many accounts from PGPool. --pgpool-url
required.
-a ACCOUNTS_FILE, --accounts-file ACCOUNTS_FILE
Load accounts from CSV file containing
"auth_service,username,passwd" lines.
Defaults are:
host: 127.0.0.1 - Set this to0.0.0.0to open up PGScout to the public.port: 4242level: 30shadowban-threshold: 5
Don't forget to run pip install -r requirements.txt at least once before actually starting PGScout with python pgscout.py.
PGScout accepts HTTP GET requests at http://<your host>:<port>/iv and needs these parameters:
pokemon_id: The Pokédex number of the Pokémon (mandatory)encounter_id: Encounter ID (Base64 encoded or as long integer) provided by map scanner (recommended)spawn_point_id: ID of spawn point provided by map scanner as hex string (recommended)latitude: Latitude of Pokémon spawn (mandatory)longitude: Longitude of Pokémon spawn (mandatory)despawn_time: Time in seconds since the Epoch when the Pokémon disappears, if known. (optional)
Note that if either encounter_id or spawn_point_id is missing PGScout first performs a GET_MAP_OBJECTS request
to scan the given location. It then searches for the nearest Pokémon with the given pokemon_id and performs the encounter
on this one. This is generally not recommended!
An example request looks like this:
http://localhost:4242/iv?pokemon_id=70&encounter_id=MTY4MjU4OTY4Njg2MjExOTUwNA%3D%3D&spawn_point_id=47bf32c2c4d&latitude=51.124696678951&longitude=6.89885987319504
The response is JSON formatted and looks like this:
{
"success": true,
"encounter_id": 16389112216478965452,
"encounter_id_b64": "MTYzODkxMTIyMTY0Nzg5NjU0NTI=",
"encountered_time": 1493990168.06719,
"iv_percent": 55.55555555555556,
"iv_attack": 3,
"iv_defense": 13,
"iv_stamina": 9,
"move_1": 230,
"move_2": 107,
"cp": 282,
"cp_multiplier": 0.29024988412857056,
"level": 5,
"catch_prob_1": 0.0861327052116394,
"catch_prob_2": 0.1263757348060608,
"catch_prob_3": 0.1648465394973755,
"gender": 1,
"height": 1.6896531581878662,
"weight": 108.0298080444336,
"rating_attack": "A",
"rating_defense": "B",
"scout_level": 30
}Most fields of the response should be self-explanatory.
encountered_time: The timestamp when the scout account made the encounter.rating_attackandrating_defense: The moveset rating according to GamePress for attack and defense. If the moveset has no rating the field will contain a dash: "-"cp_multiplier"CP Multiplier (CPM) is a number which Niantic uses to scale the attributes of a pokemon based on its level." PGScout uses this number to determine the Pokémon level. Read more at GamePress.level: The Pokémon level which is being represented by the arc in the Pokémon details in the game. Wild Pokémon will have a level that is limited by the trainer level but not larger than 30, so a trainer with level 17 may find Pokémon from level 1 to 17 but a level 34 trainer may only find Pokémon from level 1 to 30. So 30 is the absolute maximum for wild Pokémon. (Note that Pokémon being hatched from eggs have an upper limit of level 20.)catch_prob_1tocatch_prob_3: These are the catch probabilities for a regular Pokéball (1), a Great Ball (2) and an Ultra Ball (3). The higher the number the higher the chance to catch the Pokémon with the corresponding ball for a regular hit. Maximum is 1.0 which corresponds to 100% catch probability, so you will catch the Pokémon however you hit it.scout_level: The trainer level of the scout account being used.
If a scout encounters a Unown its form will be returned under key form in the response.
PGScout detects your scout account trainer level and therefore knows which values are reliable and sets the others to null. Reliable means that the value is the same for all other trainers of the same or higher level.
Update from 2017-04-28: Every stats (IV, height, weight, moves, CP, etc.) now seems to be totally unique for every player below level 30 even if their trainer level is the same. So using scout accounts below level 30 does not make sense at all.
If PGScout encounters an error, the response will look something like this:
{
"success": false,
"error": "Pokemon already despawned."
}