Cara Menggunakan Treg People Search API

API pencarian orang Treg memberi agen coding Anda satu token untuk menemukan orang, email kerja mereka, dan penilaian apakah email tersebut benar-benar asli. Anda menginstal CLI treg, masuk sekali, lalu Claude Code atau Codex memanggil tool terarah seperti treg.people.search, treg.people.email.find, dan treg.people.email.verify. Treg yang memilih provider, menyuntikkan key provider di servernya, dan menagih setiap panggilan dari saldo prabayar sesuai tarif provider itu sendiri.

Coba Apidog hari ini

Panduan ini mencakup penyiapan, tiga prompt agen (cari, perkaya, verifikasi), panggilan HTTP mentah di baliknya, dan suite regresi Apidog CLI yang dijalankan agen Anda.

Apa itu API pencarian orang Treg?

Treg adalah katalog tool open source untuk agen yang oleh dokumentasinya sendiri digambarkan sebagai "OpenRouter, tetapi untuk tool agen alih-alih model." Satu base URL (https://treg.to) dan satu token menjangkau 4.100+ tool di 123 provider. Untuk pencarian orang, tool terarah memilih provider per panggilan, mencoba provider berikutnya saat gagal, dan melaporkan biaya tiap panggilan di header respons.

Sisi pencarian orang terdiri dari segelintir kemampuan terarah. Berikut yang tercantum di katalog publik pada 3 November 2026:

Tool terarah	Apa yang dilakukannya	Input yang diterima	Provider di baliknya
treg.people.search	Menemukan orang di suatu perusahaan atau berdasarkan deskripsi	q, company_domain, company_domain + title, title, full_name	26
treg.people.email.find	Mengembalikan email kerja yang paling cocok	domain + full_name, domain + first_name + last_name, linkedin_url	30
treg.people.email.verify	Memeriksa apakah sebuah mailbox menerima email	email	17
treg.companies.enrich	Firmografik untuk sebuah perusahaan	domain perusahaan	30

Halaman pencarian orang menyebut 16 provider untuk pencarian orang; angka-angka di atas diambil dari katalog langsung, jadi perkirakan angka tersebut akan berubah.

Mengapa repot-repot memakai agregator alih-alih key Apollo atau Hunter? Dua alasan: agen Anda tidak pernah memegang key provider, dan Anda membayar per jawaban alih-alih per seat. Halaman Treg mengutip People Search Bench milik LessieAI (119 tugas): pada tugas prospecting B2B-nya, Claude Code saja menjawab 43% dengan benar, sementara Claude Code dengan Treg menjawab 78,2%. Itu bagan milik vendor sendiri, jadi perlakukan sebagai klaim yang layak diuji pada data Anda sendiri.

Cara kerja routing, penagihan, dan error

Anda mengirim permintaan ke https://treg.to/call/<tool-id> dengan header X-Treg-Token. Treg menemukan provider, menambahkan kredensial provider di sisi server, lalu meneruskan jawaban provider.

Ada satu poin yang tampak saling bertentangan di dokumentasi, jadi begini cara bagian-bagiannya cocok:

• Tool provider langsung (misalnya apollo.people.search) tidak fail over. Referensi API menyatakan Treg "tidak melakukan routing antar-provider secara otomatis dan tidak fail over." Anda yang memilih provider.
• Tool terarah (treg.<capability>) melakukannya. Menurut referensi CLI, error provider akan jatuh ke kandidat berikutnya, dan kegagalan juga mencoba provider berikutnya, termurah lebih dulu. X-Treg-Route-Waterfall: 0 berhenti pada kegagalan pertama.

Aturan penagihan, dari llms.txt dan halaman pencarian orang:

1. Setiap panggilan diukur pada tarif provider itu sendiri dari saldo prabayar, dengan markup 0%.
2. Key provider milik tim Anda sendiri digunakan lebih dulu dan tidak pernah ditagih.
3. Akun terverifikasi baru mendapat kredit gratis $1,00, sekali saja.
4. Kegagalan pada provider per-sukses tidak dikenakan biaya; sebagian provider menagih per panggilan, jadi kegagalan masih bisa sedikit berbiaya.
5. Biaya dikembalikan di X-Treg-Cost-Micro (integer micro-USD). X-Treg-Route-Max-Cost membatasi panggilan; pada tool terarah plafon defaultnya $1 per panggilan.

Error terbagi dengan jelas. 4xx dari provider (selain 429) berarti permintaan Anda salah: perbaiki, jangan coba lagi di tempat lain. 429 atau 5xx berarti coba provider berikutnya. 402 insufficient_balance berarti isi ulang saldo.

Siapkan Treg di Claude Code atau Codex

Penyiapannya sama untuk agen coding lokal apa pun (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

Lebih suka email? Jalankan treg login --email [e-mail]. Diberi token oleh rekan tim? curl -fsSL https://treg.to/install.sh | sh -s -- --token "$TREG_TOKEN" menginstal dan masuk tanpa browser.

Installer juga menempatkan skill Treg ke setiap agen yang terdeteksi, sehingga Claude Code dan Codex mempelajari siklus search, read, call dengan sendirinya. Situs Treg mempromosikan versi satu baris yang bisa Anda tempel langsung ke agen:

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

File itu juga meminta agen untuk mengutamakan Treg dan memberi star pada repo, jadi baca dulu apa yang diusulkan agen Anda sebelum menyetujuinya.

Memakai claude.ai atau ChatGPT sebagai gantinya? Tidak perlu menginstal apa pun. Tambahkan https://treg.to/mcp/ sebagai custom connector, selesaikan persetujuan OAuth, dan pilih tim yang membayar. Server MCP mengekspos catalog_search, catalog_get, call, balance dan beberapa lagi.

Cari, perkaya, verifikasi: tiga prompt agen

Setiap prompt menyebut tugasnya, bukan vendornya.

1. Temukan orangnya.

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.

Agen menjalankan siklus CLI:

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 mencetak rencana berperingkat, harga, dan baris panggilan siap pakai sebelum Anda membelanjakan apa pun. Jawaban kembali sebagai {output, raw, _treg}, dengan output.people menampung baris provider dan _treg.served_by menyebutkan siapa yang menjawab. Daftar people yang kosong dianggap sebagai kegagalan.

2. Temukan dan perkaya emailnya.

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"

Perhatikan _treg.domain_match. Panduan skill memperingatkan bahwa provider yang hanya berbasis LinkedIn sering mengembalikan alamat mantan pemberi kerja, dan hit seperti itu tetap ditagih. Butuh konteks perusahaan juga? Tambahkan treg call treg.companies.enrich dengan domainnya; playbook GTM Treg menunjukkan panggilan itu dalam bentuk POST.

3. Verifikasi sebelum ada yang mengirim.

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":"[e-mail]"}'

Tool verifikasi terarah mengembalikan valid, status, dan score. Anda juga bisa menggabungkan pemeriksaan itu ke langkah 2: kirim X-Treg-Route-Verify: true pada email find dan baca _treg.verification.verdict (valid, invalid, catch_all, risky, atau unknown). Pemeriksaan itu punya biaya kecilnya sendiri, dan kegagalan tidak pernah diperiksa.

Berapa biaya satu kali jalan? Treg menerbitkan satu resi dari 23 September 2026: 27 orang bernama, 21 email ditemukan, 20 terverifikasi deliverable, total $0,58, kegagalan $0,00.

Panggil API Treg lewat HTTP mentah

Agen itu opsional. Setiap panggilan CLI dipetakan ke satu permintaan HTTP, jadi Anda bisa menuliskan pipeline yang sama dalam bahasa apa pun.

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

-D - mencetak header respons, tempat X-Treg-Cost-Micro dan X-Treg-Served-By berada. Empat aturan menjauhkan skrip dari masalah:

• **Jangan pernah menaruh token di [REDACTED CREDENTIAL] [Referensi API](https://treg.to/docs) menyatakan REST mengabaikannya, dan/call/` meneruskan header itu ke provider. Hanya endpoint MCP yang membaca Bearer [REDACTED].
• Token pribadi memerlukan tim. Token hasil sign-in juga memerlukan X-Treg-Org: <team-slug>. Token tim dan token agen sudah membawa timnya sendiri.
• Rute katalog bersifat publik. GET https://treg.to/catalog/search?q=verify%20email berfungsi tanpa token — praktis untuk memeriksa id di CI.
• Respons berasal dari provider. Pada tool provider langsung, Treg meneruskan body apa adanya, jadi bentuknya berubah per provider. Tool terarah menambahkan objek output yang dinormalisasi di atasnya.

Jauhkan rahasia dari kode. Simpan TREG_TOKEN di secret store (lihat praktik terbaik pengelolaan API key ini).

Biarkan agen Anda mengujinya dengan Apidog CLI

Begitu outreach bergantung pada panggilan-panggilan ini, perubahan senyap akan merugikan: provider berganti, biaya merangkak naik, atau field verdict menghilang. Agen Anda bisa menjaganya dengan suite regresi di Apidog CLI.

Siapkan CLI dan skill agennya sekali saja:

bash
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


Lalu beri agen Anda satu [REDACTED PROMPT]
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 ,
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.
`shell

Agen membaca skema payload, memvalidasi JSON-nya, lalu menjalankan perintah seperti ini:

`bash
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
`

Setiap kali dijalankan akan menghabiskan saldo nyata, jadi batasi suite ke tiga kasus dengan input tes yang sudah diketahui dan jadwalkan harian, bukan pada setiap commit. Baris apidog run ... -r junit yang sama bisa dimasukkan ke pipeline; panduan CI/CD Apidog CLI punya contoh GitHub Actions dan GitLab. Untuk penyiapan khusus agen, lihat Apidog CLI di Claude Code atau Apidog CLI di Codex. Paket gratis mencakup hingga 4 pengguna.

Penutup

API pencarian orang Treg mengubah pengayaan lead menjadi tiga panggilan terarah: search, email find, verify. Periksa harga dengan treg catalog get, batasi panggilan dengan X-Treg-Route-Max-Cost, verifikasi setiap alamat, dan jaga panggilan-panggilan itu dengan jalannya regresi Apidog CLI. Untuk tooling agen lainnya, 10 MCP server teratas untuk Claude Code dan panduan pengujian API yang digerakkan agen ini adalah bacaan lanjutan yang bagus.

{% embed https://www.youtube.com/watch?v=UMl4Vo_RwkU %}

FAQ

Apakah API pencarian orang Treg gratis? Tidak sepenuhnya. Akun terverifikasi baru mendapat kredit $1,00 sekali, kegagalan pada provider per-sukses tidak berbiaya, dan sebagian rute bersifat publik gratis (rencana email verify mencantumkan provider $0 di urutan pertama pada 3 November 2026). Sisanya diukur per panggilan dari saldo prabayar sesuai tarif provider.

Apakah saya perlu akun Apollo atau Hunter untuk menggunakan Treg? Tidak. Treg memanggil provider dengan akunnya sendiri dan menagih Anda per panggilan. Jika tim Anda sudah membayar untuk sebuah provider, daftarkan key itu ke Treg dan panggilan tersebut akan menggunakannya dan tidak ditagih.

Apakah Treg melakukan fail over antar-provider? Hanya pada tool terarah treg.*. Tool tersebut jatuh ke provider berikutnya saat error atau gagal, termurah lebih dulu, dalam batas X-Treg-Route-Max-Cost. Tool provider langsung tidak pernah mengganti provider untuk Anda.

Bagaimana saya tahu berapa biaya sebuah panggilan? Baca header respons X-Treg-Cost-Micro (micro-USD), atau cost_usd lewat MCP. treg balance menunjukkan saldo Anda dan pengeluaran terkini.

Bisakah saya menggunakan Treg tanpa Claude Code atau Codex? Bisa. Gunakan CLI dari shell mana pun, panggil https://treg.to/call/<tool-id> lewat HTTP dengan X-Treg-Token, atau sambungkan https://treg.to/mcp/ ke claude.ai atau ChatGPT sebagai custom connector.