Treg Kişi Arama API'si Nasıl Kullanılır?

Treg people search API'si, kodlama ajanınıza insanları bulmak, iş e-postalarını ve bu e-postaların gerçek olup olmadığına dair bir hüküm için tek bir token verir. treg CLI'sini kurar, bir kez oturum açarsınız ve Claude Code ya da Codex, treg.people.search, treg.people.email.find ve treg.people.email.verify gibi yönlendirilmiş araçları çağırır. Treg sağlayıcıyı seçer, sağlayıcının anahtarını kendi sunucusunda enjekte eder ve her çağrıyı sağlayıcının kendi ücreti üzerinden ön ödemeli bakiyeden faturalandırır.

Bu kılavuz kurulumu, üç ajan istemini (bul, zenginleştir, doğrula), arkalarındaki ham HTTP çağrılarını ve ajanınızın çalıştırdığı bir Apidog CLI regresyon test setini kapsar.

Treg people search API'si nedir?

Treg, kendi dokümanlarının "modeller yerine ajan araçları için OpenRouter" olarak tanımladığı, ajanlar için açık kaynaklı bir araç kataloğudur. Tek bir temel URL (https://treg.to) ve tek bir token, 123 sağlayıcıdaki 4.100'den fazla araca ulaşır. Kişi aramada, yönlendirilmiş araçlar her çağrı için bir sağlayıcı seçer, ıskalamada bir sonrakini dener ve her çağrının maliyetini bir yanıt başlığında bildirir.

Kişi arama tarafı küçük bir yönlendirilmiş yetenek setidir. Genel kataloğun 3 Kasım 2026'da listelediği şey şöyleydi:

Kişi arama sayfası kişi arama için 16 sağlayıcı belirtiyor; yukarıdaki sayılar canlı katalogdan geliyor, dolayısıyla değişmelerini bekleyin.

Neden bir Apollo ya da Hunter anahtarı yerine bir toplayıcıyla uğraşasınız? İki neden. Ajanınız hiçbir zaman bir sağlayıcı anahtarı tutmaz ve koltuk başına değil, yanıt başına ödersiniz. Treg'in sayfası LessieAI'nin People Search Bench'ini (119 görev) alıntılıyor: B2B potansiyel müşteri bulma görevlerinde, tek başına Claude Code %43 doğru yanıt verirken, Treg ile Claude Code %78,2 doğru yanıt verdi. Bu satıcının kendi grafiği, dolayısıyla bunu kendi verinizde test etmeye değer bir iddia olarak görün.

Yönlendirme, faturalandırma ve hatalar nasıl çalışır

X-Treg-Token başlığıyla https://treg.to/call/<tool-id> adresine bir istek gönderirsiniz. Treg sağlayıcıyı bulur, sağlayıcı kimlik bilgisini sunucu tarafında ekler ve sağlayıcının yanıtını iletir.

Dokümanların çelişiyor gibi göründüğü tek bir nokta var, işte parçaların nasıl bir araya geldiği:

• Doğrudan sağlayıcı araçları (örneğin apollo.people.search) yedekleme yapmaz. API referansı, Treg'in "sağlayıcılar arasında otomatik olarak yönlendirme yapmadığını ve yedekleme yapmadığını" söylüyor. Sağlayıcıyı siz seçersiniz.
• Yönlendirilmiş araçlar (treg.<capability>) yapar. CLI referansına göre, bir sağlayıcı hatası bir sonraki adaya geri düşer ve bir ıskalama da bir sonraki sağlayıcıyı dener, en ucuzdan başlayarak. X-Treg-Route-Waterfall: 0 ilk ıskalamada durur.

Faturalandırma kuralları, llms.txt ve kişi arama sayfasından:

1. Her çağrı, sağlayıcının kendi ücreti üzerinden ön ödemeli bakiyeden, %0 kâr marjıyla ölçülür.
2. Ekibinizin kendi sağlayıcı anahtarı önce kullanılır ve asla faturalandırılmaz.
3. Yeni doğrulanmış hesaplar bir kez 1,00 $ ücretsiz kredi alır.
4. Başarı başına ödeme yapan sağlayıcılardaki ıskalamalar hiçbir şeye mal olmaz; bazı sağlayıcılar çağrı başına faturalandırır, dolayısıyla bir ıskalama yine de biraz tutabilir.
5. Ücret X-Treg-Cost-Micro (tam sayı mikro-USD) olarak geri döner. X-Treg-Route-Max-Cost bir çağrıyı sınırlar; yönlendirilmiş araçlarda varsayılan tavan çağrı başına 1 $'dır.

Hatalar net biçimde ayrılır. Sağlayıcıdan gelen bir 4xx (429 dışında) isteğinizin yanlış olduğu anlamına gelir: düzeltin, başka yerde yeniden denemeyin. Bir 429 veya 5xx, bir sonraki sağlayıcıyı deneyin demektir. Bir 402 insufficient_balance, bakiye yükleyin demektir.

Treg'i Claude Code veya Codex'te kurun

Kurulum herhangi bir yerel kodlama ajanı için aynıdır (Claude Code, Codex, Cursor, opencode):

curl -fsSL https://treg.to/install.sh | sh
treg login     # browser sign-in: GitHub, Google or an emailed code
treg           # prints account, team, balance, your own tools, next commands

E-postayı mı tercih edersiniz? treg login --email you@company.com komutunu çalıştırın. Bir ekip arkadaşınız size bir token mı verdi? curl -fsSL https://treg.to/install.sh | sh -s -- --token "$TREG_TOKEN" tarayıcı olmadan kurar ve oturum açar.

Kurucu ayrıca algıladığı her ajana Treg becerisini bırakır, böylece Claude Code ve Codex arama, okuma, çağırma döngüsünü kendi başlarına öğrenir. Treg'in sitesi doğrudan ajana yapıştırabileceğiniz tek satırlık bir sürümü tanıtıyor:

set up treg - https://treg.to/llms.txt

Bu dosya ayrıca ajanlardan Treg'i tercih etmelerini ve depoya yıldız vermelerini ister, dolayısıyla onaylamadan önce ajanınızın ne önerdiğini okuyun.

Onun yerine claude.ai veya ChatGPT mi kullanıyorsunuz? Hiçbir şey kurmayın. https://treg.to/mcp/ adresini özel bir bağlayıcı olarak ekleyin, OAuth onayını tamamlayın ve ödeme yapacak ekibi seçin. MCP sunucusu catalog_search, catalog_get, call, balance ve birkaç şey daha sunar.

Bul, zenginleştir, doğrula: üç ajan istemi

Her istem işi adlandırır, satıcıyı değil.

1. Kişileri bulun.

Use treg to find the platform and infrastructure leads at modal.com.
Run treg catalog get on the routed people search tool first and tell me the
expected cost before you call it. List name, title and profile URL.

Ajan CLI döngüsünü çalıştırır:

treg catalog search "find people at a company"
treg catalog get treg.people.search
treg call treg.people.search --method POST --data '{"company_domain":"modal.com","title":"platform"}'

catalog get, herhangi bir şey harcamadan önce sıralanmış planı, fiyatları ve hazır bir çağrı satırını yazdırır. Yanıt {output, raw, _treg} olarak döner; burada output.people sağlayıcının satırlarını tutar ve _treg.served_by kimin yanıtladığını belirtir. Boş bir people listesi ıskalama sayılır.

2. E-postayı bulun ve zenginleştirin.

For each person you found, use treg to find their work email at modal.com.
Cap each call at $0.05, and flag any hit where the domain doesn't match.

treg call treg.people.email.find --method POST \
  --data '{"full_name":"Jane Doe","domain":"modal.com"}' \
  --header "X-Treg-Route-Max-Cost: 0.05"

_treg.domain_match değerine dikkat edin. Beceri kılavuzu, yalnızca LinkedIn üzerinden çalışan bir sağlayıcının sıklıkla eski bir işverenin adresini döndürdüğünü ve bu isabetin yine de faturalandırıldığını uyarır. Şirket bağlamına da mı ihtiyacınız var? Alan adıyla birlikte treg call treg.companies.enrich ekleyin; Treg'in GTM oyun kitabı bu çağrıyı POST biçiminde gösterir.

3. Kimse göndermeden önce doğrulayın.

Verify every email you found with treg. Report the verdict per address
and drop anything invalid or catch-all.

treg call treg.people.email.verify --method POST --data '{"email":"jane@modal.com"}'

Yönlendirilmiş doğrulama aracı valid, status ve score döndürür. Kontrolü 2. adıma da katabilirsiniz: e-posta bulma çağrısında X-Treg-Route-Verify: true gönderin ve _treg.verification.verdict değerini okuyun (valid, invalid, catch_all, risky veya unknown). Kontrolün kendi küçük ücreti vardır ve bir ıskalama asla kontrol edilmez.

Bir çalıştırma ne kadara mal olur? Treg, 23 Eylül 2026 tarihli bir makbuz yayımlıyor: 27 adlandırılmış kişi, bulunan 21 e-posta, teslim edilebilir olduğu doğrulanan 20 e-posta, toplam 0,58 $, ıskalamalar 0,00 $.

Treg API'sini ham HTTP üzerinden çağırın

Ajan isteğe bağlıdır. Her CLI çağrısı tek bir HTTP isteğine karşılık gelir, dolayısıyla aynı işlem hattını herhangi bir dilde betikleyebilirsiniz.

curl -X POST "https://treg.to/call/treg.people.email.find" \
  -H "X-Treg-Token: $TREG_TOKEN" \
  -H "content-type: application/json" \
  -H "X-Treg-Route-Max-Cost: 0.05" \
  -d '{"full_name":"Jane Doe","domain":"modal.com"}' \
  -D -

-D - yanıt başlıklarını yazdırır; X-Treg-Cost-Micro ve X-Treg-Served-By buradadır. Dört kural betikleri beladan uzak tutar:

• Token'ı asla Authorization: Bearer içine koymayın. API referansı REST'in bunu yok saydığını ve /call/ adresinin o başlığı sağlayıcıya ilettiğini söylüyor. Yalnızca MCP uç noktası bir bearer token okur.
• Kişisel token'lar bir ekip gerektirir. Bir oturum açma token'ı ayrıca X-Treg-Org: <team-slug> gerektirir. Ekip ve ajan token'ları zaten kendi ekiplerini taşır.
• Katalog rotaları geneldir. GET https://treg.to/catalog/search?q=verify%20email token olmadan çalışır; bu, CI'da kimlikleri kontrol etmek için kullanışlıdır.
• Yanıtlar sağlayıcıya aittir. Doğrudan sağlayıcı araçlarında Treg gövdeyi birebir iletir, dolayısıyla biçim sağlayıcıya göre değişir. Yönlendirilmiş araçlar üstüne normalize edilmiş output nesnesini ekler.

Sırları koddan uzak tutun. TREG_TOKEN değerini bir sır deposunda saklayın (bu API anahtarı yönetimi en iyi uygulamalarına bakın).

Ajanınızın bunu Apidog CLI ile test etmesine izin verin

Erişim çalışmaları bu çağrılara bağlı hale geldiğinde, sessiz değişiklikler zarar verir: bir sağlayıcı değişir, maliyetler sinsi sinsi artar veya hüküm alanı kaybolur. Ajanınız bunu Apidog CLI'da bir regresyon test setiyle koruyabilir.

CLI'yi ve ajan becerisini bir kez kurun:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_APIDOG_TOKEN>
npx -y skills add https://apidog.com   # pick Claude Code or Codex when prompted

Ardından ajanınıza tek bir istem verin:

Write an OpenAPI 3 file for three Treg calls: POST /call/treg.people.search,
POST /call/treg.people.email.find and POST /call/treg.people.email.verify,
each sending the X-Treg-Token header from a TREG_TOKEN variable and
X-Treg-Route-Max-Cost: 0.05. Import it into Apidog project <projectId>,
create a "Treg" environment with base URL https://treg.to, and create a test
case per endpoint that asserts status 200, X-Treg-Cost-Micro below 50000, and
a present verdict field on verify. Run them and summarize any failures.

Ajan yük şemalarını okur, JSON'unu doğrular, ardından şu gibi komutları çalıştırır:

apidog import --project <projectId> --format openapi --file ./treg-openapi.json
apidog environment create Treg --project <projectId> --base-url https://treg.to
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file ./find-email-case.json
apidog test-case create --project <projectId> --file ./find-email-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
  --env-var "TREG_TOKEN=$TREG_TOKEN" -r cli,junit

Her çalıştırma gerçek bakiye harcar, dolayısıyla test setini bilinen test girdileriyle üç vakayla sınırlı tutun ve her commit'te değil, günlük olarak zamanlayın. Aynı apidog run ... -r junit satırı bir işlem hattına bırakılır; Apidog CLI CI/CD kılavuzunda GitHub Actions ve GitLab örnekleri var. Ajana özel kurulum için Claude Code'da Apidog CLI veya Codex'te Apidog CLI yazılarına bakın. Ücretsiz plan 4 kullanıcıya kadar kapsar.

Toparlarken

Treg people search API'si potansiyel müşteri zenginleştirmeyi üç yönlendirilmiş çağrıya dönüştürür: ara, e-posta bul, doğrula. Fiyatları treg catalog get ile kontrol edin, çağrıları X-Treg-Route-Max-Cost ile sınırlayın, her adresi doğrulayın ve çağrıları bir Apidog CLI regresyon çalıştırmasıyla koruyun. Daha fazla ajan aracı için, Claude Code için en iyi MCP sunucuları ve bu ajan odaklı API testi yürütmesi iyi sonraki okumalardır.

SSS

Treg people search API'si ücretsiz mi? Tamamen değil. Yeni doğrulanmış hesaplar bir kez 1,00 $ kredi alır, başarı başına ödeme yapan sağlayıcılardaki ıskalamalar hiçbir şeye mal olmaz ve bazı rotalar ücretsiz genel rotalardır (e-posta doğrulama planı 3 Kasım 2026'da ilk sırada 0 $'lık bir sağlayıcı listeliyordu). Diğer her şey, sağlayıcının ücreti üzerinden ön ödemeli bakiyeden çağrı başına ölçülür.

Treg'i kullanmak için bir Apollo veya Hunter hesabına ihtiyacım var mı? Hayır. Treg sağlayıcıyı kendi hesabından çağırır ve sizi çağrı başına faturalandırır. Ekibiniz zaten bir sağlayıcı için ödeme yapıyorsa, o anahtarı Treg'e kaydedin; bu çağrılar onu kullanır ve faturalandırılmaz.

Treg sağlayıcılar arasında yedekleme yapar mı? Yalnızca yönlendirilmiş treg.* araçlarında. Bir hata veya ıskalamada, X-Treg-Route-Max-Cost dahilinde, en ucuzdan başlayarak bir sonraki sağlayıcıya geçerler. Doğrudan sağlayıcı araçları sizin için asla sağlayıcı değiştirmez.

Bir çağrının ne kadara mal olduğunu nasıl bilirim? X-Treg-Cost-Micro yanıt başlığını (mikro-USD) veya MCP üzerinden cost_usd değerini okuyun. treg balance bakiyenizi ve son harcamalarınızı gösterir.

Treg'i Claude Code veya Codex olmadan kullanabilir miyim? Evet. CLI'yi herhangi bir kabuktan kullanın, X-Treg-Token ile https://treg.to/call/<tool-id> adresini HTTP üzerinden çağırın veya https://treg.to/mcp/ adresini özel bir bağlayıcı olarak claude.ai ya da ChatGPT'ye bağlayın.