Skip to main content
Intelligence

This keyword rank checker shows where a website ranks on Google in any country or city

Send a keyword and a website and get back its place among the top 100 Google results, the page that ranks, the top 10 results with your site marked and the special result blocks on the page. 30 credits per check that reads results.

30 credits per lookupSame credits as every other product
1Lookup Keyword Rank Checker API checking northpeakgear.example for the keyword best trail running shoes from Austin, Texas: number 7 among the top 100 Google results, the page that ranks and the top 10 results with the site marked

30

Credits per check

$148.50 per 1,000 on Starter

100

Results searched for your site

with the top 10 listed

Any city

Search from a country or a city

29 countries to choose from

1 day

Repeat checks are free

served from cache

A keyword and a website come back as a place on Google, the page that ranks and the top 10 results

Each number is a field your code receives, here for an invented outdoor gear store searched from Austin, Texas. The same fields come back as JSON in the API response below.

app.1lookup.io/api/v1/keyword-rank-checkerSample result
best trail running shoesnorthpeakgear.exampleAustin, Texas, US

Where the website ranks on Google

#7

On the first page
11050100

The page that ranks

Trail running shoes | North Peak Gear

northpeakgear.example/trail-running-shoes

Also ranks at #34: northpeakgear.example/guides/trail-shoe-fit

Results checked
100
Pages ranking
2
Results on Google
412M
Holds the snippet
No
The top 10 resultsYour site marked
  1. 1The 12 best trail running shoes we tested this yeartrailpace.example
  2. 2Best trail running shoes, picked by our editorsrunwell-review.example
  3. 3Trail running shoes buyer's guidemilemarker.example
  4. 4Trail shoes for rocky ground, rankedridgeline-gear.example
  5. 5How to choose trail running shoessummitsole.example
  6. 6Trail running shoes under $120dirtmile.example
  7. 7Trail running shoes | North Peak Gearnorthpeakgear.exampleYour site
  8. 8Our favorite trail runners of the yearstridelab.example
  9. 9Trail running shoes for men and womenpeakpath-shoes.example
  10. 10Waterproof trail running shoes testedwetfoot-lab.example

Also on the results page

  • People also ask
  • AI overview
  • Related searches
  • Videos

The other 90 results are searched for your site too, and the response carries the link to the Google page for the same search, 30 credits for all of it

Every check comes back as one record with the position, the ranking page and the top 10

A website written any way returns the same ranking

Paste a bare domain, a www address or a full page link. Each one is reduced to the site's own domain and its subdomains count, so one site is always one answer.

  • Bare domain, www or full link
  • Subdomains count as the same site
  • A bad value is refused before any charge

The position comes from the top 100 Google results

Your website is looked for in all 100 results. The answer is its place or a plain not found, and every further page of the same site that ranks is listed too.

  • A place from 1 to 100
  • Not found is a clear answer
  • Up to five further pages listed

The search can be made from a country or from a city

Choose any of 29 countries, or add a city with its state, like Austin, Texas, to see what a customer there sees. A language code changes the language of the search.

  • 29 countries to choose from
  • Any city, written with its state
  • 13 languages

The top 10 results show who sits above your website

The ten results at the top come back with their title, link and domain, and your website is marked in the list when it is one of them.

  • Title, link and domain of each result
  • Your site marked in the top 10
  • The number of results Google reports

The blocks on the results page show what else competes for the click

People also ask, an AI overview, videos, a local pack and the other special blocks come back by name, and the result says whether your site holds the featured snippet.

  • AI overview and people also ask
  • Featured snippet ownership
  • A link to the Google results page

A check that reads no results costs nothing

You are charged 30 credits only when search results come back. An error, a timeout and a place the check cannot search from cost 0 credits, and a repeat check within 1 day is free.

  • No results, no charge
  • Errors are never billed
  • Repeat checks within 1 day are free

A keyword and a website go in and a ranking report comes out

01

You send a keyword, a website and, if you like, a place

POST the keyword and the website in any spelling: a bare domain, a www address or a full page link. Add a country, or a city with its state, to search from there.

request

$ POST /api/v1/keyword-rank-checker

"keyword": "best trail running shoes"

"domain": "northpeakgear.example"

"city": "Austin, Texas"

02

We read the top 100 results and look for your website in all of them

The search is made from your country or city, the 100 results are read and every page from your website is picked out. Nothing is charged if no results come back.

processing

Website cleaned to its domain

Search made from the place you chose

100 results read

Your pages found and the top 10 listed

03

You get the position, the ranking page and the top 10 back as one JSON record

