# OpenAdLibrary Public API 0.1.0

LLM-friendly entry point for the OpenAdLibrary public developer API. Treat the OpenAPI document as the source of truth for endpoints, schemas, authentication, parameters, responses, and examples.

## Canonical files

- [OpenAPI JSON](/api/openapi.json): machine-readable source of truth (public `/api/v1` surface).
- [Full Markdown reference](/api/llms-full.txt): complete LLM-friendly reference generated from OpenAPI.

## API summary

- OpenAPI version: 3.0.3
- Operation count: 42
- Tags: public-data

## Guidance for AI agents

- Authenticate with your own key (`Authorization: Bearer <key>` or `x-api-key`). Get one from Settings → API keys.
- The hosted MCP server at `https://mcp.openadlibrary.com/mcp` wraps this same surface as agent tools.
- Prefer documented examples over inferred payloads; do not invent fields absent from the schemas.
- Only public, leak-safe data is exposed: never expect raw click URLs, redirect chains, or internal ids.