CrawlForge
SEODataForSEO5 credits

serp_rank

Semak kedudukan domain dalam hasil organik Google untuk sesuatu kata kunci — kedudukan SERP sebenar, bukan susunan Custom Search. Mengembalikan kedudukan organik sasaran, URL kedudukan, dan setiap kedudukan yang dipegangnya. Dikuasakan oleh DataForSEO.

Kes Penggunaan

Penjejakan Kedudukan Kata Kunci

Pantau kedudukan halaman anda untuk kata kunci sasaran dari masa ke masa dan kesan kejatuhan kedudukan lebih awal

Pemantauan SERP Pesaing

Jejaki kedudukan domain pesaing untuk kata kunci yang penting bagi perniagaan anda

Audit Kedudukan SEO

Audit kedudukan organik merentas senarai kata kunci untuk mengutamakan kerja pada halaman dan kandungan

Semakan SEO Tempatan & Peranti

Bandingkan kedudukan mengikut lokasi dan desktop berbanding mobile untuk mengesan jurang geo atau peranti

Papan Pemuka Penjejakan Kedudukan

Salurkan kedudukan organik harian ke papan pemuka dan saluran paip pelaporan anda sendiri

Endpoint

POST/api/v1/tools/serp_rank
Auth Required
2 req/s pada pelan Free
5 credits

Parameters

NameTypeRequiredDefaultDescription
keyword
stringRequired-
Pertanyaan carian untuk menyemak kedudukan
Example: managed wordpress hosting
target
stringRequired-
Domain atau URL untuk dicari dalam hasil
Example: example.com
depth
numberOptional100
Berapa banyak hasil untuk diimbas (10-200; 100 = 1 halaman kos)
Example: 100
device
stringOptionaldesktop
Peranti untuk ditiru: "desktop" atau "mobile"
Example: mobile
location_name
stringOptionalUnited States
Lokasi, cth. 'United States' atau 'London,England,United Kingdom'
Example: United States
location_code
numberOptional-
Kod lokasi DataForSEO berangka (mengatasi location_name)
Example: 2840
language_code
stringOptionalen
Kod bahasa (cth. 'en')
Example: en
serp_rank mengukur kedudukan organik sebenar, bukan susunan Custom Search. Depth mengawal berapa banyak hasil diimbas — 100 hasil bersamaan satu halaman kos. Gunakan location_name/location_code dan device untuk menyemak kedudukan khusus geo dan peranti.

Contoh Permintaan

terminalBash
curl -X POST https://crawlforge.dev/api/v1/tools/serp_rank \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "depth": 100,
    "device": "desktop",
    "location_name": "United States",
    "language_code": "en"
  }'

Contoh Respons

200 OK1,450ms
{
  "success": true,
  "data": {
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "location": "United States",
    "language": "en",
    "device": "desktop",
    "depth": 100,
    "found": true,
    "rank": 3,
    "url": "https://example.com/",
    "all_positions": [
      3,
      27
    ],
    "results_scanned": 100,
    "checked_at": "2026-07-01T14:30:00Z"
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 1450
}
Field Descriptions
data.rankKedudukan organik terbaik (null jika sasaran tidak ditemui dalam depth)
data.urlURL kedudukan yang memegang kedudukan terbaik
data.all_positionsSetiap kedudukan organik yang dipegang sasaran dalam depth yang diimbas
data.foundSama ada sasaran muncul dalam depth yang diimbas
credits_used5 credits tetap setiap semakan (100 hasil = 1 halaman kos)
processing_timeSemakan biasanya selesai dalam 1-2 saat

Pengendalian Ralat

Keyword atau Target Hilang (400 Bad Request)

Kedua-dua keyword dan target diperlukan. Sediakan pertanyaan carian dan domain atau URL.

Depth Tidak Sah (400 Bad Request)

Depth mestilah antara 10 dan 200. Depth yang lebih besar mengimbas lebih banyak hasil.

Device Tidak Sah (400 Bad Request)

Device mestilah "desktop" atau "mobile".

Kuota Melebihi Had (429 Too Many Requests)

Pembekal SERP menguatkuasakan had harian. Naik taraf pelan anda untuk kuota lebih tinggi.

Petua Pro: Hantar domain kosong (example.com) sebagai target untuk memadankan setiap URL kedudukan pada domain tersebut. Gunakan location_code untuk penyasaran geo yang tepat apabila nama lokasi tidak jelas.

Kos Credit

5 credits
5 credits setiap semakan
Kos tetap untuk mengimbas sehingga 100 hasil. Credits dicaj hanya untuk semakan yang berjaya.

Apa yang Disertakan:

Kedudukan SERP organik sebenar (bukan susunan Custom Search)

URL kedudukan dan setiap kedudukan yang dipegang sasaran

Penyasaran lokasi dan bahasa

Peniruan peranti desktop dan mobile

Depth sehingga 200 hasil

Cadangan Pelan:

Pelan Free: 1,000 credits percubaan sekali sahaja = 200 semakan

Pelan Hobby: 5,000 credits = 1,000 semakan ($19/mo)

Pelan Professional: 50,000 credits = 10,000 semakan ($99/mo)

Alat Berkaitan

search_web
Cari Google dan dapatkan hasil SERP berstruktur (5 credits)
track_changes
Pantau halaman kedudukan untuk perubahan dari masa ke masa (3 credits)
analyze_content
Analisis halaman kedudukan untuk topik dan kebolehbacaan (3 credits)
deep_research
Penyelidikan berbilang sumber dengan analisis AI (10 credits)
Bersedia untuk mencuba serp_rank? Daftar percuma dan dapatkan 1,000 credits untuk mula menjejaki kedudukan anda.