Thanawat Wongchai

Posted on Nov 3 Originally published at apidog.com

วิธีใช้งาน Treg People Search API

API ค้นหาบุคคลของ Treg มอบโทเคนหนึ่งตัวให้เอเจนต์เขียนโค้ดของคุณสำหรับค้นหาบุคคล อีเมลที่ทำงานของพวกเขา และคำตัดสินว่าอีเมลเหล่านั้นเป็นของจริงหรือไม่ คุณติดตั้ง CLI treg ลงชื่อเข้าใช้หนึ่งครั้ง แล้ว Claude Code หรือ Codex จะเรียกเครื่องมือที่ถูกจัดเส้นทาง เช่น treg.people.search, treg.people.email.find และ treg.people.email.verify Treg จะเลือกผู้ให้บริการ ฉีดคีย์ของผู้ให้บริการบนเซิร์ฟเวอร์ของตน และเรียกเก็บเงินแต่ละครั้งจากยอดคงเหลือแบบเติมเงินในอัตราของผู้ให้บริการเอง

ลองใช้ Apidog วันนี้

คู่มือนี้ครอบคลุมการตั้งค่า พรอมต์สำหรับเอเจนต์สามแบบ (ค้นหา, เสริมข้อมูล, ตรวจสอบ) การเรียก HTTP แบบดิบที่อยู่เบื้องหลัง และชุดการทดสอบถดถอย Apidog CLI ที่เอเจนต์ของคุณรัน

Treg people search API คืออะไร?

