Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: BotFriendly Stats API
description: A directory of services AI agents can actually use. Query, filter, and discover bot-friendly APIs, tools, and merchants by category, interface (MCP, OpenAPI, llms.txt) and agent payment/commerce protocol.
version: 1.0.0
contact:
url: https://botfriendly.xyz
servers:
- url: https://botfriendly.xyz/api/v1
tags:
- name: Stats
paths:
/stats:
get:
operationId: getStats
summary: Directory statistics
description: 'Aggregate stats for the whole directory: total services, per-category counts, and how many services support each protocol. Useful for a quick lay of the land before filtering.'
responses:
'200':
description: Directory stats including total services and protocol coverage
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
data:
type: object
properties:
total_services:
type: integer
categories:
type: object
additionalProperties:
type: integer
description: Service count per category slug
protocols:
type: object
additionalProperties:
type: integer
description: Service count per supported protocol
tags:
- Stats