The place your website holds, the page that ranks, the ten results above and below it, and the special blocks on the results page.

200 OK

position7

ranking page/trail-running-shoes

results checked100

30 credits0 credits if no results

One endpoint turns a keyword and a website into a ranking report and works like every other 1Lookup call

Same authentication, same credit balance, and the same response envelope as every other 1Lookup product. If you have already integrated one endpoint, this one is a URL change.

POST /v1/keyword-rank-checker
curl -X POST https://app.1lookup.io/api/v1/keyword-rank-checker \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "best trail running shoes", "domain": "northpeakgear.example", "country": "US", "city": "Austin, Texas" }'

# country and city are optional, and a bare domain, a www address or a full page link all check the same site
#   -d '{ "keyword": "best trail running shoes", "domain": "https://www.northpeakgear.example/shoes" }'
200 OK
{
  "success": true,
  "data": {
    "classification": {
      "matched": true,
      "keyword": "best trail running shoes",
      "domain": "northpeakgear.example",
      "country_code": "US",
      "country_name": "United States",
      "city": "Austin,Texas",
      "found": true,
      "position": 7,
      "ranking_url": "https://www.northpeakgear.example/trail-running-shoes",
      "ranking_title": "Trail running shoes | North Peak Gear",
      "results_checked": 100,
      "searched_depth": 100,
      "pages_ranking": 2,
      "top_result_domain": "trailpace.example",
      "serp_features": ["People also ask", "AI overview", "Related searches", "Videos"],
      "owns_featured_snippet": false
    },
    "insights": {
      "keyword_rank_result": {
        "language": "en",
        "searched_depth": 100,
        "total_results": 412000000,
        "also_ranking": [
          { "position": 34, "url": "https://www.northpeakgear.example/guides/trail-shoe-fit", "title": "How trail running shoes should fit" }
        ],
        "top_results": [
          { "position": 1, "title": "The 12 best trail running shoes we tested this year", "url": "https://www.trailpace.example/shoes/1", "domain": "trailpace.example", "is_target": false },
          { "position": 2, "title": "Best trail running shoes, picked by our editors", "url": "https://www.runwell-review.example/shoes/2", "domain": "runwell-review.example", "is_target": false },
          { "position": 7, "title": "Trail running shoes | North Peak Gear", "url": "https://www.northpeakgear.example/trail-running-shoes", "domain": "northpeakgear.example", "is_target": true }
        ],
        "checked_at": "2026-10-22T18:04:11.000Z",
        "google_url": "https://www.google.com/search?q=best%20trail%20running%20shoes&hl=en&gl=US"
      }
    },
    "metadata": { "credits_used": 30, "cache_hit": false }
  }
}

A column of checks goes in and one row per check comes out

Upload a CSV with one check on each row, written as keyword | website | country | city, and download a result file with the position and the ranking page for every row.

rank-checks.csvYou upload
  1. 1rank_check
  2. 2trail running shoes | northpeakgear.example | US
  3. 3trail running shoes | northpeakgear.example | US | Austin; Texas
  4. 4waterproof trail shoes | northpeakgear.example | US
keyword-rank-results.csvYou download
rank_checkPositionPages RankingTop ResultCredits Used
trail running shoes | northpeakgear.example | US32trailpace.example30
trail running shoes | northpeakgear.example | US | Austin; Texas52trailpace.example30
waterproof trail shoes | northpeakgear.example | US121wetfoot-lab.example30

Ten more columns in the file, among them Status, Found, Ranking URL, Results Checked, City and Result Features.

One row in, one row out

Every check becomes one row, so 500 keywords become a spreadsheet of 500 rows you can sort by position.

The full top 10 is in the JSON export

The CSV carries the position, the ranking page and the counts. The top 10 results of every check, with their titles and links, are in the JSON file for the same job.

A check with no results costs 0 credits

A check that reads results costs 30 credits however long the list is, and a row where no results come back is free.

Every ranking report comes back with the same fields at one flat price

A website outside the top 100 comes back with found set to false and a null position, never a guess, and every check costs the same 30 credits.

It answers where the website ranks

  • found
  • position
  • ranking_url
  • ranking_title
  • pages_ranking
  • also_ranking[].position
  • also_ranking[].url

It describes the search that was made

  • keyword
  • domain
  • country_code
  • country_name
  • city
  • language

It lists the top 10 results

  • top_results[].position
  • top_results[].title
  • top_results[].url
  • top_results[].domain
  • top_results[].description
  • top_results[].is_target
  • top_result_domain

