# freehire public API API

**Canonical:** https://apis.io/apis/freehire-me/freehire-public-api-api/  
**Provider:** Freehire — https://apis.io/providers/freehire-me/  
**Base URL:** https://freehire.me/api/v1  
**Documentation:** https://freehire.me/docs/api

freehire public API API is one of 2 APIs that [Freehire](https://apis.io/providers/freehire-me/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Public, read-only freehire API: search IT jobs, read the live filter

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/jobs/search` | Search open jobs |
| GET | `/agent/jobs/search` | Search open jobs for agents (full descriptions) |
| POST | `/ojcp/v1/search` | OJCP: search jobs |
| GET | `/ojcp/v1/jobs/{slug}` | OJCP: read one posting |
| GET | `/ojcp/v1/employers/{slug}` | OJCP: read an employer |
| GET | `/jobs/facets` | Get live filter vocabulary and counts |
| GET | `/suggest` | Complete what is being typed into a search box |
| GET | `/jobs/{slug}` | Get a job by slug |
| GET | `/jobs/{slug}/similar` | Find jobs similar to a job |
| GET | `/companies` | Search companies |
| GET | `/companies/{slug}` | Get company details and open jobs |
| GET | `/geo/cities` | Resolve a city name to the canonical cities facet value |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/freehire-me/openapi/_original/freehire-me-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/freehire-me/json-schema/freehire-me-job-schema.json
- **JSONSchema** — https://artifacts.apis.io/freehire-me/json-schema/freehire-me-company-detail-schema.json
- **JSONSchema** — https://artifacts.apis.io/freehire-me/json-schema/freehire-me-facets-envelope-schema.json
- **JSONSchema** — https://artifacts.apis.io/freehire-me/json-schema/freehire-me-pagination-meta-schema.json
- **JSONSchema** — https://artifacts.apis.io/freehire-me/json-schema/freehire-me-company-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/freehire-me/json-schema/freehire-me-company-ref-schema.json

## Other Freehire APIs (1)

- [Freehire Public API](https://apis.io/apis/freehire-me/freehire-public-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/freehire-me/freehire-public-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/freehire-me/.