An open-source Google Business Profile SDK with automatic OAuth refresh, pagination and retries.

Over the last few months I was working on a project that manages hundreds of Google Business Profile locations.

I expected the integration to be straightforward, but the API turned out to be much harder than I anticipated.

The biggest pain points were:

• OAuth access tokens expiring every hour

• Refresh token race conditions

• Manual pagination using nextPageToken

• Handling 429 rate limits and random 503 responses

• Writing the same boilerplate for every project

After solving these problems multiple times, I decided to extract everything into an open-source SDK.

Some features:

✅ Automatic OAuth token refresh

✅ Thread-safe token management

✅ Auto-pagination (fetch all pages automatically)

✅ Built-in retry with exponential backoff

✅ Fully typed TypeScript API

✅ Zero runtime dependencies

Example:

import { GBPClient, ConsoleLogger } from '@vitabletech/gbp-sdk';



const client = new GBPClient({

  clientId: 'YOUR_GOOGLE_CLIENT_ID',

  clientSecret: 'YOUR_GOOGLE_CLIENT_SECRET',

  refreshToken: 'YOUR_REFRESH_TOKEN',

  tokenStorage: 'file', 

// stores tokens in gbp-tokens.json

  logger: new ConsoleLogger(), 

// optional pluggable logger

});



async function main() {



// Automatically handles token generation and pagination!

  const accounts = await client.accounts.listAll();



  if (accounts.length > 0) {

    const accountName = accounts[0].name;

    const locations = await client.locations.listAll(accountName);



    console.log(`Found ${locations.length} locations for ${accountName}`);

  }

}



main();

The project is completely open source.

I'd really appreciate feedback from anyone who has worked with the Google Business Profile API.

What features would you want to see next?

GitHub: