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

# GET /company

> Legal name, contact emails, addresses and key pages for the company behind a website. 5 credits.

Returns the organization behind a site under `data.company`.

**5 credits.** Failed requests are never charged.

> [card] [Guide: Company](https://docs.prefetch.io/company-data/company.md)
>
> Every field, curated and live answers, and examples.


## OpenAPI

````yaml GET /company
openapi: 3.1.0
info:
  title: Prefetch API
  description: >-
    Extract brand identity, company data, screenshots, IAB classifications, and
    clean page content from any URL.
  version: 1.0.0
  contact:
    email: support@prefetch.io
servers:
  - url: https://api.prefetch.io
    description: Production
security:
  - apiKey: []
tags:
  - name: Endpoints
    description: Data extraction endpoints. All require authentication and consume credits.
  - name: Health
    description: Health and readiness probes. No authentication required.
paths:
  /company:
    get:
      tags:
        - Endpoints
      summary: Extract company info
      description: >-
        Extracts the legal company name, contact email addresses, and physical
        addresses from a website. **Credit cost: 5.**
      operationId: getCompany
      parameters:
        - $ref: '#/components/parameters/url'
      responses:
        '200':
          description: Company information.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    $ref: '#/components/schemas/CompanyData'
                  meta:
                    $ref: '#/components/schemas/Meta'
                required:
                  - success
                  - data
                  - meta
              example:
                success: true
                data:
                  domain: stripe.com
                  url: https://stripe.com
                  company:
                    name: Stripe, Inc.
                    emails:
                      - support@stripe.com
                    addresses:
                      - 354 Oyster Point Blvd, South San Francisco, CA 94080
                meta:
                  requestId: b9e1a2f3-4c5d-6e7f-8a9b-0c1d2e3f4a5b
                  durationMs: 3210
        '400':
          description: Invalid or missing URL.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Revoked key, expired key, credit limit, or blocklisted URL.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: URL hostname could not be resolved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service temporarily busy — retry shortly.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '504':
          description: Request timed out.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  parameters:
    url:
      name: url
      in: query
      required: true
      description: >-
        The website URL to process. `https://` is prepended automatically if no
        protocol is provided.
      schema:
        type: string
        example: https://stripe.com
  schemas:
    CompanyData:
      type: object
      properties:
        domain:
          type: string
          description: Normalized domain.
          example: stripe.com
        url:
          type: string
          format: uri
          description: The URL that was scraped.
          example: https://stripe.com
        company:
          $ref: '#/components/schemas/CompanyInfo'
      required:
        - domain
        - url
        - company
    Meta:
      type: object
      properties:
        requestId:
          type: string
          format: uuid
          description: Unique identifier for this request.
          example: a3f2c1d4-7b6e-4f2a-9c1d-8e3f2a1b4c5d
        durationMs:
          type: integer
          nullable: true
          description: Time taken to process the request in milliseconds.
          example: 1842
      required:
        - requestId
        - durationMs
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - false
          description: >-
            Always false. Absent, like `meta`, on authentication and rate-limit
            errors, which are answered before a request is processed.
        error:
          type: string
          description: >-
            Human-readable error message. The wording can change: branch on
            `error_code`.
          example: Credit limit exceeded
        error_code:
          type: string
          enum:
            - INVALID_REQUEST
            - PAYLOAD_TOO_LARGE
            - NOT_FOUND
            - CONFLICT
            - UNAUTHORIZED
            - FORBIDDEN
            - CREDITS_EXHAUSTED
            - RATE_LIMITED
            - CONCURRENCY_LIMITED
            - URL_BLOCKED
            - URL_NOT_PERMITTED
            - DNS_RESOLUTION_FAILED
            - TARGET_BLOCKED
            - TARGET_CONNECTION_FAILED
            - TARGET_TIMEOUT
            - TARGET_SSL_ERROR
            - TARGET_SERVER_ERROR
            - TARGET_CLIENT_ERROR
            - TARGET_NOT_A_PAGE
            - NO_LINKS_FOUND
            - TARGET_UNLOADABLE
            - RESEARCH_INCONCLUSIVE
            - TIMEOUT
            - SERVICE_BUSY
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
          description: >-
            What went wrong, for machines. Stable: a code keeps its meaning once
            published. See [Error handling](/concepts/errors).
          example: CREDITS_EXHAUSTED
        retryable:
          type: boolean
          description: >-
            Whether the same request can succeed if sent again after a short
            wait (honour `Retry-After` when present). False for problems with
            the request or the target.
          example: false
        retryAfterSeconds:
          type: integer
          description: 'On `RATE_LIMITED`: seconds until a request will be accepted.'
        limit:
          type: integer
          description: >-
            On `CONCURRENCY_LIMITED`: how many requests this key may have in
            flight.
        meta:
          $ref: '#/components/schemas/Meta'
      required:
        - error
        - error_code
        - retryable
    CompanyInfo:
      type: object
      properties:
        name:
          type: string
          nullable: true
          description: Legal entity name of the company.
          example: Stripe, Inc.
        display_name:
          type: string
          nullable: true
          description: The short name people use for the company.
          example: Stripe
        parentCompany:
          type: string
          nullable: true
          description: The parent company, when known.
        employeeCount:
          type: integer
          nullable: true
          description: Approximate number of employees, when known.
          example: 8000
        foundedYear:
          type: integer
          nullable: true
          description: The year the company was founded, when known.
          example: 2010
        isNsfw:
          type: boolean
          description: Whether the site's content is not safe for work.
          example: false
        emails:
          type: array
          items:
            type: string
            format: email
          description: Contact email addresses found on the site.
          example:
            - support@stripe.com
        addresses:
          type: array
          items:
            oneOf:
              - type: object
                properties:
                  raw:
                    type: string
                    description: The address as written.
                  street:
                    type: string
                    nullable: true
                  city:
                    type: string
                    nullable: true
                  state:
                    type: string
                    nullable: true
                  postal_code:
                    type: string
                    nullable: true
                  country:
                    type: string
                    nullable: true
              - type: string
          description: >-
            Physical addresses found on the site. Each is usually an object with
            `raw` and its parts, any of which can be null. Handle a plain string
            too.
          example:
            - raw: South San Francisco, California, United States
              street: null
              city: South San Francisco
              state: California
              postal_code: null
              country: United States
        social_links:
          $ref: '#/components/schemas/SocialLinks'
        links:
          type: object
          properties:
            about:
              type: string
              nullable: true
            pricing:
              type: string
              nullable: true
            careers:
              type: string
              nullable: true
            contact:
              type: string
              nullable: true
            blog:
              type: string
              nullable: true
            docs:
              type: string
              nullable: true
          required:
            - about
            - pricing
            - careers
            - contact
            - blog
            - docs
          description: >-
            The company's key pages, as its homepage links them. null where the
            homepage links none.
          example:
            about: https://stripe.com/about
            pricing: https://stripe.com/pricing
            careers: https://stripe.com/jobs
            contact: https://stripe.com/contact/sales
            blog: https://stripe.com/blog
            docs: https://docs.stripe.com/
      required:
        - name
        - emails
        - addresses
    SocialLinks:
      type: object
      additionalProperties:
        type: string
      description: Social media profile URLs keyed by platform name.
      example:
        twitter: https://twitter.com/stripe
        linkedin: https://linkedin.com/company/stripe
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your Prefetch API key. Obtain one from the dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.