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.
{
"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"
}
}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.What Keyword Rank Checker does
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.
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.
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.
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.
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.
Fill in the field and run the lookup to see what comes back.
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)
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.
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| Plan | Per 1,000 credits | Per 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 |
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.
Related products
SERP Scraper
Live Google results for any query: organic, People Also Ask and related searches.
Keyword Metrics
Search volume, CPC, difficulty and AI Overview presence for a keyword.
Domain Authority
Authority score, referring domains and backlink totals for any domain.
Run Keyword Rank Checker on your own data
Starter is $29 a month for 6,000 credits, enough for 200 checks a month.