# Taste Engine

- [Taste Engine Design API](https://docs.tastelabs.com/index.md): Extract complete designs systems from any URL, Search inspiration and Verify Brand adherence between designs.
- [Quickstart](https://docs.tastelabs.com/quickstart.md): Submit your first URL and read the extracted design system
- [How the engine works](https://docs.tastelabs.com/concepts/architecture.md): The Extractor, the Search, and the Verifier behind the API
- [Authentication](https://docs.tastelabs.com/concepts/authentication.md): Authenticate requests with an API key
- [Check brand adherence](https://docs.tastelabs.com/use-cases/brand-adherence.md): Score a rebuild, a generated page, or a redesign against the brand it should follow
- [Find inspiration](https://docs.tastelabs.com/use-cases/find-inspiration.md): Search the corpus for a look, study the results, and build from a real design system
- [Verification in an agent loop](https://docs.tastelabs.com/use-cases/agent-loop.md): Feed the verdict back to the agent that built the page and iterate
- [Extract a brand](https://docs.tastelabs.com/concepts/submissions.md): How an extraction runs, from submission to result
- [The design system](https://docs.tastelabs.com/concepts/design-system.md): What result.design_system contains
- [Prompt enhancement](https://docs.tastelabs.com/concepts/prompt-enhancement.md): Rewrite a prompt grounded in a brand profile
- [Brand search](https://docs.tastelabs.com/concepts/brand-search.md): Find brands in the corpus by aesthetic or by visual similarity
- [Brand adherence](https://docs.tastelabs.com/concepts/brand-adherence.md): Score how well a page follows a reference site's brand
- [Integrate Agents](https://docs.tastelabs.com/ai-tools/overview.md): Use the Taste Engine from your AI coding agent
- [MCP server](https://docs.tastelabs.com/ai-tools/mcp.md): Connect the Taste Engine MCP server to your AI coding agent
- [Skills](https://docs.tastelabs.com/ai-tools/skills.md): Install the Taste Engine agent skills into your coding agent
- [Errors & status codes](https://docs.tastelabs.com/concepts/errors.md): How the API reports success and failure
- [Introduction](https://docs.tastelabs.com/api-reference/introduction.md): Authenticate and call the Taste Engine Design API
- [Get current user](https://docs.tastelabs.com/api-reference/endpoint/get-current-user.md): Returns the identity and role associated with the authenticated API key.
- [Create submission](https://docs.tastelabs.com/api-reference/endpoint/create-submission.md): Creates an extraction job for a single URL. The job runs asynchronously: poll `GET /submissions/{id}/result` until the status is `completed` or `failed`.
- [List submissions](https://docs.tastelabs.com/api-reference/endpoint/list-submissions.md): Returns a paginated list of your submissions, newest first, deduplicated by URL. Filter by status, by the API key that created them, or by batch, and search by URL with `q`.
- [Get submission](https://docs.tastelabs.com/api-reference/endpoint/get-submission.md): Returns the current status of a single submission, including which step it is on.
- [Get submission result](https://docs.tastelabs.com/api-reference/endpoint/get-submission-result.md): Returns the unified result envelope for a submission, including the extracted design system and stored artifacts.
- [Download submission bundle](https://docs.tastelabs.com/api-reference/endpoint/download-submission.md): Returns a manifest of every file that makes up a completed extraction, so you can save the whole thing to disk: `guidelines.json` (the design system, inline in `content`), the captured HTML, CSS, and screenshot, and the logos, media, and icons referenced by the design system.
- [Update visibility](https://docs.tastelabs.com/api-reference/endpoint/update-visibility.md): Toggles whether a submission's result is public. Public results can be read from `GET /submissions/{id}/result` without authentication. Only the owner of the submission can change its visibility.
- [Enhance prompt](https://docs.tastelabs.com/api-reference/endpoint/enhance-prompt.md): Rewrites a prompt so that it is grounded in the brand profile extracted for a given submission. Useful for steering downstream generation toward a specific brand's look and feel.
- [Search brands](https://docs.tastelabs.com/api-reference/endpoint/search-brands.md): Searches the curated brand corpus for the aesthetic you describe in natural language, and returns ranked result cards.
- [Find similar brands](https://docs.tastelabs.com/api-reference/endpoint/find-similar-brands.md): Returns brands from the corpus that look like one of your completed extractions, as the same result cards as [`POST /search`](/api-reference/endpoint/search-brands).
- [List searches](https://docs.tastelabs.com/api-reference/endpoint/list-searches.md): Returns your past searches and similarity lookups, newest first. Free: listing history costs no credits.
- [Create brand-adherence job](https://docs.tastelabs.com/api-reference/endpoint/create-brand-adherence.md): Judges how well a page (the `source_url`) adheres to a reference site's brand (the `reference_url`). Use it to score a rebuild, a generated page, or a redesign against the brand it should follow.
- [List brand-adherence jobs](https://docs.tastelabs.com/api-reference/endpoint/list-brand-adherence-jobs.md): Lists the caller's brand-adherence jobs, most recent first. Filter by `status`; paginate with `limit` and `offset`.
- [Get brand-adherence job](https://docs.tastelabs.com/api-reference/endpoint/get-brand-adherence-job.md): Returns the live status of a brand-adherence job. `status` advances through `accepted`, `extracting`, and `judging` before reaching `completed` or `failed`; `current_step` names the pipeline stage in progress.
- [Get brand-adherence verdict](https://docs.tastelabs.com/api-reference/endpoint/get-brand-adherence-verdict.md): Returns the verdict for a brand-adherence job: one `score`, the `recommendations`, and the `fixes`.
- [Update job visibility](https://docs.tastelabs.com/api-reference/endpoint/update-brand-adherence-visibility.md): Toggles whether a job's verdict is public. Public verdicts can be read from `GET /judge/brand-adherence/{job_id}/result` without authentication. Only the owner of the job can change its visibility.

## OpenAPI Specs

- [openapi](/docs/api-reference/openapi.json)