← BACK TO BUILDING
Personal tool2026Built

Keyword Planner CLI

Keyword Planner CLI

Real Google search volumes and keyword ideas from a terminal, saved to CSV, straight from Google's own Keyword Planner at no cost.

NOT PUBLIC · PERSONAL TOOL LOCAL TOOL. NO PROJECT SCREENSHOT IS SHOWN.

The problem

Google's Keyword Planner has the real search volumes, but it wants you clicking through an ad account one query at a time. I wanted the real numbers from a terminal, in a file I could hand straight to the next step.

What it does

Two commands. One gives keyword ideas from a few seed words, a page or a whole site; the other gives the volume for exact keywords. A query that returns results prints a table and saves a CSV with monthly volume, competition, the top-of-page bid range and a 12-month trend. India and English are the defaults, with flags for other countries and Hindi.

It is what showed me that, for Reportcards, the free quizzes carry the search volume rather than the local tuition pages: 'math quiz' is searched about 40,500 times a month in India against about 1,300 for 'coaching institute jaipur'. It also retargeted Arun Silver's buyer guides at the terms buyers actually type.

What it does, feature by feature

  • Keyword ideas. From seed keywords, a page URL or a whole site.
  • Exact volumes. Monthly searches for a list of exact keywords.
  • CSV out. Volume, competition, bid range in rupees and a 12-month trend, ready for a spreadsheet.
  • Any market. India and English by default, with flags for the US, UK, UAE, worldwide and Hindi.

Why it is built this way

It talks to the Google Ads API directly, as a read-only user on an ad account that runs no campaigns, so it spends nothing. Even with no ad spend, volumes come back as specific numbers, not ranges.

What was hard

Getting access at all. The API level Google hands out first blocks the keyword planning service entirely, so it needed Basic access on a verified Cloud project. The ad account also has to stay enabled with no campaigns running; if Google cancels it, every call fails until it is reactivated.

What it ships with

  • Real Google volumes
  • No paid research tool
  • Results saved to CSV

Stack

PythonGoogle Ads APICSV