Treg คือแค็ตตาล็อกเครื่องมือแบบโอเพนซอร์สสำหรับเอเจนต์ ซึ่งเอกสารของตัวเองอธิบายว่า "OpenRouter แต่สำหรับเครื่องมือของเอเจนต์แทนที่จะเป็นโมเดล" หนึ่ง base URL (https://treg.to) และหนึ่งโทเคนเข้าถึงเครื่องมือกว่า 4,100 รายการจากผู้ให้บริการ 123 ราย สำหรับการค้นหาบุคคล เครื่องมือที่ถูกจัดเส้นทางจะเลือกผู้ให้บริการต่อการเรียกหนึ่งครั้ง ลองรายถัดไปเมื่อไม่พบ และรายงานค่าใช้จ่ายของการเรียกทุกครั้งในเฮดเดอร์ตอบกลับ

ฝั่งการค้นหาบุคคลคือชุดความสามารถที่ถูกจัดเส้นทางขนาดเล็ก นี่คือสิ่งที่แค็ตตาล็อกสาธารณะระบุไว้เมื่อวันที่ 3 พฤศจิกายน 2026:

เครื่องมือที่ถูกจัดเส้นทาง	ทำอะไร	อินพุตที่รับ	ผู้ให้บริการที่อยู่เบื้องหลัง
`treg.people.search`	ค้นหาบุคคลในบริษัทหรือตามคำอธิบาย	`q`, `company_domain`, `company_domain` + `title`, `title`, `full_name`	26
`treg.people.email.find`	คืนค่าอีเมลที่ทำงานที่ตรงที่สุด	`domain` + `full_name`, `domain` + `first_name` + `last_name`, `linkedin_url`	30
`treg.people.email.verify`	ตรวจสอบว่ากล่องจดหมายรับอีเมลได้หรือไม่	`email`	17
`treg.companies.enrich`	ข้อมูลบริษัท (firmographics)	โดเมนของบริษัท	30

หน้าค้นหาบุคคลอ้างอิงผู้ให้บริการ 16 รายสำหรับการค้นหาบุคคล ตัวเลขข้างต้นมาจากแค็ตตาล็อกสด ดังนั้นคาดว่ามันจะเปลี่ยนแปลงได้

ทำไมต้องใช้ตัวรวบรวมแทนคีย์ Apollo หรือ Hunter? มีสองเหตุผล เอเจนต์ของคุณไม่เคยถือคีย์ของผู้ให้บริการ และคุณจ่ายต่อคำตอบแทนที่จะจ่ายต่อที่นั่ง หน้าเพจของ Treg อ้างอิง People Search Bench ของ LessieAI (119 งาน): ในงานด้าน B2B prospecting ของมัน Claude Code เพียงลำพังตอบถูก 43% และ Claude Code ที่ใช้ Treg ตอบถูก 78.2% นั่นคือกราฟของผู้ขายเอง จึงควรถือเป็นคำกล่าวอ้างที่ควรทดสอบกับข้อมูลของคุณ

การจัดเส้นทาง การเรียกเก็บเงิน และข้อผิดพลาดทำงานอย่างไร

คุณส่งคำขอไปที่ https://treg.to/call/<tool-id> พร้อมเฮดเดอร์ X-Treg-Token Treg จะค้นหาผู้ให้บริการ เพิ่มข้อมูลรับรองของผู้ให้บริการฝั่งเซิร์ฟเวอร์ และส่งต่อคำตอบของผู้ให้บริการ

มีจุดหนึ่งที่เอกสารดูเหมือนขัดแย้งกัน นี่คือวิธีการที่แต่ละส่วนประกอบเข้าข้อยกัน:

เครื่องมือผู้ให้บริการโดยตรง (ตัวอย่างเช่น apollo.people.search) จะไม่มีการสลับไปใช้ตัวสำรอง เอกสารอ้างอิง API ระบุว่า Treg "ไม่จัดเส้นทางระหว่างผู้ให้บริการโดยอัตโนมัติ และไม่สลับไปใช้ตัวสำรอง" คุณเป็นคนเลือกผู้ให้บริการเอง
เครื่องมือที่ถูกจัดเส้นทาง (treg.<capability>) สลับให้ ตามเอกสารอ้างอิง CLI ข้อผิดพลาดจากผู้ให้บริการจะถอยกลับไปยังตัวเลือกถัดไป และเมื่อไม่พบก็จะลองผู้ให้บริการรายถัดไปเช่นกัน โดยเริ่มจากถูกที่สุดก่อน X-Treg-Route-Waterfall: 0 จะหยุดที่การไม่พบครั้งแรก

กฎการเรียกเก็บเงิน จาก llms.txt และหน้าค้นหาบุคคล:

ทุกการเรียกคิดค่าบริการตามอัตราของผู้ให้บริการจากยอดคงเหลือแบบเติมเงิน โดยบวกเพิ่ม 0%
คีย์ผู้ให้บริการของทีมคุณเองจะถูกใช้ก่อนและไม่มีการเรียกเก็บเงิน
บัญชีที่ยืนยันใหม่จะได้รับเครดิตฟรี $1.00 หนึ่งครั้ง
การไม่พบบนผู้ให้บริการที่คิดต่อความสำเร็จไม่มีค่าใช้จ่าย ผู้ให้บริการบางรายคิดต่อการเรียก ดังนั้นแม้ไม่พบก็อาจมีค่าใช้จ่ายเล็กน้อย
ค่าใช้จ่ายจะส่งกลับมาใน X-Treg-Cost-Micro (จำนวนเต็มหน่วยไมโคร-USD) X-Treg-Route-Max-Cost จำกัดเพดานการเรียก บนเครื่องมือที่ถูกจัดเส้นทาง เพดานเริ่มต้นคือ $1 ต่อการเรียก

ข้อผิดพลาดแยกออกจากกันอย่างชัดเจน 4xx จากผู้ให้บริการ (นอกเหนือจาก 429) หมายความว่าคำขอของคุณผิด: แก้ไข อย่าลองที่อื่น 429 หรือ 5xx หมายความว่าให้ลองผู้ให้บริการรายถัดไป 402 insufficient_balance หมายความว่าต้องเติมเงิน

ตั้งค่า Treg ใน Claude Code หรือ Codex

การตั้งค่าเหมือนกันสำหรับเอเจนต์เขียนโค้ดในเครื่องใดก็ได้ (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

อยากใช้อีเมล? รัน treg login --email you@company.com ได้รับโทเคนจากเพื่อนร่วมทีมมา? curl -fsSL https://treg.to/install.sh | sh -s -- --token "$TREG_TOKEN" จะติดตั้งและลงชื่อเข้าใช้โดยไม่ต้องใช้เบราว์เซอร์

ตัวติดตั้งยังวางสกิล Treg ลงในทุกเอเจนต์ที่ตรวจพบ ดังนั้น Claude Code และ Codex จะเรียนรู้ลูปการค้นหา อ่าน เรียก ได้เอง ไซต์ของ Treg โปรโมตเวอร์ชันบรรทัดเดียวที่คุณวางลงในเอเจนต์ได้เลย:

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

ไฟล์นั้นยังขอให้เอเจนต์เลือกใช้ Treg และกดดาวให้รีโป ดังนั้นอ่านสิ่งที่เอเจนต์ของคุณเสนอก่อนอนุมัติ

ใช้ claude.ai หรือ ChatGPT แทนหรือไม่? ไม่ต้องติดตั้งอะไร เพิ่ม https://treg.to/mcp/ เป็นคอนเน็กเตอร์แบบกำหนดเอง ทำการยินยอม OAuth ให้เสร็จ และเลือกทีมที่จ่ายเงิน เซิร์ฟเวอร์ MCP เปิดเผย catalog_search, catalog_get, call, balance และอื่น ๆ อีกเล็กน้อย

ค้นหา เสริมข้อมูล ตรวจสอบ: พรอมต์สำหรับเอเจนต์สามแบบ

แต่ละพรอมต์ระบุงาน ไม่ใช่ระบุผู้ขาย

1. ค้นหาบุคคล

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.

เอเจนต์รันลูป 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 พิมพ์แผนที่จัดอันดับ ราคา และบรรทัดคำสั่งเรียกที่พร้อมใช้ก่อนที่คุณจะเสียเงินอะไร คำตอบจะกลับมาเป็น {output, raw, _treg} โดยที่ output.people เก็บแถวข้อมูลของผู้ให้บริการ และ _treg.served_by บอกว่าใครเป็นผู้ตอบ รายการ people ที่ว่างเปล่านับเป็นไม่พบ

2. ค้นหาและเสริมข้อมูลอีเมล

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 คู่มือสกิลเตือนว่าผู้ให้บริการที่ใช้เฉพาะ LinkedIn มักคืนที่อยู่ของนายจ้างคนก่อน และการพบนั้นยังถูกเรียกเก็บเงิน ต้องการบริบทของบริษัทด้วยหรือไม่? เพิ่ม treg call treg.companies.enrich พร้อมโดเมน เพลย์บุ๊ก GTM ของ Treg แสดงการเรียกนั้นในรูปแบบ POST

3. ตรวจสอบก่อนที่ใครจะส่ง

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"}'

เครื่องมือตรวจสอบที่ถูกจัดเส้นทางคืนค่า valid, status และ score คุณยังสามารถรวมการตรวจสอบเข้ากับขั้นตอนที่ 2 ได้: ส่ง X-Treg-Route-Verify: true ไปกับ email find แล้วอ่าน _treg.verification.verdict (valid, invalid, catch_all, risky หรือ unknown) การตรวจสอบมีค่าใช้จ่ายเล็กน้อยของตัวเอง และการไม่พบจะไม่ถูกตรวจสอบเลย

การรันหนึ่งครั้งมีค่าใช้จ่ายเท่าไร? Treg เผยแพร่ใบเสร็จหนึ่งใบจากวันที่ 23 กันยายน 2026: บุคคลที่ระบุชื่อ 27 คน พบอีเมล 21 ฉบับ ตรวจสอบว่าส่งถึงได้ 20 ฉบับ รวม $0.58 โดยการไม่พบอยู่ที่ $0.00

เรียก Treg API ผ่าน HTTP แบบดิบ

เอเจนต์เป็นทางเลือก ไม่บังคับ ทุกการเรียก CLI สอดคล้องกับการเรียก HTTP หนึ่งครั้ง ดังนั้นคุณสามารถเขียนสคริปต์ไปป์ไลน์เดียวกันในภาษาใดก็ได้

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 - พิมพ์เฮดเดอร์ตอบกลับ ซึ่งเป็นที่อยู่ของ X-Treg-Cost-Micro และ X-Treg-Served-By มีสี่กฎที่ช่วยให้สคริปต์ไม่พบปัญหา:

อย่าใส่โทเคนใน `[REDACTED CREDENTIAL] เด็ดขาด เอกสารอ้างอิง API ระบุว่า REST ไม่สนใจมัน และ /call/ จะส่งต่อเฮดเดอร์นั้นไปยังผู้ให้บริการ มีเพียงปลายทาง MCP เท่านั้นที่อ่าน Bearer [REDACTED]
โทเคนส่วนตัวต้องมีทีม โทเคนลงชื่อเข้าใช้ยังต้องมี X-Treg-Org: <team-slug> ด้วย โทเคนของทีมและเอเจนต์มีทีมของมันอยู่แล้ว
เส้นทางแค็ตตาล็อกเป็นสาธารณะ GET https://treg.to/catalog/search?q=verify%20email ทำงานได้โดยไม่ต้องมีโทเคน ซึ่งมีประโยชน์สำหรับตรวจสอบ id ใน CI
คำตอบเป็นของผู้ให้บริการ บนเครื่องมือผู้ให้บริการโดยตรง Treg ส่งต่อเนื้อความตามต้นฉบับ ดังนั้นรูปร่างจึงเปลี่ยนไปตามผู้ให้บริการ เครื่องมือที่ถูกจัดเส้นทางเพิ่มออบเจกต์ output ที่ถูกทำให้เป็นมาตรฐานไว้ด้านบน

เก็บความลับให้ห่างจากโค้ด เก็บ TREG_TOKEN ไว้ในที่เก็บความลับ (ดูแนวปฏิบัติที่ดีที่สุดในการจัดการคีย์ API เหล่านี้)

ให้เอเจนต์ของคุณทดสอบด้วย Apidog CLI

เมื่อการติดต่อสื่อสารขึ้นอยู่กับการเรียกเหล่านี้ การเปลี่ยนแปลงที่เงียบงันก็สร้างความเสียหายได้: ผู้ให้บริการสลับกัน ค่าใช้จ่ายคืบคลานขึ้น หรือฟิลด์คำตัดสินหายไป เอเจนต์ของคุณสามารถป้องกันสิ่งนั้นด้วยชุดการทดสอบถดถอยใน Apidog CLI

ตั้งค่า CLI และสกิลเอเจนต์ของมันหนึ่งครั้ง:

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

จากนั้นให้พรอมต์หนึ่งข้อกับเอเจนต์ของคุณ:

text 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.

เอเจนต์อ่านสคีมาของ payload ตรวจสอบ JSON ของตัวเอง แล้วรันคำสั่งเช่นเหล่านี้:

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

ทุกการรันใช้เงินคงเหลือจริง ดังนั้นให้จำกัดชุดการทดสอบไว้ที่สามเคสโดยใช้อินพุตทดสอบที่รู้จัก และตั้งเวลาให้รันทุกวัน ไม่ใช่ทุกคอมมิต บรรทัด apidog run ... -r junit เดียวกันนี้ใส่ลงในไปป์ไลน์ได้ โดยคู่มือ Apidog CLI CI/CDมีตัวอย่าง GitHub Actions และ GitLab สำหรับการตั้งค่าเฉพาะเอเจนต์ ดูที่ Apidog CLI ใน Claude Code หรือ Apidog CLI ใน Codex แผนฟรีครอบคลุมผู้ใช้สูงสุด 4 คน

สรุป

Treg people search API เปลี่ยนการเสริมข้อมูลลีดให้เป็นการเรียกที่ถูกจัดเส้นทางสามครั้ง: ค้นหา, ค้นหาอีเมล, ตรวจสอบ ตรวจสอบราคาด้วย treg catalog get จำกัดการเรียกด้วย X-Treg-Route-Max-Cost ตรวจสอบทุกที่อยู่ และป้องกันการเรียกเหล่านั้นด้วยการรันทดสอบถดถอย Apidog CLI สำหรับเครื่องมือเอเจนต์เพิ่มเติม เซิร์ฟเวอร์ MCP ชั้นนำสำหรับ Claude Code และบทเรียนการทดสอบ API ที่ขับเคลื่อนด้วยเอเจนต์นี้เป็นบทอ่านต่อไปที่ดี

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

คำถามที่พบบ่อย

Treg people search API ฟรีหรือไม่? ไม่ทั้งหมด บัญชีที่ยืนยันใหม่จะได้รับเครดิต $1.00 หนึ่งครั้ง การไม่พบบนผู้ให้บริการที่คิดต่อความสำเร็จไม่มีค่าใช้จ่าย และบางเส้นทางเป็นแบบสาธารณะฟรี (แผน verify อีเมลระบุผู้ให้บริการที่ $0 เป็นอันดับแรกเมื่อวันที่ 3 พฤศจิกายน 2026) ทุกอย่างอื่นคิดค่าบริการต่อการเรียกจากยอดคงเหลือแบบเติมเงินในอัตราของผู้ให้บริการ

ฉันต้องมีบัญชี Apollo หรือ Hunter เพื่อใช้ Treg ไหม? ไม่ Treg เรียกผู้ให้บริการในบัญชีของตัวเองและเรียกเก็บเงินคุณต่อการเรียก หากทีมของคุณจ่ายให้ผู้ให้บริการอยู่แล้ว ให้ลงทะเบียนคีย์นั้นกับ Treg และการเรียกเหล่านั้นจะใช้คีย์นั้นและไม่ถูกเรียกเก็บเงิน

Treg สลับไปใช้ผู้ให้บริการรายอื่นหรือไม่? เฉพาะบนเครื่องมือ treg.* ที่ถูกจัดเส้นทางเท่านั้น พวกมันจะถอยไปยังผู้ให้บริการรายถัดไปเมื่อเกิดข้อผิดพลาดหรือไม่พบ โดยเริ่มจากถูกที่สุดก่อน ภายใต้ X-Treg-Route-Max-Cost เครื่องมือผู้ให้บริการโดยตรงจะไม่สลับผู้ให้บริการให้คุณเลย

ฉันจะรู้ได้อย่างไรว่าการเรียกหนึ่งครั้งมีค่าใช้จ่ายเท่าไร? อ่านเฮดเดอร์ตอบกลับ X-Treg-Cost-Micro (ไมโคร-USD) หรือ cost_usd ผ่าน MCP treg balance แสดงยอดคงเหลือและค่าใช้จ่ายล่าสุดของคุณ

ฉันใช้ Treg โดยไม่มี Claude Code หรือ Codex ได้ไหม? ได้ ใช้ CLI จากเชลล์ใดก็ได้ เรียก https://treg.to/call/<tool-id> ผ่าน HTTP ด้วย X-Treg-Token หรือเชื่อมต่อ https://treg.to/mcp/ กับ claude.ai หรือ ChatGPT เป็นคอนเน็กเตอร์แบบกำหนดเอง

DEV Community