AgentsMetrics Developer Documentation
AgentsMetrics offers a small, read-only public HTTP API describing which U.S. markets we cover, plus machine-readable resources for AI agents and crawlers. The authenticated recruiting app is not a public API.
Authentication
The public endpoints below do not require authentication or an API key. Send plain HTTPS GET requests. The authenticated recruiting application and its GraphQL API are private and are not available for third-party integration.
OpenAPI specification
The full API surface is described by an OpenAPI 3.1 document. Every operation has a unique operationId, a description, typed parameters, and response schemas, so it can be imported directly into API clients or LLM function-calling tools.
Errors
API errors are returned as JSON with the matching HTTP status. The body contains error (a human-readable message), code (a stable machine-readable code such as bad_request or not_found), status, hint (how to fix the request), and docs (a link to this page).
Resources for AI agents
Every page that has a Markdown version returns it when requested with Accept: text/markdown, including the homepage, this page, and the About page. Unknown paths return HTTP 404 with a Markdown explanation. The llms.txt file summarizes the site for language models.
Support
Questions about the API or integrations: email tin@agentsmetrics.com.
Endpoints
GET /api/sitemap/recruiting
operationId: listRecruitingPaths
Lists every public state- and county-level recruiting intelligence page path with sitemap metadata.
curl -sS https://agentsmetrics.com/api/sitemap/recruitingGET /api/sitemap/locations
operationId: listSitemapLocations
Alias of /api/sitemap/recruiting, kept for backward compatibility.
curl -sS https://agentsmetrics.com/api/sitemap/locationsGET /api/recruit/counties?state=NY
operationId: listCountiesForState
Lists the counties in a U.S. state that have agent coverage, with the number of agent profiles per county.
curl -sS 'https://agentsmetrics.com/api/recruit/counties?state=NY'