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

1 req/s pada pelan Free

5 credits

Parameters

Name	Type	Required	Default	Description
keyword	string	Required	-	Pertanyaan carian untuk menyemak kedudukan Example: managed wordpress hosting
target	string	Required	-	Domain atau URL untuk dicari dalam hasil. Dipadankan mengikut hos, bukan URL tepat: URL diringkaskan kepada hosnya, dan mana-mana halaman pada hos itu atau subdomainnya dikira Example: example.com
depth	number	Optional	30	Berapa banyak hasil untuk diimbas (10-200, lalai 30); imbasan lebih dalam mengambil masa lebih lama. Kos kekal 5 credits pada sebarang kedalaman Example: 100
device	string	Optional	desktop	Peranti untuk ditiru: "desktop" atau "mobile" Example: mobile
location_name	string	Optional	United States	Lokasi, cth. 'United States' atau 'London,England,United Kingdom' Example: United States
location_code	number	Optional	-	Kod lokasi DataForSEO berangka (mengatasi location_name) Example: 2840
language_code	string	Optional	en	Kod bahasa (cth. 'en') Example: en

serp_rank mengukur kedudukan organik sebenar, bukan susunan Custom Search. Depth mengawal berapa banyak hasil diimbas; caj kekal 5 credits pada sebarang kedalaman. Gunakan location_name/location_code dan device untuk menyemak kedudukan khusus geo dan peranti. Satu semakan ialah satu sampel: Google boleh memberikan set hasil yang berbeza untuk pertanyaan yang sama dalam beberapa minit, jadi bandingkan beberapa semakan, sebaik-baiknya pada hari yang berbeza, sebelum membaca perubahan kedudukan.

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 OK6,200ms

{
  "success": true,
  "data": {
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "location": "United States",
    "language": "en",
    "device": "desktop",
    "depth": 30,
    "found": true,
    "rank": 3,
    "url": "https://example.com/",
    "all_positions": [
      3,
      27
    ],
    "results_scanned": 30,
    "se_results_count": 1370000,
    "check_url": "https://www.google.com/search?q=managed+wordpress+hosting&num=30&hl=en&gl=US",
    "checked_at": "2026-07-01T14:30:00Z"
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 6200
}

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

data.se_results_countJumlah hasil yang Google berikan untuk pertanyaan itu. Dua semakan dengan jumlah yang sangat berbeza datang daripada set hasil yang berbeza

data.check_urlHalaman hasil Google yang disemak oleh DataForSEO, untuk anda lihat SERP itu sendiri

credits_used5 credits tetap setiap semakan, pada sebarang kedalaman

processing_timeSemakan biasanya mengambil masa 5-15 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.

Tamat Masa Penyedia (504 Gateway Timeout)

Carian SERP menjalankan pertanyaan Google secara langsung dan boleh melebihi had masa ketika beban tinggi. Tiada kredit dicaj — sila cuba semula.

Carian Tidak Tersedia (502 / 503)

Penyedia SERP tidak dapat dihubungi, telah mencapai had kadar, atau tidak dikonfigurasikan pada penempatan ini. Tiada kredit dicaj.

Petua Pro:

target dipadankan mengikut hos, bukan URL tepat: https://example.com/pricing melaporkan kedudukan terbaik mana-mana halaman pada example.com atau subdomainnya, dan url menamakan halaman yang memegangnya. Hantar subdomain (blog.example.com) untuk menyempitkan padanan. Gunakan location_code untuk penyasaran geo yang tepat apabila nama lokasi tidak jelas.