# LocalSERP Proxy API belgeleri

> localserpproxy.com/api adresindeki LocalSERP Proxy REST API: bakiye, bakiye yükleme, siparişler ve proxy’ler için API anahtarları, hatalar, limitler ve uç noktalar.

- URL: https://localserpproxy.com/tr/docs/api/
- Son güncelleme: 2026-10-15
- Publisher: LocalSERP Proxy (https://localserpproxy.com)

Hesabınızda yaptığınız her işlemi kodla yönetebilirsiniz: bakiyeyi kontrol edin, kriptoyla bakiye yükleyin, plan satın alın, proxy kimlik bilgileri oluşturun, mobil IP’yi değiştirin. HTTPS üzerinden JSON, tek bir API anahtarı, curl, Python ve Node.js örnekleri.

## LocalSERP Proxy API’yi nasıl kullanırım?

**Kısa yanıt**

API anahtarınızı `Authorization: Bearer API_KEY` başlığına ekleyerek `https://localserpproxy.com/api/v1` adresine HTTPS istekleri gönderin. Anahtarı hesabınızdaki [geliştirici sayfasında](https://localserpproxy.com/app/developer?lang=tr) (veya `POST /v1/api-keys` ile) oluşturun ve yalnızca gereken izinleri verin. İstekler ve yanıtlar JSON biçimindedir; hatalar her zaman `{ "error": { "code", "message" } }` olarak döner.

## Genel bakış

| Özellik | Değer |
| --- | --- |
| Temel URL | `https://localserpproxy.com/api/v1` |
| Format | HTTPS üzerinden JSON, UTF-8 |
| Kimlik doğrulama | API key: `Authorization: Bearer API_KEY` |
| API key kapsamları | `read`, `proxies`, `billing` |
| Para birimi | 2 ondalık basamaklı metin olarak USD (`"29.00"`) |
| Kripto tutarları | Ondalık metinler; asla kayan noktalı sayı kullanmayın (`"0.00045210"`) |
| Trafik | Bayt (1 GB = 1.000.000.000 bayt) |
| Tarihler | UTC'de ISO 8601 (`2026-10-05T14:03:11Z`) |
| Sürüm | Her yolda `/v1` |

## Kimlik doğrulama

Herkese açık katalog dışındaki her istek bir API anahtarı taşır: `Authorization: Bearer API_KEY`. Anahtar, oluşturduğunuzda **yalnızca bir kez** tam olarak gösterilir: parola gibi saklayın. Anahtarı istediğiniz zaman iptal edebilirsiniz; bu anahtarla yapılan istekler artık `401 unauthorized` döndürür.

### Kapsamlar

Her anahtara yalnızca betiğinizin ihtiyaç duyduğu izinleri verin. Gerekli kapsama sahip olmayan bir anahtar `403 forbidden` döndürür.

| Kapsam | İzin verdiği işlemler |
| --- | --- |
| `read` | Hesap, bakiye, hizmetler ve kullanım dahil her şeyi okur. |
| `proxies` | proxy ayarlarını ve kimlik bilgilerini değiştirin (etiketler, otomatik yenileme, yeni parolalar), alt kullanıcıları yönetin, IP izin listesini yönetin ve mobil portları döndürün (döndürme bağlantısı dahildir). |
| `billing` | sipariş oluşturun ve bakiye yükleyin, ödemeyi bakiyenizden yapın. |

Tek istisna, tarayıcı yer iminden veya düz bir `curl` üzerinden çağrılmak üzere tasarlanmış **mobil döndürme bağlantısıdır**: `GET https://localserpproxy.com/api/v1/mobile/PORT_ID/rotate?key=API_KEY` (`proxies` kapsamına sahip anahtar). Bkz. [Mobil portlar ve IP döndürme](https://localserpproxy.com/tr/docs/api/mobile/).

*Bakiyenizi kontrol edin*

```bash
curl -s "https://localserpproxy.com/api/v1/balance" \
  -H "Authorization: Bearer $API_KEY"
```

## İstekler ve yanıtlar

- **JSON girdi, JSON çıktı**: gövdeli `Content-Type: application/json` gönderin.
- Büyüyebilen **listeler**, `page` (1'den başlar) ve `perPage` (1–100, varsayılan 20) ile sayfalanır ve `{ "data": [...], "pagination": { "page", "perPage", "total", "totalPages" } }` döndürür. Kısa listeler `{ "data": [...] }` döndürür.
- **Kimlikler**, tür öneki olan opak dizelerdir: `ord_` (sipariş), `top_` (bakiye yükleme), `txn_` (bakiye hareketi), `res_` (trafik aboneliği), `mob_` (mobil port), `key_` (API anahtarı) ve `ipw_` (IP izin listesi kaydı).
- **Güvenli yeniden denemeler**: `POST /v1/orders` ve `POST /v1/topups`, `Idempotency-Key` başlığını kabul eder (herhangi bir benzersiz dize, 24 saat saklanır). Aynı anahtarla yeniden gönderim yapıldığında, iki kez satın alma veya bakiye yükleme yerine ilk yanıt döndürülür.
- **Örnekler** her yanıtın yapısını gösterir: örneklerdeki kimlikler, IP'ler, tutarlar ve tarihler açıklama amaçlıdır; plan kimlikleri ve fiyatlar gerçektir.

## Hatalar

Tüm hataların gövdesi aynıdır. `code` sabittir ve kodunuz tarafından kullanılmak üzere tasarlanmıştır; `message` değişebilen İngilizce bir cümledir. Doğrulama hatalarında geçersiz her alan `fields` içinde listelenir. Yeni kodlar eklenebilir: bilinmeyen kodları genel bir hata olarak ele alın.

*422 validation_failed*

```json
{
  "error": {
    "code": "validation_failed",
    "message": "Some fields are invalid.",
    "fields": [
      {
        "field": "amountUsd",
        "code": "too_small",
        "message": "The minimum top-up is 25.00 USD."
      }
    ],
    "requestId": "req_2b7c0f"
  }
}
```

### Durum kodları

| Durum | Anlamı |
| --- | --- |
| `422` | `validation_failed`: bir veya daha fazla alan geçersiz. |
| `401` | `unauthorized`: token eksik, geçersiz veya süresi dolmuş. |
| `402` | `insufficient_balance`: bakiye sipariş tutarını karşılamıyor. `details` = `InsufficientBalanceDetails`. |
| `403` | `forbidden`: API anahtarında gerekli kapsam yok veya hesap askıya alınmış. |
| `404` | `not_found`: kaynak mevcut değil ya da başka bir hesaba ait. |
| `409` | `conflict` (veya daha spesifik bir kod): işlem mevcut durumda gerçekleştirilemiyor. |
| `429` | `rate_limited` veya `rotation_too_soon`. |

## İstek sınırları

Her yanıt `RateLimit-Limit`, `RateLimit-Remaining` ve `RateLimit-Reset` içerir. Sınır aşıldığında API, `Retry-After` başlığıyla (saniye cinsinden) `429 rate_limited` yanıtını verir: belirtilen süre kadar bekleyip yeniden deneyin. Mobil portun IP adresi en fazla 30 saniyede bir değiştirilebilir (`429 rotation_too_soon`, `Retry-After` ile).

## API referansı

- **[Hesap ve bakiye](https://localserpproxy.com/tr/docs/api/account/)** — Hesap ayarlarınızı, ön ödemeli USD bakiyenizi ve bu bakiyedeki tüm hareketleri (bakiye yüklemeleri, satın alımlar, iadeler) görüntüleyin.
- **[Kripto ile bakiye yükleme](https://localserpproxy.com/tr/docs/api/top-ups/)** — Bakiyenizi kripto ile yükleyin: yatırma adresini ve tam tutarı alın, tam olarak bu tutarı gönderin, ödemenin gönderildiğini bildirin (işlem kimliği isteğe bağlıdır), ardından bakiye hesabınıza aktarılana kadar yükleme işlemini takip edin. Bakiye, planlarımızdan herhangi birinin ödemesinde kullanılabilir.
- **[Siparişler](https://localserpproxy.com/tr/docs/api/orders/)** — Planları ve fiyatlarını listeleyin, bakiyenizle plan satın alın (yeni hizmet, daha fazla trafik veya port uzatma) ve geçmiş siparişlerinizi görüntüleyin.
- **[Residential proxy (konut proxy) ve kimlik bilgileri](https://localserpproxy.com/tr/docs/api/residential/)** — Trafik aboneliklerini yönetin (GB başına residential ve dönen 4G/5G): proxy kimlik bilgileri, kendi kimlik bilgileri ve trafik sınırı olan alt kullanıcılar, günlük kullanım ve proxy kullanıcı adında hedefleyebileceğiniz konumlar.
- **[Mobil portlar ve IP rotasyonu](https://localserpproxy.com/tr/docs/api/mobile/)** — Özel 4G/5G portları: IP’yi hemen veya zamanlayarak değiştirin, rotasyon bağlantısını kullanın ve günlük trafiği görüntüleyin.
- **[API anahtarları ve IP izin listesi](https://localserpproxy.com/tr/docs/api/api-keys/)** — Sınırlı izinlere sahip API anahtarları oluşturup iptal edin ve IP izin listesini yönetin: kullanıcı adı ve parola olmadan proxy’leri kullanmasına izin verilen en fazla 10 kaynak IP.

> **Bir betikten ödeme yapma** Planlar her zaman ön ödemeli USD bakiyesinden ödenir. POST /v1/topups ile kripto para yatırın (minimum 25.00 USD), ardından POST /v1/orders ile satın alın. İkisini tek bir çağrıda yapabilirsiniz: bakiye yükleme, siparişi purchase içinde taşıyabilir ve bakiye hesaba geçer geçmez plan satın alınır.

---

LocalSERP Proxy: LocalSERP Proxy, yerel arama sonuçlarını, reklamları ve fiyatları şehir şehir kontrol etmek için kullanılan, kripto ile ödeme yapılan ve kimlik belgesi yüklemeyi gerektirmeyen bir ABD konut proxy hizmetidir.