sp4ghet / GGDuelsFetcher

GeoGeussr Duels Stats Fetcher

This repo contains a collection of scripts to fetch all of your duels and their stats, and output them into a spreadsheet-safe format.

I have included both the minified version to paste into the console and also the pre-compiled version if you don't trust the code (who would?). You can find the minified script here and the full version here

Disclaimer: I do not condone the spam nor abuse of GeoGuessr's API. These scripts are intended for data analysis purposes only, and are not for misuse or exploitation of GeoGuessr. The use of the API is non-official, and may be revoked or blocked at any time. Not affiliated with GeoGuessr or any related entities. By using this script, you acknowledge and agree that the author and publisher shall not be liable for any damages or injuries whatsoever resulting from your use or inability to use the script, even if the author or publisher has been advised of the possibility of such damages.

Table of Contents

Changelog

Phase 1 - Fetching Duel IDs

Phase 2 - Fetching Data from IDs

Phase 3 - Data Visualization

Phase 4 - Updating Stats

Changelog

v1.0 - Initial Release

v1.1 - Added random-order input for updating data

v1.2 - Added date filter to spreadsheet

v1.3 - Added country data & stats

v1.4 - Added median damage diff (dealt - taken) on all rounds per country

~ changes by sp4ghet

v1.5 - Added more info about opponents and an option to filter duels by game mode

Instructions

Using the scripts to retrieve your data is very simple.

Note: All of the following steps were performed and screenshotted in Chrome. Other browsers may not work as intended, but feel free to try them out. Please make sure you are logged in or GeoGuessr's API won't let you access the data.

Note 2: The # of duels might not match the number on your profile. I'm not sure why but frankly it's close enough that I'm not going to bother finding out.

Phase 1: Get the data

1. Open your GeoGuessr profile

2. Scroll to the bottom of the page and find your profile link:

3. Keep note of the ID part. It should be a bunch of numbers/letters, something like 5ed8463f5422eaa2e8e51dfd

4. While on the same page, press F12 on your keyboard or Right Click and click Inspect at the bottom of the context menu.

5. Navigate to the Console tab of the new window that just opened:

6. Paste the following code snippet into the console. Don't press enter or submit yet. Replace --->YOUR ID HERE<--- at the end of the script with your ID you copied in step 3. If this is your first time fetching data for v1.5, leave lastId as is. (If you want to update data, then see phase 3).

const selfId = "--->YOUR ID HERE<---"
const lastId = "" // set this value if you only want to fetch from specific duel (see Phase 3)

7. Enter the following snippet

