Submit Keywords & Retrieve Rankings via JSON
Utilize JSON, the most common and simple method for API calling, to submit a URL and the keywords you want to track.
Retrieve ranking positions straight into your database, or write custom logic and alerts based on where each keyword ranks.
Track Rankings Across Countries & Devices
Check keyword positions in any supported country, on desktop or mobile.
Get results via Custom Callback or Queue-And-Wait: we call your endpoint the moment they’re ready, or you poll the request ID.
Real-Time Results, Built for Volume
Every request runs a live SERP check, so you get real search results exactly as they appear right now — not stale, cached positions.
See what a real searcher sees in each supported country, on desktop or mobile, for accurate, location-specific rankings.
Built for volume: track up to 100 keywords per request and scale your plan as your needs grow, comfortably handling peak reporting periods.
Track Rankings in 20 Countries
- Avustralya
- Belçika
- Brezilya
- Kanada
- Danimarka
- Fransa
- Almanya
- Hindistan
- İtalya
- Japonya
- Meksika
- Hollanda
- Norveç
- Polonya
- Singapur
- Güney Afrika
- İspanya
- İsveç
- United Kingdom
- United States
Örnek API Çağrıları
Create Rank Tracking Request (without Callback)
curl --location --request POST "https://api.seoptimer.com/v1/rank/create" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "x-api-key: XXXXXX" \
--data '{"url":"example.com","keywords":["your first keyword","your second keyword"],"country_code":"US","device":"mobile"}'
{
"success": true,
"data": {
"id": 4,
"url": "https://example.com",
"keywords": [
"your first keyword",
"your second keyword"
],
"country_code": "US",
"callback": "",
"device": "mobile"
}
}
Get Result
curl --location --request GET "https://api.seoptimer.com/v1/rank/get/4" \
--header "Content-Type: application/json" \
--header "x-api-key: XXXXXX" \
--data ""
{
"success": true,
"data": {
"id": 4,
"status": "completed",
"input": {
"url": "https://example.com",
"keywords": [
"your first keyword",
"your second keyword"
],
"country_code": "US",
"callback": "",
"device": "mobile"
},
"updated_at": "2026-07-06 17:15:24",
"output": {
"results": [
{
"keyword": "your first keyword",
"position": 1,
"url": "https://example.com/about"
},
{
"keyword": "your second keyword",
"position": null,
"url": "https://example.com"
}
]
}
}
}
{
"success": true,
"data": {
"id": 4,
"status": "completed",
"input": {
"url": "https://example.com",
"keywords": [
"your first keyword",
"your second keyword"
],
"country_code": "US",
"callback": "",
"device": "mobile"
},
"updated_at": "2026-07-06 17:15:24",
"output": {
"results": [
{
"keyword": "your first keyword",
"position": 1,
"url": "https://example.com/about"
},
{
"keyword": "your second keyword",
"position": null,
"url": "https://example.com"
}
]
}
}
}
API Specification
Send a POST request to /v1/rank/create with your API key in the x-api-key header. Request fields:
| Field | Required | Tür | Varsayılan | Notes |
|---|---|---|---|---|
url |
Evet | string | — | The website URL or domain to track rankings for. |
keywords |
Evet | array or comma-separated string | — | The keywords to check — up to 100 per request. |
country_code |
Hayır | string (ISO 2-letter) | US |
One of the 20 supported countries (e.g. US, GB, AU, DE). |
device |
Hayır | string | desktop |
Either desktop or mobile. |
callback |
Hayır | string (URL) | — | A webhook URL we POST the results to when the check completes. |
Rank Tracking API Plans
- Fiyat$50 Aylık
- Keyword Rank Tracking Positions a Month500
- URL'leri JSON ile Gönder
- JSON ile Veri Noktalarını Al
- Fiyat$100 Aylık
- Keyword Rank Tracking Positions a Month1500
- URL'leri JSON ile Gönder
- JSON ile Veri Noktalarını Al
- Fiyat$200 Aylık
- Keyword Rank Tracking Positions a Month5000
- URL'leri JSON ile Gönder
- JSON ile Veri Noktalarını Al
- FiyatAylık $37.50Yıllık $450 olarak faturalandırılır
- Keyword Rank Tracking Positions a Month500
- URL'leri JSON ile Gönder
- JSON ile Veri Noktalarını Al
- FiyatAylık $75Yıllık $900 olarak faturalandırılır
- Keyword Rank Tracking Positions a Month1500
- URL'leri JSON ile Gönder
- JSON ile Veri Noktalarını Al
- FiyatAylık $150Yıllık $1,800 olarak faturalandırılır
- Keyword Rank Tracking Positions a Month5000
- URL'leri JSON ile Gönder
- JSON ile Veri Noktalarını Al
Kullanım Durumları
Kimler için?
Dijital Ajanslar
Track keyword rankings for every client automatically and feed live position data into your own dashboards and white label reports.
SaaS & Custom Solution Owners
Add live keyword ranking data to your own product, or build a bespoke integration on top of the Rank Tracking API.
Blog Yazarları ve Araştırmacılar
Measure how content ranks over time, spot trends and compare keyword performance across large sets of terms.
SEOptimer neden diğer araçlardan daha iyi?
Bir web sitesini gerçek bir kullanıcı gibi, sadece kod okuyan bir bot yerine bir tarayıcı kullanarak görüntüleriz ve diğer araçların kaçıracağı dinamik içerik ve komut dosyalarını görebiliriz.
Bir web sitesinde sadece Sayfa İçi SEO'dan çok daha fazlası vardır. Sadece SEO için değil, Kullanılabilirlik ve Erişilebilirlik için de önemli olan bir dizi faktöre bakarız.
PDF raporlarımız hızlı çalışır – sayfaların çoğu tamamen denetlenebilir ve PDF 20 saniye içinde oluşturulabilir.
Raporlar ve Gömme aracı genelinde Yazı Tipleri, Renkler, Görüntü Düzenleri, İçerik, Kontroller ve Bölümler, Rapor Metni, E-posta İçeriği özelleştirilebilir.