Hızlı yanıt
Bir SerpCrypto SERP API yanıtı neler içerir?
Her SerpCrypto yanıtı tek bir JSON nesnesidir: search_metadata (durum, motor, kullanılan krediler), search_parameters (uygulanan ayarlar), search_information ve ardından sonuç sayfasının her bölümü için bir blok; örneğin organic_results, ai_overview, people_also_ask veya local_results. Olmayan bölümler yalnızca eksik kalır. Bir sayfa $0,30/1K arama krediden başlayarak 1 kredidir; kripto ile ödeme, KYC olmadan.
Tam bir Google yanıtı nasıl görünür?
Aşağıdaki örnek, Birleşik Krallık'ta standing desk için yapılan bir Google aramasıdır ve her dizide tek öğeye indirgenmiştir. Gerçek bir yanıt, yaklaşık on organik sonuç ve o sorgu, konum ve cihaz için sayfanın gösterdiği diğer tüm blokları içerir.
{
"search_metadata": {
"id": "srch_2b81d0c6fa47",
"status": "success",
"engine": "google",
"created_at": "2026-10-22T10:02:31Z",
"credits_used": 1
},
"search_parameters": {
"engine": "google",
"q": "standing desk",
"gl": "gb",
"hl": "en",
"google_domain": "google.co.uk",
"device": "desktop",
"page": 1
},
"search_information": { "total_results": 52400000, "query_displayed": "standing desk" },
"ai_overview": {
"text": "A standing desk lets you work while standing or sitting…",
"references": [
{ "index": 1, "title": "How to choose a standing desk", "link": "https://www.example.co.uk/guide", "source": "Example Guide" }
]
},
"ads": [
{ "position": 1, "block": "top", "title": "Electric Standing Desks", "link": "https://shop.example.com/desks", "displayed_link": "shop.example.com", "description": "Free delivery on…" }
],
"organic_results": [
{
"position": 1,
"title": "Best standing desks 2026, tested",
"link": "https://www.example.co.uk/best-standing-desks",
"displayed_link": "www.example.co.uk › reviews",
"snippet": "We tested 14 electric and manual desks…",
"date": "12 Oct 2026",
"sitelinks": [ { "title": "Budget picks", "link": "https://www.example.co.uk/best-standing-desks#budget" } ]
}
],
"people_also_ask": [
{ "question": "Is it healthy to stand all day at a desk?", "snippet": "…", "title": "Standing at work", "link": "https://www.example.org/standing" }
],
"shopping_results": [
{ "position": 1, "title": "Example Desk Pro 140 cm", "price": "£299.00", "source": "Example Store", "link": "https://shop.example.com/desk-pro" }
],
"related_searches": [ { "query": "standing desk electric" }, { "query": "standing desk converter" } ],
"pagination": { "current": 1, "next_page": 2 }
}Yanıtımdan neden bazı bloklar eksik?
Çünkü sonuç sayfası onları göstermedi. Google, reklam, AI Overview, local pack veya top stories gösterip göstermeyeceğine sorgu, yer ve cihaz başına karar verir. SerpCrypto sayfanın gösterdiğini döndürür ve boş yer tutucular göndermek yerine gerisini dışarıda bırakır.
Her bloğu varsayılan değerle okuyun, aşağıdaki Python satırlarında olduğu gibi. Aynı kural bir bloğun içinde de geçerlidir: date veya sitelinks gibi opsiyonel field'lar yalnızca bunlara sahip sonuçlarda görünür.
data = response.json()
# A block is present only when the results page shows it: read with a default.
overview = data.get("ai_overview") or {}
organic = data.get("organic_results", [])
questions = [item["question"] for item in data.get("people_also_ask", [])]
if overview:
print("AI Overview sources:", [ref["link"] for ref in overview.get("references", [])])
print(len(organic), "organic results,", len(questions), "questions")search_metadata içinde ne var?
| Alan | Tür | Açıklama |
|---|---|---|
id | string | Aramanın tanımlayıcısı. Destek ekibiyle iletişime geçerken bunu belirtin. |
status | string | 200 yanıtındaki success. |
engine | string | Aramayı yürüten motor. |
created_at | string | Aramanın zamanı, UTC olarak ISO 8601. |
credits_used | integer | Bu aramanın harcadığı krediler: başarıda 1. |
search_parameters ve search_information nedir?
Sonuçlarınızla birlikte search_parameters saklayın: bir sıralamanın tam olarak hangi ülke, dil, yer ve cihazdan geldiğini kaydeder.
| Alan | Tür | Açıklama |
|---|---|---|
search_parameters | object | Uygulanan parametreler, varsayılanlar doldurulmuş halde: engine, q, gl, hl, location, google_domain, device, page ve gönderdiğiniz diğerleri. |
search_information.total_results | integer | Motorun görüntülediği sonuç sayısı, görüntülediği durumlarda. Kesin bir rakam değil, tahmini bir değer. |
search_information.query_displayed | string | Sonuç sayfasının gösterdiği haliyle sorgu. |
organic_results hangi alanlara sahiptir?
Organik sonuçlar ücretli olmayan web sonuçlarıdır. Bing'de organic_results aynı yapıya sahiptir.
| Alan | Tür | Açıklama |
|---|---|---|
position | integer | Sonucun bu sayfadaki bu blok içindeki sırası, 1'den başlayarak. |
title | string | Mavi bağlantı başlığı. |
link | string | Sonucun URL'si. |
displayed_link | string | Başlığın altında gösterilen URL veya breadcrumb. |
snippet | string | Başlığın altında gösterilen metin. |
date | string | Snippet'in yanında gösterilen tarih, sayfada yazdığı şekilde. İsteğe bağlı. |
sitelinks | array | Sonucun altında gösterilen ek bağlantılar, her biri title ve link ile birlikte. İsteğe bağlı. |
AI Overview nasıl döndürülür?
ai_overview yalnızca Google o sorgu ve yer için bir AI Overview gösterdiğinde bulunur. Birçok sorguda hiç yoktur.
| Alan | Tür | Açıklama |
|---|---|---|
ai_overview.text | string | AI Overview'ın sayfada gösterildiği şekliyle metni. |
ai_overview.references[].index | integer | Kaynağın genel bakış içindeki sırası. |
ai_overview.references[].title | string | Alıntılanan sayfanın başlığı. |
ai_overview.references[].link | string | Alıntılanan sayfanın URL'si. |
ai_overview.references[].source | string | Sitenin gösterildiği şekliyle adı. |
ads ve people_also_ask neleri içerir?
| Alan | Tür | Açıklama |
|---|---|---|
ads[].position | integer | Kendi bloğu içindeki sıra. |
ads[].block | string | Sayfanın top veya bottom. |
ads[].title, link, displayed_link | string | Reklamın başlığı, açılış sayfası URL'si ve gösterilen URL'si. |
ads[].description | string | Reklam metni. |
people_also_ask[].question | string | Sorunun görüldüğü hali. |
people_also_ask[].snippet | string | Soru açıldığında gösterilen yanıt metni. |
people_also_ask[].title, link | string | Yanıtın geldiği sayfanın başlığı ve URL'si. |
Hangi diğer Google blokları görünebilir?
| Blok | Alanlar | Nedir |
|---|---|---|
local_results | position, title, address, rating, reviews, type | Yerel paket: konum niyeti olan sorgular için harita üzerindeki işletmeler. |
knowledge_graph | title, type, description, source.name, source.link | Bir kişi, yer, şirket veya şey hakkındaki bilgi paneli. |
top_stories | title, link, source, date | Bir karusel içinde gösterilen haber makaleleri. |
inline_videos | title, link, source, duration | Web sonuçları içinde gösterilen video sonuçları. |
shopping_results | position, title, price, source, link | Web sonuçları içinde gösterilen ürün listelemeleri. |
related_searches | query | Sayfanın alt kısmında önerilen aramalar. |
pagination | current, next_page | Geçerli sayfa numarası ve varsa bir sonraki sayfa. |
Diğer motorlar ne döndürür?
Her dikey aynı çerçeveyi korur ve kendi dizisini ekler. Google Maps'te local_results, bir web aramasının yerel paketinden daha zengindir.
engine | Ana dizi | Alanlar |
|---|---|---|
google_news | news_results | position, title, link, source, date, snippet, thumbnail |
google_images | images_results | position, title, original, original_width, original_height, thumbnail, source, link |
google_maps | local_results | position, title, place_id, address, phone, website, rating, reviews, type, hours, gps_coordinates.latitude, gps_coordinates.longitude |
google_shopping | shopping_results | position, title, price, extracted_price, currency, source, link, delivery, rating, reviews |
bing | organic_results, related_searches | Google organik sonuçlarıyla aynı alanlar |
Fiyatlar, puanlar ve tarihler nasıl yazılıyor?
Sayfa değerleri metin olarak yazdıysa değerler sayfanın kullandığı biçimi korur. price, para birimi simgesiyle birlikte bir dizedir, örneğin £299.00 ve Google Shopping, extracted_price değerini bir sayı, currency değerini de bir kod olarak ekler. rating bir sayıdır ve reviews bir tam sayıdır. date gibi tarihler sayfada yazıldığı gibi kalır, örneğin 12 Oct 2026 veya 3 days ago, dolayısıyla bir zaman damgasına ihtiyacınız varsa bunları kendi kodunuzda ayrıştırın.
Birden fazla sayfa arasında genel bir sıralama nasıl oluştururum?
Sayfa numarasını her sonuçla birlikte saklayın. position, tek bir sayfadaki blok içindeki sırayı verir ve search_parameters.page hangi sayfa olduğunu söyler. Google'ın Eylül 2025'te num=100 değerini dikkate almayı bırakmasından bu yana sunduğu gibi sayfa başına yaklaşık 10 organik sonuç; her ek sayfa bir kredi daha.
Sıralama takibi için çoğu ekip her anahtar kelime ve gün için link, position, page, gl, location, device ve created_at tutar. Bu, bir sıralamayı grafiklendirmek ve bir değişikliği konuma veya cihaza göre açıklamak için yeterlidir. Tam yöntem için sıralama takibi bölümüne bakın.
Yanıt biçimi soruları
Alan adlandırması kararlı mı?
Evet, sürüm 1 içinde. Yeni bloklar veya alanlar eklenebilir, bu yüzden bilmediğiniz anahtarları yok sayın. Bir alanın kaldırılması veya yeniden adlandırılması, yolda yeni bir sürümle gelir, örneğin /api/v2/.
Sayfanın ham HTML'ini alabilir miyim?
Hayır. Sürüm 1 yalnızca ayrıştırılmış JSON döndürür. Ayrıştırılmış bloklar çoğu aracın ihtiyacını karşılar: sonuçlar, reklamlar, sorular, AI Overview, yerel paket ve bilgi paneli.
Neden total_results saydığımdan farklı?
Bu, motorun yazdırdığı tahmindir, sayfalayarak ulaşabileceğiniz sonuçların sayısı değildir. Sayfalar bu sayıdan çok önce biter; başka bir sayfa olup olmadığını bilmek için pagination.next_page kullanın.
Organik sonuç içermeyen bir yanıt bir kredi harcar mı?
Evet, arama başarılı olduysa: boş bir sayfa da sonuçtur. Yalnızca hatalar ücretsizdir. 1 kredi = desteklenen herhangi bir motorda bir sayfa sonuç döndüren 1 başarılı arama isteği. Başarısız olan istek ücretlendirilmez.