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

# Search brands

> Find brands we already hold by company name or domain, so you can turn what a user typed into a domain and then resolve it. Returns the domain, name, primary logo and primary colour — enough to render a picker. Never resolves a new domain, and is not billed.



## OpenAPI

````yaml https://api.hydrafetch.com/openapi.json get /v1/web/brand/search
openapi: 3.0.0
info:
  title: Hydrafetch API
  description: >-
    Hydrafetch is a web data API for LLMs and agents. Send a URL and get back
    clean Markdown, the page's own structured data, schema-shaped JSON, links,
    or a summary, with the navigation, banners and boilerplate stripped out.
    Scrape one page, crawl a whole site, run a search, or extract to a schema,
    all through one API with one response shape. Every call costs one credit a
    page whatever it took to fetch, and failures are never billed.


    Point us at a whole site and get every page. Ask a question and get answers
    with per-field

    confidence and the passage each value came from. You describe the outcome
    you want — the

    pipeline decides how to get it.


    ## Authentication


    Every request is authenticated with your API key in the `X-API-Key` header.
    Keys are scoped to a

    workspace and carry its credit balance.


    ## Credits


    Calls are billed in credits and charged only on success. A standard scrape
    is one credit; richer

    formats and the extraction tier cost more. Each response reports what it
    consumed.


    ## Conventions


    All timestamps are UTC ISO 8601. Long-running jobs (crawl, batch) return a
    job id you poll, or a

    webhook you register. Errors return a structured body with a stable `code`
    and an HTTP status.
  version: '1.0'
  contact:
    name: Hydrafetch
    url: https://hydrafetch.com
    email: support@hydrafetch.com
servers:
  - url: https://api.hydrafetch.com
    description: Production
security:
  - apiKey: []
tags:
  - name: Web Scraping
    description: >-
      Turn URLs into clean, LLM-ready content: scrape a single page, crawl or
      batch-scrape a whole site, map its URLs, search the web, and capture
      screenshots or images.
  - name: Web Extraction
    description: >-
      Pull schema-shaped JSON out of one or many pages, with optional per-field
      confidence and the source passage behind each value.
paths:
  /v1/web/brand/search:
    get:
      tags:
        - Web Scraping
      summary: Search brands
      description: >-
        Find brands we already hold by company name or domain, so you can turn
        what a user typed into a domain and then resolve it. Returns the domain,
        name, primary logo and primary colour — enough to render a picker. Never
        resolves a new domain, and is not billed.
      operationId: search
      parameters:
        - name: query
          required: true
          in: query
          description: Company name or domain to search for.
          schema:
            example: stripe
            type: string
        - name: limit
          required: false
          in: query
          schema:
            default: 10
            example: 10
            type: number
      responses:
        '200':
          description: Matching brands, best match first.
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key

````