It names the blocks on the results page

  • serp_features[].type
  • serp_features[].label
  • serp_features[].owned
  • owns_featured_snippet

It sizes the search

  • searched_depth
  • results_checked
  • total_results

It says when the check was made and where to see it

  • checked_at
  • google_url
  • metadata.credits_used
  • metadata.cache_hit

SEO teams, agencies and local businesses check where a site ranks before they decide what to fix

SEO teams track a keyword's position every week without opening Google

Run the same list of keywords from a bulk file each Monday and chart the position column. A page that drops from 4 to 12 shows up in the file before it shows up in traffic.

Agencies show a client what customers in their own city see

Check the keyword from the client's city and from the capital. The two answers often differ, and the result carries the link to the Google page for the same search, so the proof is one click away.

Marketing teams size up competitors on the searches that matter

Run one keyword for your site and for three competitors, then read the places side by side. The top 10 list shows who holds the spots above you and which result blocks take the clicks.

Local businesses check how they rank in every town they serve

A plumber or a dentist with offices in five towns checks the same keyword from each town. A bulk file with a city on every row turns that into one report.

The same keyword checked from three cities shows where a website is strong and where it is weak

Each city returns its own place for the same website, so a local gap shows up as a number before it shows up in sales.

The same keyword, best trail running shoes, checked for northpeakgear.example from three cities: number 3 in Denver, number 7 in Austin and number 12 in Boston, so a local gap shows up as a number

These are the questions people ask before they run their first check

What does the Keyword Rank Checker return?

Send a keyword and a website and it returns the website's place among the top 100 Google results, or that it is not in them. It also returns the page that ranks with its title and link, up to five further pages of the same site, the top 10 results with your site marked, the special result blocks on the page such as people also ask or an AI overview, the country or city the search was made from and when it was checked.

Is this a keyword rank checker I can call from code?

Yes. You send a request with your 1Lookup API key and get the answer back as JSON, so a rank tracker, a report or a spreadsheet can ask the same question every week without anyone opening Google.

Can I check the ranking from a specific city?

Yes. Add a city written with its state or region, like Austin, Texas, and the search is made from there. Leave it out and the search is made from the country. There are 29 countries to choose from, and a language code such as en or es changes the language of the search.

How many results does it look through?

The top 100. Your website is looked for in all 100, and the top 10 are returned in full so you can see who sits above you. Pages from your site that rank further down are listed as further pages, and its subdomains count as the same site.

What happens when my website is not in the top 100?

You get a result with found set to false and the top 10 results, so you can see who holds the places you want. The check still costs 30 credits because the 100 results were read. When no search results come back at all, it costs 0 credits.

How much does a rank check cost?

30 credits per check that reads results, which is $148.50 per 1,000 checks on the Starter plan and $105.60 on Growth. A check where no results come back, an error and a timeout cost 0 credits, in the API, the dashboard and bulk jobs.

Do the positions match what I see in Google?

They are the places Google shows for a search made from that country or city at the moment of the check. Results move through the day and differ between places, so compare checks made from the same place. Every result carries the link to the Google page for the same search so you can look at it yourself.

Does it show AI overviews and featured snippets?

Yes. The special blocks on the results page come back by name, among them AI overview, featured snippet, people also ask, videos, images and local pack, and the result tells you whether your website holds the featured snippet.

How fresh is a check and how long does it take?

Each check is made live. A fresh check usually takes 5 to 20 seconds, so set your client timeout to 120 seconds and a slow one still returns its data. The same keyword, website and place checked again within 1 day is served from cache and is free.

Can I check a list of keywords at once?

Yes. Upload a CSV with one column named rank_check and write each check as keyword | website | country | city, with the country and city optional. You get one row per check with the position, the ranking page, the number of results checked, the top result and the result blocks. The top 10 results of each check are in the JSON export. Each check that reads results costs 30 credits.

Can I check my competitors as well as my own website?

Yes. The website can be any site, so you can run one keyword for your site and for three competitors and read their places side by side.

How is it different from the SERP Scraper?

The SERP Scraper, at 1 credit, returns one results page as rows. The Keyword Rank Checker answers where one website stands: it reads 100 results, works by country and city, and marks your site in the top 10. Teams use the SERP Scraper to read a page and the rank checker to track a position over time.

Here is how checking a keyword's rank with 1Lookup compares with rank trackers and search APIs

Each page sets a rival's plans and prices beside ours and says where the rival does the job better. Every figure carries its source and the date it was checked.

Check a keyword you care about and see where your website stands

Start a free trial, and your credits work across every product in the catalog.