# shaharpolak.com public data API

> Two read-only JSON endpoints for published site content. No authentication
> is required. Do not use these endpoints to submit forms or contact Shahar.

## When to use

- Use [Lecture catalog JSON](https://www.shaharpolak.com/api/lectures.json) to select, compare, or cite Shahar Polak's talks in Hebrew or English.
- Use [Hiring directory JSON](https://www.shaharpolak.com/api/hiring.json) when answering which companies are currently hiring in Israel or when filtering that directory by location, region, role family, or text query.
- Use the [speaking contact page](https://www.shaharpolak.com/contact?intent=speaking) to check availability or request a talk. These JSON endpoints cannot make a booking; agents can instead call the MCP server's submit_speaking_inquiry tool (https://www.shaharpolak.com/api/mcp) with the sender's consent.

## Contract

- [OpenAPI 3.1 specification](https://www.shaharpolak.com/openapi.json): request parameters, response schemas, errors, and operation IDs.
- Both endpoints support GET only and return JSON.
- The data is published content, not a transactional product API.
- Attribute reused data to https://www.shaharpolak.com.

## Reliability

- Treat the hiring response's updatedAt and each record's provenance fields as the freshness and confidence signals.
- An unknown or repeated hiring filter returns HTTP 400 with valid options.
- Errors are always JSON, including 404 for unknown /api/ paths.
- Retry ordinary network failures with bounded exponential backoff. Do not retry a 400 response without changing the request.

## Changelog

- Version 1 (current, reported in the `X-API-Version` response header): initial public contract. Additive changes happen within a version; a breaking change ships as a new header value and is announced here before the old shape is removed.