API

API, web sitesindeki aramanın aynısını yapar ve sonuçları veri olarak döndürür: varsayılan olarak JSON, ayrıca XML, CSV, TSV, NDJSON ve düz metin. Tüm çağrılar salt okumadır: hiçbiri bir şey oluşturmaz ya da değiştirmez.

Temel URL https://api.publicwww.com

Tek komutla

curl -H "Authorization: Bearer $KEY" \
     "https://api.publicwww.com/v1/search?query=%22angular.min.js%22&per_page=3"
{
  "query": "\"angular.min.js\"",
  "page": 1,
  "per_page": 3,
  "total": 278,
  "total_pages": 93,
  "returned": 3,
  "truncated": false,
  "took_ms": 2,
  "results": [
    { "domain": "imgbox.com", "url": "https://imgbox.com/", "rank": 4187, "ranked": true }
  ]
}

Uç noktalar

Uç noktaYöntemlerNe yapar
/v1/search GET, POST Arama yapar. Parametreler, biçimler.
/v1/account GET Plan, kota ve sınırlar. Kotadan düşmez.
/v1/clusters GET, POST Kaydedilmiş web sitesi listeleri: bir aramadan ya da bir listeden oluşturun, birleştirin, sayfa kaynağından iletişim bilgilerini ve kimlikleri çıkarın. Kümeler.
/mcp POST Yapay zeka asistanları ve ajanları için MCP sunucusu: arama ve kümeler, aynı token'la araç olarak.
/ GET API'nin kendini tanıtması, hata kodları dahil. Anahtar gerektirmez.
/openapi.json GET Aynı bilgi, Postman, n8n, Make, Power Automate ve başka araçlara içe aktarılabilecek bir OpenAPI 3.1 tanımı olarak. Anahtar gerektirmez.

Ayrı bir dışa aktarma uç noktası yoktur. Toplu veri için büyük bir per_page değeriyle /v1/search kullanılır; ücretli planda bu değer bir milyon satıra kadar çıkar. Yanıt, üretildikçe akış halinde gönderilir.

Neyi garanti eder

  • Sonuçlar asla sessizce azaltılmaz. Bir tarayıcının günlük kotası dolduğunda web sitesi sessizce ücretsiz planın sınırlarına geçer ve daha az sonuç gösterir. Bir betik bunun olduğunu göremez; bu yüzden burada bu durum bir hatadır: eksiksiz görünen eksik bir yanıt değil, 429 quota_exceeded.
  • Eksik bir yanıt eksik olarak işaretlenir: her biçimde gövdede truncated, başlıklarda X-Truncated bulunur.
  • Sırası olmayan siteler bunu belirtir: rank: null ve ranked: false. Bir istemcinin gerçek ve çok büyük bir sıra sanabileceği dahili bir yer tutucu değer asla gönderilmez.
  • Sizi bekletmek yerine “bekleyin” der. İstekler çok hızlı gelirse bağlantı açık tutulmaz; yanıt hemen bir Retry-After başlığıyla döner.

Anahtar edinme

Profilinizde bir token oluşturun ya da bir uygulamanın OAuth 2.1 üzerinden sizin için token almasına izin verin. Ücretli bir plan gerekir; ayrıntılar için fiyatlandırma sayfasına bakın. Eski ?export= URL'lerini çağıran mevcut betikler hiçbir değişiklik olmadan çalışmaya devam eder; bkz. eski dışa aktarma URL'leri.

Sonraki Kimlik doğrulama