---
title: "Read the cached full-site scale estimate"
method: GET
path: "/domains/{domain}/scale"
tags: ["Domain"]
---

# Read the cached full-site scale estimate

`GET /domains/{domain}/scale`

## Request

- Base URL: `https://vaneform.com/api/v1`
- URL: `https://vaneform.com/api/v1/domains/{domain}/scale`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `domain` string, required

## Response `200`

DomainResource with domain, status, refresh_policy, and the Scale family.

- DomainResource
  - `domain` string, required
  - `status` 'ready' | 'partial' | 'missing' | 'error', required
  - `refresh_policy` 'cache_only', required
  - `scale` ScaleResource
    - `status` 'ready' | 'partial' | 'missing' | 'error'
    - `title` string
    - `description` string
    - `month` string
    - `as_of` string
    - `confidence` 'low' | 'medium' | 'high'
    - `estimate` 'site' | 'search'
    - `visits` number, nullable
    - `visits_mom_change_pct` number, nullable
    - `global_rank` integer, nullable
    - `country_rank` object: country is an English country name, such as United States.
      - `country` string
      - `rank` integer
    - `bounce_rate` number, nullable: Ratio from 0 to 1.
    - `pages_per_visit` number, nullable
    - `time_on_site_seconds` number, nullable
    - `category` string
    - `category_rank` integer, nullable
    - `monthly_visits` object[]
      - `month` string
      - `visits` number
    - `sources` object
    - `top_regions` object[]
      - `country` string
      - `share` number
    - `top_keywords` object[]
      - `keyword` string
      - `search_volume_monthly` number
      - `estimated_visits` number
  - `registry` RegistryResource
    - `status` string
    - `created_at` string
    - `expires_at` string
    - `updated_at` string
    - `registrar` string
    - `name_servers` string[]
    - `statuses` string[]
    - `dnssec` boolean, nullable
    - `age_days` integer, nullable
    - `as_of` string
  - `profile` ProfileResource: Public site, DNS, hosting, email and TLS facts. Fields are omitted when unavailable. dns a, aaaa, mx, and ns are string arrays. email_auth spf, dmarc, mta_sts, bimi, and dkim are booleans.
    - `status` string
    - `requested_url` string, uri
    - `final_url` string, uri
    - `http_status` integer
    - `as_of` string
    - `confidence` string
  - `popularity` PopularityResource
    - `status` string
    - `link_rank` integer, nullable
    - `tld` string
    - `tld_rank` integer, nullable
    - `referring_ips` integer, nullable
    - `referring_subnets` integer, nullable
    - `rank_change` integer, nullable
    - `board_rank` integer, nullable
    - `as_of` string
    - `confidence` string
  - `baidu` BaiduResource: Cached Baidu rank. Opt-in include; not fetched by this GET.
    - `status` 'ready' | 'partial' | 'missing' | 'error'
    - `keyword_count` integer, nullable
    - `estimated_visits` object
      - `min` number
      - `max` number
    - `weights` object
    - `as_of` string
    - `confidence` string
  - `search` SearchResource: Saved Pro keyword rankings for the queried host. include_subdomains is false. keywords, pages, and competitors are capped at 25, 20, and 20. keyword_count, page_count, and competitor_count are totals and can exceed those arrays.
    - `status` string
    - `as_of` string
    - `confidence` string
    - `market` object
    - `include_subdomains` boolean
    - `organic_etv` number, nullable
    - `keyword_count` integer, nullable
    - `page_count` integer, nullable
    - `competitor_count` integer, nullable
    - `competitors_pending` boolean
    - `ai_overview_count` integer, nullable
    - `new_count` integer, nullable
    - `up_count` integer, nullable
    - `down_count` integer, nullable
    - `keywords` object[]
    - `pages` object[]
    - `competitors` object[]
  - `report_url` string, uri

## Other responses

- `401`: Missing or invalid bearer key.
- `429`: Credits or per-key rate limit (60/minute, 5,000/day).
- `500`: Unexpected server failure.

---

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