Google Business Profile SDKThe most complete TypeScript SDK for the Google Business Profile APIs.

✔ Automatic OAuth Refresh • ✔ TypeScript First • ✔ Auto Pagination • ✔ Retry Support • ✔ Rate Limiting • ✔ Generic Request API • ✔ Enterprise Ready

Quick Start

API Reference

Authentication

Zero-config OAuth 2.0 flow with automatic token refreshing and file/memory storage.

Auto Pagination

Never deal with `pageToken` again. Fetch thousands of locations and reviews automatically.

Custom Requests

Generic request API to access new Google endpoints the day they are released.

Middleware

Intercept requests and responses globally to add custom logging or transformations.

Type Safety

Full TypeScript definitions for all major endpoints to catch errors at compile time.

Error Handling

Detailed custom error classes like `RateLimitError` and `AuthenticationError`.

Quick Installation

npm

bash

npm install @vitabletech/gbp-sdk

Quick Example

typescript

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

const client = new GBPClient({
  clientId: process.env.GOOGLE_CLIENT_ID,
  clientSecret: process.env.GOOGLE_CLIENT_SECRET,
  redirectUri: 'http://localhost:3000/oauth/callback',
  refreshToken: process.env.GOOGLE_REFRESH_TOKEN,
});

// Automatically handles tokens, paginates through all pages,
// and returns all accounts as a strongly typed array.
const accounts = await client.accounts.listAll();