# Vine API

> Structured data from any business URL. One API call to extract providers, offerings, and availability.

## Docs

- [Detect providers on a business URL](https://docs.vine.getcourtyard.ai/api-reference/detect.md): Synchronous. Renders the page, runs the 4-layer classifier, and returns detected providers + proposed connections in ~25 seconds.
- [Extract provider data from a business URL](https://docs.vine.getcourtyard.ai/api-reference/extract.md): Async. Detects providers, extracts data from each, returns via polling. Requires an `Idempotency-Key` header (optional — omit for a server-generated key).
- [Poll an extraction](https://docs.vine.getcourtyard.ai/api-reference/get-extraction.md): Readable only by the creating key.
- [Liveness + queue snapshot](https://docs.vine.getcourtyard.ai/api-reference/health.md)
- [Create an API key](https://docs.vine.getcourtyard.ai/api-reference/keys-create.md): Mints a new key. The `plaintext` field in the response is shown exactly once — store it securely.
- [List all API keys](https://docs.vine.getcourtyard.ai/api-reference/keys-list.md): Returns every key (including revoked) for audit visibility. No sensitive material (hashes, plaintexts) is included.
- [Revoke an API key](https://docs.vine.getcourtyard.ai/api-reference/keys-revoke.md): Soft-revokes the key (sets `revokedAt`). Idempotent — revoking an already-revoked key returns it unchanged.
- [Create an API key](https://docs.vine.getcourtyard.ai/create-api-key.md)
- [Quickstart](https://docs.vine.getcourtyard.ai/quickstart.md): Detect the providers behind a business URL and pull structured data in under 5 minutes.
- [Try it](https://docs.vine.getcourtyard.ai/try.md)

## OpenAPI Specs

- [openapi](https://docs.vine.getcourtyard.ai/openapi.json)