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

# Search by website URL

## Find company by website URL

Find a company by providing its website URL. Our system analyzes the website and matches it to companies in our database. The response includes the company ID that you can use with other endpoints to retrieve detailed information like financials, shareholders, and ownership structure. This is useful for enriching web data with company information.

**Cost:** 10 credits


## OpenAPI

````yaml GET /v0/search/lookup
openapi: 3.1.0
info:
  title: OpenRegister API
  version: 2.5.0
  description: >
    API for accessing comprehensive company data from official registers.

    This API provides access to company information, shareholder data, financial
    reports, and contact details.
servers:
  - url: https://api.openregister.de
    description: Production
security:
  - BearerAuth: []
paths:
  /v0/search/lookup:
    get:
      tags:
        - v0
      summary: Find company by website URL
      operationId: lookupCompanyWebsite
      parameters:
        - name: url
          in: query
          required: true
          schema:
            type: string
            format: uri
          description: |
            Website URL to search for.
            Example: "https://openregister.de"
      responses:
        '200':
          description: Successfully retrieved company data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyLookupResponse'
        '400':
          description: Bad Request - Invalid parameters provided
        '401':
          description: Unauthorized - Authentication required
        '404':
          description: Not found - Company not found
        '429':
          description: Too Many Requests - Rate limit exceeded
        '500':
          description: >-
            Internal Server Error - An error occurred while processing the
            request
      x-codeSamples:
        - lang: JavaScript
          source: >-
            import Openregister from 'openregister';


            const client = new Openregister({
              apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted
            });


            const response = await client.search.lookupCompanyByURL({ url:
            'https://example.com' });


            console.log(response.company_id);
        - lang: Python
          source: |-
            import os
            from openregister import Openregister

            client = Openregister(
                api_key=os.environ.get("OPENREGISTER_API_KEY"),  # This is the default and can be omitted
            )
            response = client.search.lookup_company_by_url(
                url="https://example.com",
            )
            print(response.company_id)
        - lang: Go
          source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/oregister/openregister-go\"\n\t\"github.com/oregister/openregister-go/option\"\n)\n\nfunc main() {\n\tclient := openregister.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tresponse, err := client.Search.LookupCompanyByURL(context.TODO(), openregister.SearchLookupCompanyByURLParams{\n\t\tURL: \"https://example.com\",\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.CompanyID)\n}\n"
        - lang: CLI
          source: |-
            openregister search lookup-company-by-url \
              --api-key 'My API Key' \
              --url https://example.com
components:
  schemas:
    CompanyLookupResponse:
      type: object
      properties:
        company_id:
          type: string
          description: |
            Unique company identifier.
            Example: DE-HRB-F1103-267645
        email:
          type: string
          description: |
            Email address of the company.
            Example: "info@maxmustermann.de"
        phone:
          type: string
          description: |
            Phone number of the company.
            Example: "+49 123 456 789"
        vat_id:
          type: string
          description: |
            Value Added Tax identification number.
            Example: "DE123456789"
      required:
        - company_id
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |
        API Key Authentication
        Provide your API key as a Bearer token in the Authorization header.

````