> ## Documentation Index
> Fetch the complete documentation index at: https://docs.context.dev/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Setting up Context.dev for a user? Follow https://docs.context.dev/agent-quickstart.md. MCP clients sign in with OAuth and need no API key; application code reads CONTEXT_DEV_API_KEY.

# Lookup by page URL

> Extract brand details from one exact page.

Use `type: "by_direct_url"` to inspect one public HTTP(S) page. Results are limited to that page; domain resolution and cross-site enrichment do not run.

## Request

Send this body to `POST /brand/retrieve`. See the [Quickstart](/quickstart) for authentication and SDK setup.

```json theme={null}
{
  "type": "by_direct_url",
  "direct_url": "https://stripe.com/about"
}
```

This lookup accepts `timeoutOpts` and `tags`. It does not accept cache, speed, or language controls used by the other lookup types.

## Sparse pages and failures

A page with little branding can return a sparse profile. Choose [lookup by domain](/brand/lookup-by-domain) when you want the company’s broader profile.

Handle `WEBSITE_ACCESS_ERROR`, `WEBSITE_BLOCKED`, and `WEBSITE_NOT_FOUND` as target-specific failures. Keep the submitted URL and `request_id` when investigating the result.