Skip to content

Keyword rank checker API for Google positions by city

Send a keyword, a domain and a location. The check searches Google's top 100 for that domain and returns its position, the URL that ranks and the SERP features on the page. 30 credits per check.

30 credits / checkIntelligenceCSV bulkMCP
POST/v1/keyword-rank-checker
{
  "success": true,
  "data": {
    "keyword": "email verification api",
    "domain": "example.com",
    "location": {
      "name": "United States",
      "type": "country",
      "country_code": "US"
    },
    "language": "en",
    "found": true,
    "position": 7,
    "ranking_url": "https://example.com/products/email-verification",
    "title": "Email verification API for signup forms",
    "results_checked": 100,
    "serp_features": [
      "ai_overview",
      "people_also_ask",
      "related_searches"
    ],
    "checked_at": "2026-11-19T09:30:11Z"
  },
  "meta": {
    "credits_used": 30,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}
[01/Response]

What you get back

The fields most teams branch on. The full response is in the sample on this page and in the API reference.

foundFoundWhether the domain appears anywhere in the top 100 results.
positionPositionThe domain's highest organic position, from 1 to 100. Null when it is not found.
ranking_urlRanking URLThe exact page on the domain that Google ranks for the keyword.
titlePage titleThe title Google shows for that page in the results.
serp_featuresSERP featuresFeatures present on the results page, such as an AI Overview or People Also Ask.
location.nameLocationThe country or city the search was run for.
checked_atChecked atTimestamp of the reading, for charting positions over time.
[02/Capabilities]

What Keyword Rank Checker does

01

Looks through the top 100

The check reads the first 100 organic results. You can follow a page climbing from position 64 as well as one defending position 2.

02

National or city-level readings

Pass a country for the national picture or a city for a local one. The two often disagree, which matters to any business that sells in specific places.

03

The page that ranks, not only the number

You get the URL Google chose for the keyword. If it is not the page you built for that term, two of your pages are competing with each other.

04

SERP features for context

The response lists what else is on the page, such as an AI Overview or a People Also Ask block. Position 3 under several features gets seen less than position 3 on a plain page.

[03/Try it]

See the response before you sign up

Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.

POST /v1/keyword-rank-checker30 credits / check

The site to find in the results.

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

One POST request

Send JSON with a Bearer key. The same key works for all 79 products.

curl -X POST https://api.1lookup.dev/v1/keyword-rank-checker \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"email verification api","domain":"example.com","country":"us"}'
Endpoint
POST /v1/keyword-rank-checker
Base URL
https://api.1lookup.dev
Request
keyworddomaincountry
Price
30 credits / check
Coverage
Global, down to city level
Bulk
CSV upload and bulk API
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Send clients a weekly rank report

Check each client's keyword set every week, store the positions and chart the movement. The ranking URL explains a lot of the jumps.

Track local rankings per branch

Run the same keyword for every city where you have a location. You will see which branches show up and which need work on their local pages.

Measure a page change

Record the position before you rewrite a page, then check again once Google has recrawled it. You get a before and after for the same keyword and location.

Keep an eye on a competitor

Put a competitor's domain in the request in place of your own. You learn where they rank and which of their pages does the ranking.

Google results shift with location and time. A position is a single reading for the location you asked for at the moment of the check.

[06/Cost]

30 credits / check

Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.

See pricing
PlanPer 1,000 creditsPer 1,000 checks
Starter $29/mo$4.83$145
Growth $99/mo$3.96$119
Pro $299/mo$3.32$99.67
Scale $799/mo$2.66$79.90
[07/FAQ]

Keyword Rank Checker questions

How deep does the check go?

It covers the top 100 organic results. If the domain is not among them, found is false and position is null. The product is priced per check, so a not-found reading still uses 30 credits.

Can I check a specific city?

Yes. Put a city in the location field, for example Austin, Texas, and the search runs for that place. Leave it as a country name for a national reading. Coverage is global, down to city level.

How much does a check cost?

30 credits for each keyword, domain and location combination. The same combination within 7 days returns the cached reading at no charge. Set fresh to true to take a new one.

How is this different from SERP Scraper?

SERP Scraper returns the results page for a query for 1 credit. Keyword Rank Checker goes 100 results deep for one domain, in a specific country or city, and tells you the position and URL. Use the first to read a page, the second to track a site.

Can I track a keyword list on a schedule?

Submit the list through a CSV upload or the bulk API whenever you want a reading. Scheduling is yours to set, from a cron job or a workflow tool, and each run gives you rows you can append to a history table.

[ Validate ][ Enrich ]
[Get started]

Run Keyword Rank Checker on your own data

Starter is $29 a month for 6,000 credits, enough for 200 checks a month.

[ Screen ][ Scrape ]