---
title: "Compare the same name across suffixes"
method: GET
path: "/tld"
tags: ["Compare"]
---

# Compare the same name across suffixes

`GET /tld`

## Request

- Base URL: `https://vaneform.com/api/v1`
- URL: `https://vaneform.com/api/v1/tld`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `q` string, required
- `s` string

## Response `200`

Same row shape as /bulk. Spends 1 credit per compared domain with data.

- CompareResource
  - `q` string, required
  - `suffixes` string[]
  - `count` integer, required
  - `items` CompareItem[], required
    - `domain` string
    - `title` string
    - `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
    - `report_url` string, uri
  - `skipped` object[]: Lines that produced no row: invalid_domain (not a public website domain) or lookup_failed (this host failed; the other rows are unaffected, retry it alone). Omitted when empty.
    - `query` string, required
    - `reason` 'invalid_domain' | 'lookup_failed', required

## Other responses

- `400`: Request is malformed.
- `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)