Check Keyword Position Google API: A Practical Guide

What the Google API actually does

The Google Search Console API is the official, free way to check keyword positions for a site you own. Its Search Analytics endpoint returns four numbers per query and page: clicks, impressions, click-through rate, and average position. You can group and filter by query, page, country, device, date and search appearance, and the API returns up to 25,000 rows per request.

Three limits shape how you use it. First, it only works for properties you have access to — it cannot check competitors. Second, the data is typically two to three days old, so it cannot tell you where a page ranks right now. Third, average position is an average: it is the average of your topmost result's position across impressions, not a single live rank. A page that appeared at position 3 for half its impressions and position 9 for the other half shows an average position of 6, even though it was never actually at 6.

How to check a keyword position, step by step

1. Verify the property in Search Console. The API only works for a site you own and have verified, with OAuth access for the account making the call.
2. Pick the query and the page. Decide which keyword and which URL you are tracking. The API reports per query and page, so check the pair, not the keyword alone.
3. Call the Search Analytics endpoint. Request clicks, impressions, CTR and average position, filtered by your query and page, for the date range you need.
4. Read average position with its context. A position of 8 with 2,000 impressions means the page is shown often but low; a position of 2 with 10 impressions means it ranks well for a rare query. Impressions matter as much as the number.
5. Repeat on a schedule. Check weekly or monthly and record the numbers. A single reading is noise; a trend over eight weeks is a signal.
6. Act on the movement. Pages with high impressions and low clicks need a better title or description. Pages with low impressions need more links or better coverage of the topic.

A worked example: tracking five keywords for one site

Take a small business site tracking five keywords for its main service page. The team calls the API once a week and records the numbers in a spreadsheet.

The table shows where to act. "Small business CRM pricing" has 900 impressions at position 8.7 with only 22 clicks — the page is shown but not chosen, so the title and description are the fix. "Affordable CRM software" sits at 11.2, just off page one; a stronger page or a few good links could move it onto page one. "CRM for consultants" ranks at 2.4 with 350 impressions — it is already working, so the team leaves it alone. The numbers are illustrative, and the method is the point: impressions plus position plus clicks together say what to do next.

When to use a third-party SERP API instead

The Google API cannot check a competitor, and it cannot give a live rank. Third-party SERP APIs fill both gaps, and they charge per search.

• DataForSEO SERP API reports Google Organic results from $0.60 per 1,000 searches on its standard queue, with faster priority and live options at higher rates. It is pay-as-you-go with a $50 minimum top-up. Its pricing page could not be opened directly on 14 November 2026, so these figures are corroborated from recent checks of DataForSEO's own pricing page rather than a direct read today — confirm them on the vendor page before budgeting.
• SerpApi offers a free plan of 250 searches a month, then paid plans from $25 a month for 1,000 searches. Its pricing page could not be opened directly on 14 November 2026 either, so the same caution applies: confirm the figures on SerpApi's own pricing page before budgeting.

Use the Google API for your own site's trends — it is free and authoritative. Use a SERP API for competitor checks and live ranks, and only for the keywords where the answer changes a decision.

Mistakes to avoid with keyword position checks

• Checking competitors with Google's API. It cannot do that. Use a SERP API instead.
• Treating average position as a live rank. It is an average over impressions, and the data is days old. A page can move several places between checks.
• Tracking the keyword, not the query-page pair. The same keyword can show different pages. Track which URL ranks, or the number is meaningless.
• Checking daily and reacting. Positions move day to day. Weekly or monthly trends are the signal; daily movement is noise.
• Ignoring impressions. A position of 2 with 10 impressions is a small win. A position of 8 with 4,000 impressions is a bigger opportunity.
• Paying for data Google gives free. Your own site's positions, clicks and impressions are free from the Search Console API. Pay only for competitor and live data.

Five keyword position terms worth knowing

• Average position: the average of a page's topmost result position across impressions, as reported by Search Console.
• Impressions: how often a page appeared in search results, whether or not anyone clicked.
• CTR: click-through rate — clicks divided by impressions, as a percentage.
• Search Analytics: the Search Console API endpoint that returns clicks, impressions, CTR and position per query and page.
• SERP API: a third-party service that returns live search results for any keyword, usually charged per search.

For the wider tracking picture, see the best SEO rank checking software comparison and the Google Analytics audit guide. The marketing report metrics guide shows which numbers belong in a monthly report, and Adziq's analytics service page covers tracking setup if you want it run for you.

Common questions

Sources

• Search Console API pricing (Google)
• Search Console API limits and quotas (Google)
• Search Analytics query (Google Search Central)
• DataForSEO SERP API pricing
• SerpApi pricing

Adziq sells marketing services and does not accept payment for placement in its articles. See our editorial policy.