# SERP API hızlı başlangıç: curl, Python ve Node.js ile ilk aramanız > SerpCrypto SERP API aramanızı curl, Python veya Node.js ile çalıştırın: anahtar alın, endpoint çağırın, JSON'u okuyun. KYC yok, kripto ödeme. - URL: https://serpcrypto.com/tr/docs/ - Son güncelleme: 2026-10-22 - Yayıncı: SerpCrypto (https://serpcrypto.com) Tek bir HTTPS endpoint, tek bir API anahtarı, başarılı her arama için bir kredi. Bu sayfa sizi boş bir hesaptan ayrıştırılmış bir Google arama sonuçları sayfasına götürür, ardından geri kalan her şey için referansa yönlendirir. **Hızlı yanıt — SerpCrypto ile ilk SERP API isteğimi nasıl yaparım?** Bir kredi pack'i satın alın, kontrol panelinizden API anahtarını kopyalayın ve `Authorization: Bearer YOUR_KEY` başlığıyla `GET https://serpcrypto.com/api/v1/search?q=your+query` gönderin. **SerpCrypto** sonuç sayfasını JSON olarak döndürür ve yalnızca arama başarılı olduğunda 1 kredi tahsil eder. 10.000 arama $7,50 tutarındadır, KYC olmadan kripto ile ödenir ve krediler hiç süresi dolmaz. ## API'ye bir bakışta | Özellik | Değer | | --- | --- | | Temel URL | `https://serpcrypto.com/api/v1` | | Arama | `GET https://serpcrypto.com/api/v1/search` | | Krediler | `GET https://serpcrypto.com/api/v1/credits` (ücretsiz) | | Kimlik doğrulama | Authorization header'ında (Bearer) veya api_key sorgu parametresinde bir API anahtarı | | Motorlar | Google, Google News, Google Images, Google Maps (yerel sonuçlar), Google Shopping ve Bing | | Faturalandırma | 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 | | Kredi geçerliliği | Ön ödemeli arama kredileri hiçbir zaman sona ermez: kullanılmayan aramalar siz kullanana kadar hesabınızda kalır | | Biçim | HTTPS üzerinden JSON, UTF-8 | ## API anahtarını nasıl alırım? Dört adım. Kimlik yok, selfie yok, belge yok ve istemediğiniz sürece e-posta yok. 1. **Hesap açın** — Hesap numarasıyla giriş; email isteğe bağlı. Hesap numarasını bir parola yöneticisine kaydedin: giriş bilginiz odur. 2. **Kripto ile bakiye yükleyin** — En az $25 BTC, USDT, USDC, ETH, SOL, LTC gönderin. Bakiye, ödeme sayfasında listelenen ağ onaylarından sonra hesaba geçer. 3. **Bir kredi pack'i satın alın** — $7,50 için 10.000 arama her motoru test etmeye yeter. Daha büyük pack'ler oranı $0,30/1K arama seviyesine düşürür. Fiyatlandırmaya bakın. 4. **Anahtarınızı kopyalayın** — Onaylanmış kripto bakiyenizden bir kredi paketi satın aldığınız anda API anahtarınız dashboard'ınızda görünür. Anahtarınızı SERPCRYPTO_API_KEY adlı bir ortam değişkeninde tutun, asla bir kod deposunda değil. ## İlk aramamı curl ile nasıl çalıştırırım? Anahtarı bir kez dışa aktarın, ardından tek bir GET isteği gönderin. `--data-urlencode` ile birlikte `-G` bayrağı sorgu dizesini oluşturur ve boşlukları ve aksanları sizin için kodlar. Yanıt tek bir JSON belgesidir ve `jq` onu bir terminalde okunabilir tutar. Örnek, varsayılan motor olan Google'dan İngilizce olarak ABD sonuçlarını ister. `q`, `gl` veya `hl` değiştirin ve yeniden çalıştırın: başarılı her çalıştırma bir kredi kullanır. *curl + jq: ilk üç organik sonuç* ```bash export SERPCRYPTO_API_KEY="paste-your-key-here" curl -sG "https://serpcrypto.com/api/v1/search" \ -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \ --data-urlencode "q=best espresso grinder" \ -d gl=us -d hl=en | jq '.organic_results[:3]' ``` ## Aynı aramayı Python'da nasıl çalıştırırım? Herhangi bir HTTP istemcisi kullanın. `requests` ile parametreleri bir sözlük olarak ve anahtarı başlıkta geçirin. `raise_for_status()`, yanlış bir anahtar için `401` gibi bir hata yanıtını yakalayabileceğiniz bir istisnaya dönüştürür. *requests ile Python 3.9+* ```python import os import requests API_URL = "https://serpcrypto.com/api/v1/search" API_KEY = os.environ["SERPCRYPTO_API_KEY"] response = requests.get( API_URL, params={"q": "best espresso grinder", "gl": "us", "hl": "en"}, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=60, ) response.raise_for_status() data = response.json() print("credits used:", data["search_metadata"]["credits_used"]) for result in data.get("organic_results", [])[:3]: print(result["position"], result["title"], result["link"]) ``` ## Peki Node.js'te? Node.js 18 ve sonrası `fetch` ile birlikte gelir, bu yüzden herhangi bir paket gerekmez. Üst düzeyde `await` kullanmak için dosyayı `.mjs` uzantısıyla kaydedin, ardından `node first-search.mjs` çalıştırın. *Yerleşik fetch ile Node.js 18+* ```javascript // first-search.mjs (Node.js 18 or later: fetch and top-level await are built in) const API_URL = "https://serpcrypto.com/api/v1/search"; const params = new URLSearchParams({ q: "best espresso grinder", gl: "us", hl: "en" }); const response = await fetch(`${API_URL}?${params}`, { headers: { Authorization: `Bearer ${process.env.SERPCRYPTO_API_KEY}` }, }); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${await response.text()}`); } const data = await response.json(); console.log("credits used:", data.search_metadata.credits_used); for (const result of (data.organic_results ?? []).slice(0, 3)) { console.log(result.position, result.title, result.link); } ``` ## Kalan kredimi nasıl kontrol ederim? Aynı anahtarla `GET https://serpcrypto.com/api/v1/credits` çağırın. Ücretsizdir ve üç sayı döndürür: kalan krediler, bugün kullanılan krediler ve hesabınızın aynı anda çalıştırabileceği arama sayısı. Her hesap aynı anda belirli sayıda arama çalıştırabilir; limit dashboard'ınızda gösterilir ve talep üzerine yükseltilir. *Kredilerinizi okuyun* ```bash curl -s "https://serpcrypto.com/api/v1/credits" -H "Authorization: Bearer $SERPCRYPTO_API_KEY" ``` *Yanıt (örnek değerler)* ```json { "credits_remaining": 84210, "credits_used_today": 1290, "concurrency_limit": 10 } ``` ## Bir aramadan ne döner? Her yanıt tüm motorlarda aynı çerçeveye sahiptir. `search_metadata`, aramanın başarılı olup olmadığını ve kaç kredi kullandığını söyler. `search_parameters`, varsayılanlar dahil uygulanan ayarları yineler. Ardından sonuçlar sayfasının her bloğu için `organic_results` veya `people_also_ask` gibi bir dizi ya da nesne gelir. Bir blok yalnızca sayfada göründüğünde yer alır, bu yüzden onu varsayılan bir değerle okuyun. [Yanıt biçimi](https://serpcrypto.com/tr/docs/response/) sayfası her bloğu ve alanı açıklar. *Bir Google yanıtının yapısı (kısaltılmış, örnek değerler)* ```json { "search_metadata": { "id": "srch_7f3a9c2e41b8", "status": "success", "engine": "google", "credits_used": 1 }, "search_parameters": { "engine": "google", "q": "best espresso grinder", "gl": "us", "hl": "en", "page": 1 }, "search_information": { "total_results": 18600000, "query_displayed": "best espresso grinder" }, "organic_results": [ { "position": 1, "title": "…", "link": "https://www.example.com/…", "snippet": "…" } ], "people_also_ask": [ { "question": "…", "snippet": "…", "link": "https://www.example.org/…" } ], "related_searches": [ { "query": "best espresso grinder under 300" } ], "pagination": { "current": 1, "next_page": 2 } } ``` ## İlk olarak hangi parametreleri kullanacağım? Varsayılanlar ve izin verilen değerlerle tam liste [API referansında](https://serpcrypto.com/tr/docs/search/). | Parametre | Örnek | Ne yapar | | --- | --- | --- | | `q` | `best espresso grinder` | Sorgu, bir kişinin yazacağı gibi. Gerekli. | | `engine` | `google_news` | Hangi motorda ve dikeyde arama yapılacağı. Varsayılan `google`. | | `gl` | `de` | Sonuçların ülkesi, iki harf. Varsayılan `us`. | | `hl` | `de` | Arayüzün dili. Varsayılan `en`. | | `location` | `Austin, Texas, United States` | Yerel sonuçlar için şehir düzeyinde bir konum. | | `device` | `mobile` | `desktop` (varsayılan) veya `mobile` sonuç. | | `page` | `2` | Sonuçlar sayfası, 1 ile 10 arası. Her sayfa bir kredidir. | ## Bir arama ne kadar tutar ve ne zaman ü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. 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. Hatalı bir parametre, yanlış bir anahtar, boş bir bakiye veya meşgul bir hesap nedeniyle reddedilen istek de ücretsizdir; credits endpoint'ine yapılan her çağrı da öyle. Fiyatlar, Ekim 2026 itibarıyla 10.000 arama için $7,50 ile en büyük packte $0,30/1K arama arasında değişir. Ön ödemeli arama kredileri hiçbir zaman sona ermez: kullanılmayan aramalar siz kullanana kadar hesabınızda kalır. [Hatalar sayfası](https://serpcrypto.com/tr/docs/errors/) her hata kodunu ve doğru yeniden deneme yolunu listeler. ## Bundan sonra nereye gitmeliyim? - [API referansı: GET /search](https://serpcrypto.com/tr/docs/search/) — her parametre, varsayılan ve hata - [Yanıt formatı](https://serpcrypto.com/tr/docs/response/) — JSON'un her bloğu ve alanı - [Konumlar ve diller](https://serpcrypto.com/tr/docs/locations/) — gl, hl, location, device - [Hatalar ve yeniden denemeler](https://serpcrypto.com/tr/docs/errors/) — kodlar, nedenler, backoff - [Python](https://serpcrypto.com/tr/docs/python/) — istekler, httpx async, CSV dışa aktarma - [Node.js](https://serpcrypto.com/tr/docs/node/) — fetch, eşzamanlılık havuzu, sayfalama - [curl ve jq](https://serpcrypto.com/tr/docs/curl/) — tek satırlık tarifler - [MCP sunucusu](https://serpcrypto.com/tr/docs/mcp/) — Claude Desktop ve Cursor'da web araması - [LangChain ve LlamaIndex](https://serpcrypto.com/tr/docs/langchain/) — agent'lar için arama aracı - [OpenAI function calling](https://serpcrypto.com/tr/docs/openai/) — araç şeması ve çağrı döngüsü ## Hızlı başlangıç soruları ### Resmi bir SerpCrypto SDK'sı var mı? Hayır. Dokümantasyon, HTTPS endpoint'ini doğrudan çağıran Python, Node.js ve curl için kopyala-yapıştır kod sunar; yani yüklenecek veya güncel tutulacak bir paket yok. HTTP istemcisi olan her dil aynı şekilde çalışır: tek bir GET isteği, tek bir header, tek bir JSON yanıtı. ### API anahtarını URL'ye koyabilir miyim? Evet. `api_key=YOUR_KEY` bir sorgu parametresi olarak çalışır; bu da tarayıcıda hızlı bir test için işe yarar. Kodda ise `Authorization: Bearer` header'ını tercih edin: URL'ler header'lardan daha sık olarak loglara, tarayıcı geçmişine ve paylaşılan ekran görüntülerine düşer. ### KYC veya kredi kartı gerekiyor mu? Hayır. SerpCrypto kimlik, selfie, belge veya kart istemez. Hesap numarasıyla giriş; email isteğe bağlı. $25 minimum yüklemeden başlayarak BTC, USDT, USDC, ETH, SOL, LTC ile ödersiniz. ### Büyük bir paket satın almadan önce nasıl test edebilirim? Ücretsiz katman yok: en küçük paketle test edin, minimum yükleme tutarından ödenir; yalnızca minimum tutara ulaşmak için eklenen kısım, harcanmamışsa 30 gün içinde talep üzerine USDT veya USDC olarak iade edilir. En küçük paket, en büyüğüyle aynı endpoint ve motorlar üzerinde çalışır; dolayısıyla onunla yapacağınız bir test size production'ın nasıl görüneceğini gösterir. --- SerpCrypto: SerpCrypto, Google ve Bing sonuçlarını JSON olarak döndüren, geliştiriciler ve AI agent'lar için bir SERP API'dir; kripto ile ödeme yapılır, kimlik yüklemek gerekmez. $0,30/1K arama ön ödemeli arama kredisinin süresi asla dolmaz. KYC olmadan — kimlik yok, selfie yok, belge yok. Kripto ile ödeme yapın.