Google Ads API — Tool Design

Internal keyword research tool
built on the Google Ads API

BELFORTS LLC(合同会社BELFORTS) ·  https://bel-forts.com
Manager (MCC) account: 238-901-0145  ·  Contact: k_nakashima@bel-forts.com
Registered office: Miyamasuzaka Building 609, 2-19-15 Shibuya, Shibuya-ku, Tokyo 150-0002, Japan
このページについて。合同会社BELFORTSが Google Ads API を利用して構築している社内向けツールの設計と用途を公開しています。当社は自社で情報メディアおよびWebマーケティング事業を運営しており、どの市場・どのテーマに取り組むかを客観的な検索需要データにもとづいて判断するために、キーワードの過去実績データを参照します。取得したデータは社内の分析にのみ使用し、外部への提供・再販は行いません。広告キャンペーンの作成・運用・自動化は一切行いません。

01Company & business model

BELFORTS LLC is a Japanese company operating its own owned-media and web marketing business. We build and run our own content websites — for example our corporate site at bel-forts.com — and we decide which market niches to enter based on objective demand data rather than intuition.

We are an independent Google Ads developer building an internal tool for our own company only. The tool is not a product, service, or SaaS offered to third parties.

Legal nameBELFORTS LLC / 合同会社BELFORTS
RepresentativeMasaya Nakashima (中嶋 匡哉)
FoundedDecember 8, 2023
BusinessGenerative-AI & DX consulting / Web marketing / Development and operation of owned media
Websitehttps://bel-forts.com

02What the tool does

The tool is a small, internal, read-only research script used exclusively by our own team. It calls a single Google Ads API service to retrieve historical keyword planning metrics for a list of industry keywords in Japan, and stores the results in a CSV file for internal analysis.

  • API service used: KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics — read-only.
  • Retrieved fields: average monthly searches, competition, competition index, and top-of-page CPC bid estimates.
  • Targeting: geo = Japan (geoTargetConstants/2392), language = Japanese (languageConstants/1005).
  • The data is used internally to rank markets by search demand and monetization potential, and to decide which content topics and SEO pages to build for our own websites.

03Data flow

  1. An industry keyword list is prepared internally from public industry classifications.
  2. The script calls GenerateKeywordHistoricalMetrics in batches (read-only).
  3. Responses are written to raw_keyword_data.csv, stored on our own internal system.
  4. We screen and rank the results internally by demand and estimated monetization.
  5. The ranking informs the content plan for websites we own and operate ourselves.

04Access & intended audience

  • Audience: internal users only — our own company's team. Not a public or client-facing product.
  • All API calls run on our own manager (MCC) account 238-901-0145. We do not access any third-party Google Ads account.
  • Authentication uses OAuth 2.0 with our own credentials. The developer token is stored securely and is never shared or embedded in any distributed artifact.
  • Call volume is modest and batched — a few hundred keywords per run, rate-limited.

05What the tool does not do

  • It does not create, modify, manage, or automate advertising campaigns.
  • It does not manage or access any third-party or client Google Ads account.
  • It does not resell, redistribute, or expose the retrieved data to any external party.
  • It is not offered as a tool, SaaS, or service to external users.
  • It does not use the App Conversion Tracking and Remarketing API.

06Summary

This is a narrow, read-only, internal keyword-research tool operating on our own single manager account, used solely to inform the content strategy of websites we own. Our functioning company website is available at https://bel-forts.com, and questions about this tool can be sent to k_nakashima@bel-forts.com.