Geeklab API Documentation
đ API Documentation
Geeklab API is created to allow Geeklab developers and users to access their apps, campaigns, and campaign results. The API requires a unique API token, you can receive and revoke from Geeklabâs dashboard if you have admin access.
The purpose of the API is to allow Geeklab users to receive campaign performance on a high-level, to allow faster analysis and reports on internal dashboards. All the data is returned as a JSON file.
The API works in three levels, which each of them works in two vectors, return and list.
Project
Campaigns
Variant
đ List
List API will return all the different content with some relevant info.
đȘ Project
The Project-level list call requires only the token and will list all the different campaigns ever created that belong to that specific Project.
Example Call
https://geeklab.app/APIV1/v1/list/{geeklab.token}
Which would return a JSON like this where each child is an Project created under the account with the API token
Project call allows you to search for apps with specific genres, or subgenres as well as by date. The options are appended as GET parameters in the URL as such:
https://geeklab.app/APIV1/v1/list/{geeklab.token}?genre=[csv]&subgenre=[csv]
đ List/Campaign
The campaign-level list call returns all the campaigns from one specific app, or if left empty, all the campaigns created in the account
Example Call:
https://geeklab.app/APIV1/v1/list/c/{geeklab.token}
Which would return a JSON like this where each child is a campaign created under the account with the API token
Campaign call allows you to search for campaigns from specific apps as well as by date. The options are appended as GET parameters in the URL as such:
https://geeklab.app/APIV1/v1/list/c/{geeklab.token}?app=[app.token]
đ§âđ List/Variant
The variant-level list call returns all the variants from one specific campaign, or if left empty, all the variants created in the account
Example Call:
https://geeklab.app/APIV1/v1/list/v/{geeklab.token}
Which would return a JSON like this where each child is a campaign created under the account with the API token
A variant call allows you to search for variants from a specific campaign as well as by date. The options are appended as GET parameters in the URL as such:
[https://geeklab.app/APIV1/v1/list/v/{geeklab.token}?campaign=
âïž Retrieve
Retrieve API will return results per campaign. Unlike with the Geeklab dashboard, the API results are cached a few times a day.
Each of the retrieve calls will return the same parameters. App, Campaign, and Variant variables allow you to specify, at which level you want to receive the data.
All the returned values are integers
For App: [https://geeklab.app/APIV1/v1/retrieve/{geeklab.token}&app=appId
For Campaign: [https://geeklab.app/APIV1/v1/retrieve/{geeklab.token}&campaign=campaigntoken
For Variant: [https://geeklab.app/APIV1/v1/retrieve/{geeklab.token}&variant=varianttoken
Geeklab API is created to allow Geeklab developers and users to access their apps, campaigns, and campaign results. The API requires a unique API token, you can receive and revoke from Geeklabâs dashboard if you have admin access.
The purpose of the API is to allow Geeklab users to receive campaign performance on a high-level, to allow faster analysis and reports on internal dashboards. All the data is returned as a JSON file.
The API works in three levels, which each of them works in two vectors, return and list.
Project
Campaigns
Variant
đ List
List API will return all the different content with some relevant info.
đȘ Project
The Project-level list call requires only the token and will list all the different campaigns ever created that belong to that specific Project.
Example Call
https://geeklab.app/APIV1/v1/list/{geeklab.token}
Which would return a JSON like this where each child is an Project created under the account with the API token
{
0: {
"name":"name",
"genre":"genre",
"subgenre":"subgenre",
"appId":"12345",
"icon_path":"https://geeklab.app/images/appimg/icon_path"
}
Project call allows you to search for apps with specific genres, or subgenres as well as by date. The options are appended as GET parameters in the URL as such:
https://geeklab.app/APIV1/v1/list/{geeklab.token}?genre=[csv]&subgenre=[csv]
// Genre Options Provided below
// note that the genre GET parameter is an array of options you want to receive
genre={
âAR Appsâ,
âBooksâ,
âBusinessâ,
âEducationâ,
âEntertainmentâ,
âFinanceâ,
âFood & Drinksâ,
âHealth & Fitnessâ,
âMagazines & Newspapersâ,
âMedicalâ,
âMusicâ,
âNavigationâ,
âNewsâ,
âPhoto & Videoâ,
âProductivityâ,
âReferenceâ,
âShoppingâ,
âSocial Networkingâ,
âSportsâ,
âStickersâ,
âTravelâ,
âUtilitiesâ,
âWeatherâ,
âActionâ,
âRPGâ,
âRacingâ,
âShooterâ,
âSimulationâ,
âSportsâ,
âStrategyâ,
âHybrid Casinoâ,
âTraditional Casinoâ,
âArcadeâ,
âIdleâ,
âKidsâ,
âLifestyleâ,
âPartyâ,
âPuzzleâ
}
// Subgenre options Provided below
// note that the subgenre GET parameter is an array of options you want to receive
subgenre={
âBattle Royaleâ,
âBulletstormâ,
âFightingâ,
âMOBA / ARTSâ,
âOpen Worldâ,
âOther Actionâ,
âPhysics-Basedâ,
âPlatformerâ,
âRun & Gun Platformerâ,
âStrategyâ,
âAction RPGâ,
âIdle RPGâ,
âOther RPGâ,
âPuzzle Battleâ,
âTeam Battleâ,
âTurn Basedâ,
âCombat Racingâ,
âDrag Racingâ,
âKart Racingâ,
âOff-Road/Rally Racingâ,
âOther Racingâ,
âSimulation Racingâ,
âStunt Racingâ,
âFirst Personâ,
âOther Shooterâ,
âThird Personâ,
âVehicleâ,
âArcadeâ,
âManagement Simâ,
âOther Sportsâ,
âSimulationâ,
âBreed-Battleâ,
âBuild-Battleâ,
âCard-Battleâ,
âCity Battleâ,
âLane-Battleâ,
âOther Strategyâ,
âSummon-Battleâ,
âTower Defenceâ,
âHybridâ,
âReal Prizesâ,
âSlotsâ,
âPokerâ,
âOther Casinoâ,
âMahjongâ,
âGo-Stopâ,
âFish Hunterâ,
âBingoâ,
âAll-in-oneâ,
âOther Arcadeâ,
âPlatformerâ,
âRhythm & Musicâ,
âRunnerâ,
âShooterâ,
â.ioâ,
âASMRâ,
âAim/Shootingâ,
âOther Hyper Casualâ,
âPuzzle/Triviaâ,
âRunners/Racingâ,
âSimulationâ,
âBuildâ,
âResetâ,
âColoring & Drawingâ,
âEducationalâ,
âOther Kidsâ,
âCustomizationâ,
âInteractive Storyâ,
âRhythm & Danceâ,
âQuiz/Trivia/Wordâ,
âOther Partyâ,
âKaraokeâ,
âDiceâ,
âWordâ,
âSolitaireâ,
âRoom Escapeâ,
âPhysics Basedâ,
âOther Puzzleâ,
âMergeâ,
âMatch 3â,
âMatch + Buildâ,
âHidden Objectâ,
âChinese Card/Boardâ,
âCard/Boardâ,
âBubble Shooterâ,
âTime Managementâ,
âTamagotchiâ,
âSandboxâ,
âOther Simulationâ,
âManagementâ,
âLoveâ,
âLifeâ,
âCraftingâ,
âBuilderâ,
âBreeding/Mergeâ
}
đ List/Campaign
The campaign-level list call returns all the campaigns from one specific app, or if left empty, all the campaigns created in the account
Example Call:
https://geeklab.app/APIV1/v1/list/c/{geeklab.token}
Which would return a JSON like this where each child is a campaign created under the account with the API token
{
0: {
"name":"name",
"status":"{answer from list}",
"credited":"{answer from list}",
"date-created":"YYYY-MM-DD",
"appId":"12345",
"campaigntoken":"123456abcdef",
"trackinglink":"https://geeklab.app/store/link"
}
// POSSIBLE RETURNS FOR STATUS
{
"Draft",
"Learning",
"Collecting Data",
"Winner Found",
"Completed (user)",
"Completed",
}
// POSSIBLE RETURNS FOR CREDITED
{
"Yes",
"No"
}
Campaign call allows you to search for campaigns from specific apps as well as by date. The options are appended as GET parameters in the URL as such:
https://geeklab.app/APIV1/v1/list/c/{geeklab.token}?app=[app.token]
đ§âđ List/Variant
The variant-level list call returns all the variants from one specific campaign, or if left empty, all the variants created in the account
Example Call:
https://geeklab.app/APIV1/v1/list/v/{geeklab.token}
Which would return a JSON like this where each child is a campaign created under the account with the API token
{
0: {
"variantname":"Variant Name",
"variantdescription":"Variant description",
"name":"Name",
"subtitle":"Subtitle",
"platform":"platform",
"date-created":"YYYY-MM-DD",
"trackinglink":"https://geeklab.app/trackinglink",
"previewlink":"https://geeklab.app/previewlink",
"varianttoken":"123456abcdef",
}
A variant call allows you to search for variants from a specific campaign as well as by date. The options are appended as GET parameters in the URL as such:
[https://geeklab.app/APIV1/v1/list/v/{geeklab.token}?campaign=
âïž Retrieve
Retrieve API will return results per campaign. Unlike with the Geeklab dashboard, the API results are cached a few times a day.
Each of the retrieve calls will return the same parameters. App, Campaign, and Variant variables allow you to specify, at which level you want to receive the data.
All the returned values are integers
For App: [https://geeklab.app/APIV1/v1/retrieve/{geeklab.token}&app=appId
For Campaign: [https://geeklab.app/APIV1/v1/retrieve/{geeklab.token}&campaign=campaigntoken
For Variant: [https://geeklab.app/APIV1/v1/retrieve/{geeklab.token}&variant=varianttoken
{
"CVR":"123",
"CVR Decisive":"123",
"CVR Exploring":"123",
"Installs":"123",
"Installs Decisive":"123",
"Installs Exploring":"123",
"Impressions":"123",
"Impressions Decisive":"123",
"Impressions Exploring":"123"
}
Updated on: 13/03/2023
Thank you!