# JobFinder public API

> Read-only access to current public JobFinder jobs and companies. There are no credentials, write operations, applications, inbox connections, or outreach actions on this API.

## Live endpoints

- Discovery: https://www.jobfinder-ai.com/api/v1
- Current jobs: https://www.jobfinder-ai.com/api/v1/jobs
- Companies with current jobs: https://www.jobfinder-ai.com/api/v1/companies
- OpenAPI 3.1: https://www.jobfinder-ai.com/openapi.json
- RFC 9727 API catalog: https://www.jobfinder-ai.com/.well-known/api-catalog
- Version and deprecation policy: https://www.jobfinder-ai.com/api/version-policy
- MCP server card: https://www.jobfinder-ai.com/.well-known/mcp/server-card.json
- MCP Streamable HTTP endpoint: https://www.jobfinder-ai.com/mcp

## Pagination and filtering

- List routes use cursor pagination and return 20 records by default.
- Pass limit from 1 through 100. Follow meta.nextCursor unchanged on the same collection.
- Job searches optionally accept an exact company display name in company.
- A cursor is bound to its collection and company filter; do not construct or edit it.

## Errors

- Malformed, duplicated, mismatched, or out-of-range inputs return a typed invalid_request JSON error with HTTP 400.
- Unknown routes or current-job ids return not_found with HTTP 404.
- Unsupported methods return method_not_allowed with HTTP 405 and an Allow header.
- A temporary inventory failure returns service_unavailable with HTTP 503.
- Error responses are not cached and link to the OpenAPI contract.

## Operating boundary

The public REST, MCP, and WebMCP surfaces only research current public inventory. Applying to jobs, connecting an inbox, preparing account-specific material, or sending outreach requires the signed-in product and explicit user review or approval.