Services & search

GET/api/v1/services

List and filter all services. Returns paginated results with full protocol details.

parameters

• categoryfilter by category id (think, see, hear-speak, create, remember, search, browse, communicate, execute, pay, shop, markets, platforms, identify, monitor, other). Merged categories still accept their old slugs (trade, bet, connect, automate, locate, book, sign, hire), which select just that slug
• has_mcp=trueonly services with MCP servers
• verified_interfaceson every service, the badges we actually fetched and confirmed; a flag that is true but absent here is claimed, not verified
• accepts_mpp=trueonly services accepting MPP
• accepts_x402=trueonly services accepting x402
• has_skill_file=trueonly services with skill files
• has_llms_txt=trueonly services with llms.txt
• auth_methodfilter by auth (api-key, m2m-oauth, bot-token, wallet, x402-none, none)
• searchfull-text search across name, description, tags
• min_scoreminimum bot-friendly score (1-5)
• sortscore (default), votes, name, newest
• promotedtrue for promoted only, false for organic only
• page, per_pagepagination (default 1, 20; max 100)

example

curl "https://www.botfriendly.xyz/api/v1/services?category=browse&has_mcp=true"

GET/api/v1/services/{slug}

Get full details for a single service including all protocol support, URLs, and metadata.

example

curl "https://www.botfriendly.xyz/api/v1/services/browserbase"

GET/api/v1/search

Full-text search across services. Returns results ranked by bot_score.

parameters

• q (required)search query (supports websearch syntax)
• categoryfilter by category id (same rules as /services)
• page, per_pagepagination (default 1, 20; max 100)

example

curl "https://www.botfriendly.xyz/api/v1/search?q=vector+database"