Web Araması

GET/v1/google/search1 kredi

Bir sorgu için Google web arama sonuçlarını döndürür: sayfa başına 10 sonuç, her biri başlık, URL ve açıklama içerir.

01Sorgu parametreleri

Ad	Tür	Açıklama
queryzorunlu	string	Arama ifadesi.
pageisteğe bağlı	integer	Sonuç sayfası, 1 ile 11 arasında.Varsayılan: `1`
date_postedisteğe bağlı	string	Sonuçları yakın bir dönemle sınırlar. `last-hour` şu an `last-day` gibi davranır.Kabul edilen değerler:`last-hourlast-daylast-weeklast-monthlast-year`
regionisteğe bağlı	string	İki harfli ülke kodu. Uyumluluk için kabul edilir; şu an sonuçları değiştirmez.

02İstek

curl "https://api.scrapesocial.ai/v1/google/search?query=golang+tutorial" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/google/search?query=golang+tutorial

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "results": [
    {
      "title": "Tutorial: Get started with Go - The Go Programming Language",
      "url": "https://go.dev/doc/tutorial/getting-started",
      "description": "In this tutorial, you'll get a brief introduction to Go programming. Along the way, you will: Install Go (if you haven't already). Write some simple \"Hello, ..."
    },
    {
      "title": "Go Tutorial - W3Schools",
      "url": "https://www.w3schools.com/go/",
      "description": "Well organized and easy to understand Web building tutorials with lots of examples of how to use HTML, CSS, JavaScript, SQL, PHP, Python, Bootstrap, ..."
    }
  ],
  "next_page": 2
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Sonuçlar `results` listesindedir; `next_page`, `page` parametresine verilecek bir sonraki sayfa numarasını tutar ve 11. sayfada ya da başka sonuç kalmadığında null olur. 1–11 dışında bir `page` veya tanımsız bir `date_posted` değeri ücretsiz 400 döner. Web arama motorları hiçbir şey eşleşmediğinde de gevşek ilgili sayfalar döndürür; bu yüzden yalnızca başlığında, özetinde veya URL'sinde sorgunun kelimelerini geçiren sonuçlar tutulur: hiçbir şeyle eşleşmeyen bir sorgu 0 krediyle boş liste döndürür.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.