Find and shortlist recruiting firms

Find and shortlist US recruiting/staffing firms via ServiceGraph API

Business procuring an external recruiting or staffing firm (RPO, executive search, contingent staffing) to handle hiring.

• · Search scope: industry (fixed: hr_recruiting_staffing), sub-type specialization (keyword search), geography (US only)
• · Shortlisting criteria (size, vertical, service type)

• · Firm discovery with tag/check/explore tiers (free, IP-throttled)
• · Search results with firm names, status (brief cards, no contact)
• · Firm details (URL, phone, email, social, address) for shortlisted firms only

• · ServiceGraph API (https://api.servicegraph.co)
• · ServiceGraph MCP server (if loaded, preferred for authed tier with OAuth 2.1 PKCE)
• · Plain curl + OTP for authed tier if MCP not available

• · Procurement use case (procuring external recruiting firm service), NOT hiring an in-house employee
• · Bearer token or OTP for /search and /get endpoints
• · Budget for 200 unique firms/month (/search) + 50 unique /get calls

• · Wrong use case (hiring an employee vs. procuring a firm service) → entire search invalid
• · Confusing non-US firms or individual freelancers → false positives outside ServiceGraph scope
• · Over-exhausting /get quota on candidates before shortlisting → runs out of quota mid-evaluation

• · Explicit boundary definition: procurement vs. employee hiring
• · Four-tier funnel with quota accounting: /tags (free), /check (free), /explore (free+throttled), /search+/get (paid)
• · MCP server pattern match (prefer authed MCPs over REST + OTP)
• · Quota rule: unique firm viewed per month, not per call