Builder Data
Query professional data from Talent - a platform that tracks builders
When to use
- Find verified developers by location, skills, or identity (Twitter/GitHub/Farcaster/wallet)
- Check builder reputation (ranks by default, scores only when asked)
- Map Twitter/Farcaster accounts to wallet addresses
- Verify human identity from a wallet
- Search credentials (earnings, contributions, hackathons, contracts, etc.)
- Check the projects each builder is shipping
Required Credentials
| Variable | Required | Description | Get it at |
|---|---|---|---|
TALENT_API_KEY | Yes | Talent API key | https://talent.app/~/settings/api |
GITHUB_TOKEN | No | GitHub PAT for higher rate limits (60/hr → 5,000/hr) | https://github.com/settings/tokens |
Base URL: https://api.talentprotocol.com
Auth header: X-API-KEY: $TALENT_API_KEY
Workflow
- Identify the task — what does the user want?
- Pick the right endpoint — see endpoints.md
- Construct the API call — see use-cases.md
- Disambiguate — identity searches return impersonators. Pick the profile with the highest
builder_score. Never blindly use the first result. If no result has a meaningful score, report that no confident match was found. - For GitHub data — resolve GitHub username via
/accounts, then follow github-enrichment.md - Present results — default to
rank_position; only showpointswhen explicitly asked. Ifrank_positionisnull, fall back topoints. - If 0 results — broaden: try a different identity type
Endpoints
| Endpoint | Purpose |
|---|---|
/search/advanced/profiles | Search by identity, tags, rank, verification |
/profile | Get profile by ID |
/accounts | Get connected wallets, GitHub, socials |
/socials | Get social profiles + bios |
/credentials | Get data points (earnings, hackathons, etc.) |
/scores | Get ranks/scores. Slugs: builder_score, builder_score_2025, creator_score |
/human_checkmark | Check if human-verified. Response field: humanity_verified |
/data_points | List available data point slugs |
/data_issuers_meta | List all data issuers and credential slugs |
Critical Rules
- Ranks by default. Show
builder_score.rank_position. Only showpointswhen explicitly asked.rank_positionis oftennull— fall back topoints. - Default to
builder_scoreslug. API also returnsbuilder_score_2025(legacy) andcreator_score. - Location filtering is broken. Both GET param and POST
customQueryfail (302). Search broadly and filter client-side bystandardized_location/location. - Identity searches return impersonators. Disambiguate by picking the profile with the highest
builder_score. If no result has a meaningful score, report that no confident match was found. - URL encoding:
[=%5B,]=%5D, Space =%20 - Max 25 results per page. API rejects
per_pagevalues above 25. Paginate withpageparam for broader searches.
Alternative: Talent Agent CLI
If talent-agent is installed (npm install -g talent-agent), it provides natural language search without manual API calls. It can also run as an MCP server (talent-agent --serve) for use in Cursor, Claude, and other MCP-compatible clients.
References
- endpoints.md — Endpoint parameters and response schemas
- use-cases.md — Common patterns
- github-enrichment.md — GitHub API enrichment flow