async function main(e,t){function o(e,t){return new Promise((o=>{setTimeout((()=>{o(e())}),t)}))}const n=await async function(t=1,n="",a=""){let s=a;const r=[];for(let a=0;a<t;a++){console.log("Fetching page",a+1);let t="https://www.geoguessr.com/api/v4/feed/private";""!==s&&(t+="?paginationToken="+s);let i=await fetch(t),c=await i.json();if(0===c.entries.length){console.log("All data fetched.");break}if(r.push(...(l=JSON.stringify(c),[...l.matchAll(/\\"gameId\\":\\"([\w\d\-]*)\\",\\"gameMode\\":\\"Duels\\"/g)].map((e=>e[1])))),r.includes(n))break;p=c.entries[c.entries.length-1].time.substring(0,23)+"Z",s=btoa(`{"HashKey":{"S":"${e+"_activity"}"},"Created":{"S":"${p}"}}`),await o((()=>console.log("Done")),500)}var p,l;let i=r.filter(((e,t,o)=>o.indexOf(e)===t));return i.includes(n)?i.slice(0,i.indexOf(n)):i}(1e3,t);let a={};async function s(t){const o={};o.id=t.gameId,o.rounds=t.currentRoundNumber,o.startDate=new Date(t.rounds[0].startTime).toLocaleString("en-US"),o.endDate=new Date(t.rounds[o.rounds-1].endTime).toLocaleString("en-US"),o.mode=t.options.competitiveGameMode;for(let n=0;n<2;n++){let s=t.teams[n];if(s.players[0].playerId===e){if(o.selfHp=s.health,null===s.players[0].progressChange)o.befElo=s.players[0].rating,o.aftElo=o.befElo;else{const e=s.players[0].progressChange.competitiveProgress;null===e?(o.befElo=s.players[0].rating,o.aftElo=o.befElo):(o.befElo=e.ratingBefore,o.aftElo=e.ratingAfter)}[o.selfDist,o.selfTtg,o.selfCountries]=r(s.players[0].guesses,t.rounds,s.roundResults,t.teams[1-n].roundResults)}else{if(o.oppId=s.players[0].playerId,o.oppHp=s.health,o.oppElo=s.players[0].rating,[o.oppDist,o.oppTtg,_nil]=r(s.players[0].guesses,t.rounds),!a[o.oppId]){const e=`https://www.geoguessr.com/api/v3/users/${o.oppId}`,t=await fetch(e,{credentials:"include"});if(t.status>=400){o.oppName="Deleted User",o.oppCountry="",o.oppBanned=!0,o.oppBlueCheck=!1,o.oppCreator=!1;continue}const n=await t.json();a[o.oppId]=n}const e=a[o.oppId];o.oppName=e.nick,o.oppCountry=e.countryCode,o.oppBanned=e.isBanned,o.oppBluecheck=0!=(2&e.flair),o.oppCreator=e.isCreator}}return o}function r(e,t,o=null,n=null){let a=0,s=0,r=0,p={};for(const l of e){let e=l.roundNumber-1,i=(new Date(l.created)-new Date(t[e].startTime))/1e3;if(r++,a+=l.distance,s+=i,!o)continue;let c=t[e].panorama?.countryCode;""!==c&&(c in p||(p[c]=[0,0,0,0,0,0]),p[c][0]++,p[c][1]+=l.distance,p[c][2]+=i,o[e].healthAfter>=o[e].healthBefore?p[c][3]++:p[c][4]+=n[e].score-o[e].score,p[c][5]+=o[e].score-n[e].score)}return 0===r?["",""]:[a/r,s/r,Object.entries(p).map((e=>e[0]+","+e[1].join(","))).join(";")]}const p={id:"ID",rounds:"# Rounds",startDate:"Start Date",endDate:"End Date",selfHp:"My Health",befElo:"Start ELO",aftElo:"End ELO",selfDist:"Avg Distance",selfTtg:"Avg TTG",oppId:"Opp ID",oppHp:"Opp Health",oppElo:"Opp ELO",oppDist:"Opp Distance",oppTtg:"Opp TTG",selfCountries:"Self Countries",mode:"Game Mode",oppName:"Opp Name",oppCountry:"Opp Country",oppBanned:"Opp Banned",oppBluecheck:"Opp Bluecheck",oppCreator:"Opp Creator"};const l=function(e,t="\t",o=p){let n="";e=[...e];for(const a of e){for(const e in o)n+=a[e]+t;n+="\n"}return n}(await async function(e){let t=[],n=0;for(const a of e){console.log(`Fetching duel #${n++} / ${e.length}`);let r=await fetch(`https://game-server.geoguessr.com/api/duels/${a}`,{credentials:"include"});r=await r.json();const p=await s(r);t.push(p),await o((()=>null),150)}return t}(n));return l}
await main(selfId, lastId)

8. Press enter to submit the code. Wait for it to retrieve the data. Make sure to keep the page open so it runs faster. It might take a few minutes to run depending on how many games you have. Once it is done running, you should see a big block of text:

9. Right click on the block of text and select "Copy string contents":

10. You can now paste this data into any spreadsheet!

Phase 2: Data Visualization

To visualize the data you just copied at the end of phase 2, you can make your own spreadsheet or use the one I have created. By default, the spreadsheet calculates stats up to 5000 duels. If you want to include more, you might need to edit the formulas and extend the calculations sheet. To use my spreadsheet template:

1. Go to the Google Sheets document

2. Under File, click "Make a copy".

3. In your copy of the spreadsheet, paste the data as you copied it into the cell A1 on the sheet named PASTE HERE. If needed, you can navigate to the sheet from the tabs at the bottom-left.

4. Navigate to the Data sheet using the tabs at the bottom to view your processed data and graphs.

Note: the spreadsheet may take a few seconds to calculate the stats if you add/remove/change a large amount of data. Please wait until the blue bar at the top-right of the page finishes loading. If you don't see this, then you should be good to go!

Phase 3: Updating your stats

If you want to update your stats after playing more duels, you can do so very easily.

Note: If your spreadsheet version is before v1.5, you'll need to re-copy the spreadsheet and paste your data into cell A1 on the sheet named PASTE HERE.

1. From your spreadsheet, copy the ID of your most recent duels match. If you're using my spreadsheet, it should be cell A2 of the CALC sheet.
2. Follow Phase 1 and 2 from above like before. However, in step 1 add your most recent duels ID to const lastId = "-->HERE<--";

3. Complete the rest of Phase 1 like before.
4. Once done, you can paste your raw stats string into column 1 of any row of the spreadsheet (although it might be best for you to paste it right after your old stats).

5. Your stats should automatically update. Enjoy!