---
title: "Retrieve website analysis for a business"
method: GET
path: "/v1/businesses/{business_id}/website"
tags: ["websites"]
---

# Retrieve website analysis for a business

`GET /v1/businesses/{business_id}/website`

## Request

- Base URL: `https://api.middesk.com`
- URL: `https://api.middesk.com/v1/businesses/{business_id}/website`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/middesk/apis/middesk-api/docs/v1/businesses/:business_id/website/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns website analysis data including domain info, pages, and quality indicators

## Path parameters

- `business_id` string, required

## Query parameters

- `include` string

## Response `200`

website analysis found

- Website
  - `object` 'website', required
  - `id` string, uuid, required
  - `url` string, uri, nullable, required: The URL that was passed or found for the Business
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `status` 'online' | 'offline' | 'unknown', required
  - `http_status_code` integer, nullable: HTTP response status code
  - `title` string, nullable: Website page title
  - `description` string, nullable: Website meta description
  - `domain` WebsiteDomain
    - `domain` string
    - `domain_id` string, nullable
    - `creation_date` string, date-time
    - `expiration_date` string, date-time
    - `registrar` WebsiteDomainRegistrar
      - `organization` string, nullable
      - `name` string
      - `url` string, uri, nullable
    - `redirected` boolean, nullable: Whether the domain redirects to a different URL
    - `url_shortener` boolean, nullable: Whether the domain uses a URL shortener service
    - `resolved_url` string, uri, nullable: The final URL after redirect resolution (present when redirected is true)
  - `pages` WebsitePagesItem[]: Website pages with screenshots
    - `url` string, uri
    - `category` string
    - `screenshot_url` string, uri
  - `parked` boolean, nullable, required: Whether the domain is parked
  - `submitted` boolean, required: Whether the website was submitted by user
  - `error` string, nullable: Error message if website analysis failed
  - `category` string, nullable: Website category classification
  - `platform` string, nullable: Website platform (e.g., instagram.com, facebook.com)
  - `posts_summary` string, nullable: Summary of posts found on the website or linked social media profiles
  - `reviews_summary` string, nullable: Summary of reviews found on the website or linked third-party profiles
  - `business_id` string, uuid, required
  - `business_name_match` boolean, required: Whether website content matches business name
  - `names` Name[]: Names found on website
    - `object` string, required
    - `id` string, uuid, required
    - `name` string, required
    - `submitted` boolean, required
    - `type` 'legal' | 'dba'
    - `business_id` string, uuid, required
    - `sources` Source[], required
      - `id` string, uuid, required
      - `type` string, required: Origin of the resource. `risk_analysis` indicates the resource was discovered by a Risk order; for such sources, `id` is the originating risk_assessment ID.
      - `metadata` object, required
  - `phone_numbers` WebsitePhoneNumber[], required: Phone numbers found on website
    - `object` 'phone_number'
    - `id` string, uuid
    - `number` string
    - `contact_type` string, nullable
    - `recommended` boolean, nullable
    - `submitted` boolean
    - `sources` Source[], nullable
      - `id` string, uuid, required
      - `type` string, required: Origin of the resource. `risk_analysis` indicates the resource was discovered by a Risk order; for such sources, `id` is the originating risk_assessment ID.
      - `metadata` object, required
  - `people` object[], nullable: People found on website
  - `addresses` WebsiteAddressesItem[], required: Addresses found on website
    - `object` string
    - `id` string, uuid
    - `address_line1` string, nullable
    - `address_line2` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postal_code` string, nullable
    - `full_address` string
    - `submitted` boolean
    - `sources` Source[]
      - `id` string, uuid, required
      - `type` string, required: Origin of the resource. `risk_analysis` indicates the resource was discovered by a Risk order; for such sources, `id` is the originating risk_assessment ID.
      - `metadata` object, required
  - `email_addresses` WebsiteEmailAddressesItem[], nullable: Email addresses found on website
    - `object` 'email_address'
    - `email` string
    - `id` string, uuid
    - `submitted` boolean
    - `sources` Source[]
      - `id` string, uuid, required
      - `type` string, required: Origin of the resource. `risk_analysis` indicates the resource was discovered by a Risk order; for such sources, `id` is the originating risk_assessment ID.
      - `metadata` object, required
  - `rating` WebsiteRating
    - `indicators` WebsiteIndicator[]
      - `type` 'domain_age' | 'top_level_domain' | 'content_diversity' | 'contact_info' | 'compliance_info' | 'page_count' | 'broken_links' | 'domain_consistency' | 'update_frequency' | 'filler_text' | 'image_quality' | 'last_updated' | 'third_party_profile_links' | 'us_business_presence' | 'spelling_and_grammar' | 'https' | 'domain_ownership', required
      - `name` string, required
      - `rating` 'positive' | 'negative' | 'neutral', required
      - `value` string, required
      - `description` string, required
    - `quality_rating` 'low' | 'moderate' | 'high' | 'not_available', required

## Other responses

- `404`: website not found

## Changes

- **2026-09-17** `4c9cd4e834ba`: 3 breaking, 1 warning, 4 info
  - added `#/components/schemas/NameType` to the `names/items/type` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/WebsiteDomain` to the `domain` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/WebsiteRating` to the `rating` response property `oneOf` list for the response status `200`
  - deleted the `header` request parameter `Authorization`
  - …4 more
- **2026-09-12** `668373c892ce`: 1 info
  - api operation id `getBusinessWebsite` removed and replaced with `websites_getBusinessWebsite`
- **2026-09-03** `ac0d9be94846`: 1 info
  - added the optional property `errors/items/parameter` to the response with the `404` status

[Operation history](https://skmtc.dev/middesk/apis/middesk-api/changes/v1/businesses/:business_id/website/get.md)

---

[API](https://skmtc.dev/middesk/apis/middesk-api.md) - [All operations](https://skmtc.dev/middesk/apis/middesk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/middesk/apis/middesk-api/revisions/adc98c847a77?raw)