# Google Partners & Developer Groups Directory (`xyrelith-data/google-partners-directory`) Actor

Search Google Ads partner agencies, Google Cloud partners and Google Developer Groups chapters, with certifications, tiers, competencies, addresses and events.

- **URL**: https://apify.com/xyrelith-data/google-partners-directory.md
- **Developed by:** [Xyrelith Data](https://apify.com/xyrelith-data) (community)
- **Categories:** Lead generation, Developer tools, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Partners & Developer Groups Directory

One actor for three public Google ecosystem directories: the Google Ads partner agency directory, the Google Cloud Partner Finder, and the worldwide Google Developer Groups chapter and event directory. Built for agency lead generation, partner research, competitive tracking, and community discovery.

No cookies, accounts, API keys, or proxy configuration are required.

### What you can scrape

| Mode | What it returns | Typical use |
|---|---|---|
| Google Ads partner agencies | About 23,000 agencies with website, full postal address, Premier flag, Search/Display/Video/Shopping/Apps certification flags, agency ID and Google Partners profile URL | Build agency lead lists, filter Premier partners, find certified agencies by market |
| Google Cloud partners | Partner name, tagline, description, tiers (Select/Premier/Diamond), competencies, programs, languages, office addresses, headquarters country and countries served | Vendor and implementation-partner research, territory mapping |
| GDG chapters | About 2,000 chapters with city, state, country, coordinates, language and chapter URL, filtered by region, country, city or chapter ID | Community outreach and developer-relations research |
| GDG chapter events | Upcoming and past events for selected chapters, with title, start/end time, status, URL and host chapter | Local event calendars and DevRel prospecting |
| Global upcoming GDG events | Upcoming events across all chapters, with event type, tags, description, image, host chapter and city | One global feed of developer events |

### Inputs

| Input | Default | Description |
|---|---|---|
| `mode` | `adsPartners` | `adsPartners`, `cloudPartners`, `gdgChapters`, `gdgChapterEvents` or `gdgUpcomingEvents`. |
| `maxItems` | `3` | Stop after this many records. |
| `adsCountry` | `any` | Any ISO 3166-1 alpha-2 country, or `any` for the whole Ads directory. |
| `adsCertification` | `any` | Any, Search, Display, Video, Shopping or Apps. |
| `adsPremierOnly` | `false` | Keep only Google Premier Partners. |
| `adsCompanyName` | – | Optional case-insensitive agency name filter. |
| `cloudKeyword` | – | Free-text search over Cloud partner names, taglines and descriptions. |
| `cloudCountry` | `any` | Country where the Cloud partner has an office. |
| `cloudCompetency` | `any` | A verified competency for the selected Cloud filter. |
| `cloudIndustry` | `any` | An industry competency for the selected Cloud filter. |
| `cloudTier` | `any` | Select, Premier or Diamond within a program path. |
| `cloudProgram` | `any` | Resellers, Distributors and the other Google Cloud partner programs. |
| `gdgRegion` | `any` | Any, Africa (Sub-Saharan), Europe/Middle East & North Africa, Asia/Oceania, Latin America or Northern America. |
| `gdgCountry` | `any` | Any ISO 3166-1 alpha-2 country. |
| `gdgCity` | – | Optional case-insensitive city filter. |
| `gdgChapterIds` | `[]` | Numeric chapter IDs, for example `1555` for GDG London. |
| `gdgEventScope` | `upcoming` | Upcoming, past or all events for the chapter-events mode. |
| `includeEventDetails` | `true` | Enrich GDG events with tags, event type, long description, image and attendance. |

The saved example is the cheapest useful run: three Google Ads agencies.

### Input examples

Ads agencies in the United States, Premier partners only:

```json
{
  "mode": "adsPartners",
  "adsCountry": "US",
  "adsPremierOnly": true,
  "maxItems": 500
}
```

Cloud partners with a Diamond tier in Germany:

```json
{
  "mode": "cloudPartners",
  "cloudCountry": "DE",
  "cloudTier": "tier_gcp_cosell+diamond",
  "maxItems": 100
}
```

Events for two GDG chapters:

```json
{
  "mode": "gdgChapterEvents",
  "gdgChapterIds": ["1555", "305"],
  "gdgEventScope": "upcoming",
  "maxItems": 50
}
```

The default prefill is the smallest useful run: three Google Ads agencies.

### Output

Every record is flat and human-readable, with `recordType` set to `adsPartner`, `cloudPartner`, `developerGroupChapter` or `developerGroupEvent`. Empty fields are omitted rather than written as null. Dates are ISO 8601. Country codes are ISO 3166-1 alpha-2 and country names are included beside them.

Common fields include `name`, `country`, `countryName`, `website`, `profileUrl` or `url`, `description`, `language`/`languages`, `tier`/`tiers`, `competencies`, `city`, `latitude`, `longitude`, `chapter`, event `startDate`/`endDate`/`status`/`tags`, and `scrapedAt`.

### How it works

The actor reads the public JSON APIs behind each directory. The Ads directory paginates 100 agencies per request. The Cloud Partner Finder uses Google's public `Echelon`-style JSON RPC and returns at most 30 partners per filter combination, so the actor partitions large Cloud runs across tiers and programs and de-duplicates by legal entity. GDG chapters come from one public chapter-region document; chapter events paginate 500 at a time; the global feed pages the public event index and enriches each event from its public event page.

### Limits

- The Google Cloud Partner Finder caps every filter combination at 30 partners. The actor widens coverage by adding tier and program partitions, but a single exact filter still tops out at 30. Use a country or program to focus a run.
- The Ads API exposes certification flags and addresses but not the extra profile claims shown on an individual Google Partners profile page (optimisation score, spend tier). Those are not part of the directory API and are not fabricated.
- Google Cloud "industries" are exposed as numeric industry IDs because the public API does not publish a label mapping. Use the industry filter for targeting; competencies and programs carry human-readable names.
- GDG event dates are in each event's local timezone, preserved as ISO 8601 offsets. The `upcoming` flag compares the start time to the current UTC time.
- Google Controls which partners, chapters and events are listed. The actor reports what the public directory reports and never invents records.

### FAQ

**Do I need an API key or cookies?** No. All three sources are public and the actor works with no credentials.

**Can I get every Google Cloud partner?** The public finder exposes the top 30 for any one filter. The actor combines many filter partitions to collect a larger set, but it cannot exceed the source's per-query cap for an exact filter. This is documented above rather than hidden.

**Can I schedule it?** Yes. The smallest run returns three Ads agencies and costs a fraction of a cent. Use larger `maxItems` only when you need the full result set.

**Are images hotlinked?** GDG chapter and event images are public Cloudinary URLs served without cookies. They are returned as absolute URLs.

# Actor input Schema

## `mode` (type: `string`):

Which Google public directory to scrape. Each mode reads its own input block below.

## `maxItems` (type: `integer`):

Stop after this many records. The Ads directory paginates in blocks of 100 and the Google Cloud Partner Finder returns at most 30 partners per filter combination.

## `adsCountry` (type: `string`):

Two-letter country code of any agency office. Leave as Any country to scan the whole directory.

## `adsCertification` (type: `string`):

Keep only agencies certified in this Google Ads area. Certifications combine with the other Ads filters (AND).

## `adsPremierOnly` (type: `boolean`):

Keep only Google Premier Partners (the top tier, about 14% of the directory).

## `adsCompanyName` (type: `string`):

Optional name filter, case-insensitive partial match. Example: `Devoteam`.

## `cloudKeyword` (type: `string`):

Free-text search over Google Cloud partner names, taglines and descriptions. Leave empty to list the top partners for the selected filters.

## `cloudCountry` (type: `string`):

Country where the partner has an office. Leave as Any country to use the default global ranking.

## `cloudCompetency` (type: `string`):

Verified Google Cloud competency. Each option includes its level (Competency or Advanced Competency).

## `cloudIndustry` (type: `string`):

Industry competency of the partner.

## `cloudTier` (type: `string`):

Partner tier and program path (Select, Premier or Diamond).

## `cloudProgram` (type: `string`):

Specialized Google Cloud partner program, such as Resellers, Distributors or a Google Cloud Ready program.

## `gdgRegion` (type: `string`):

GDG region. Leave as Any region to include every region.

## `gdgCountry` (type: `string`):

Country of the chapter or of the chapter hosting an event.

## `gdgCity` (type: `string`):

Optional case-insensitive city filter, e.g. `London`.

## `gdgChapterIds` (type: `array`):

Numeric GDG chapter IDs to target, e.g. `1555` for GDG London. Also used by the chapter-events mode; paste several to cover multiple chapters.

## `gdgEventScope` (type: `string`):

For the chapter-events mode: keep upcoming events, past events, or both. The global feed always returns upcoming events.

## `includeEventDetails` (type: `boolean`):

Fetch each event page for tags, event type, long description, image and attendance numbers. On by default for the complete global feed; turn it off for a faster, cheaper run.

## Actor input object example

```json
{
  "mode": "adsPartners",
  "maxItems": 3,
  "adsCountry": "any",
  "adsCertification": "any",
  "adsPremierOnly": false,
  "adsCompanyName": "",
  "cloudKeyword": "",
  "cloudCountry": "any",
  "cloudCompetency": "any",
  "cloudIndustry": "any",
  "cloudTier": "any",
  "cloudProgram": "any",
  "gdgRegion": "any",
  "gdgCountry": "any",
  "gdgCity": "",
  "gdgChapterIds": [],
  "gdgEventScope": "upcoming",
  "includeEventDetails": true
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with adsPartner, cloudPartner, developerGroupChapter and developerGroupEvent records.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "adsPartners",
    "maxItems": 3,
    "adsCountry": "any",
    "adsCertification": "any",
    "adsPremierOnly": false,
    "adsCompanyName": "",
    "cloudKeyword": "",
    "cloudCountry": "any",
    "cloudCompetency": "any",
    "cloudIndustry": "any",
    "cloudTier": "any",
    "cloudProgram": "any",
    "gdgRegion": "any",
    "gdgCountry": "any",
    "gdgCity": "",
    "gdgChapterIds": [],
    "gdgEventScope": "upcoming",
    "includeEventDetails": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("xyrelith-data/google-partners-directory").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "adsPartners",
    "maxItems": 3,
    "adsCountry": "any",
    "adsCertification": "any",
    "adsPremierOnly": False,
    "adsCompanyName": "",
    "cloudKeyword": "",
    "cloudCountry": "any",
    "cloudCompetency": "any",
    "cloudIndustry": "any",
    "cloudTier": "any",
    "cloudProgram": "any",
    "gdgRegion": "any",
    "gdgCountry": "any",
    "gdgCity": "",
    "gdgChapterIds": [],
    "gdgEventScope": "upcoming",
    "includeEventDetails": True,
}

# Run the Actor and wait for it to finish
run = client.actor("xyrelith-data/google-partners-directory").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "adsPartners",
  "maxItems": 3,
  "adsCountry": "any",
  "adsCertification": "any",
  "adsPremierOnly": false,
  "adsCompanyName": "",
  "cloudKeyword": "",
  "cloudCountry": "any",
  "cloudCompetency": "any",
  "cloudIndustry": "any",
  "cloudTier": "any",
  "cloudProgram": "any",
  "gdgRegion": "any",
  "gdgCountry": "any",
  "gdgCity": "",
  "gdgChapterIds": [],
  "gdgEventScope": "upcoming",
  "includeEventDetails": true
}' |
apify call xyrelith-data/google-partners-directory --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,xyrelith-data/google-partners-directory"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/CUbzf4LAW1FXaiTqQ/builds/Iy2O17n8LSkLKQHfQ/openapi.json
