▣ MARKETING · SEO

Find Similar Domains API

What it does

Similar Domains finds websites related to a given domain name. Send a domain query parameter, and optionally set limit to control how many results you want back. The service exposes two GET endpoints: one for general similar-domain lookup, and one that returns similar sites by domain.

Use Similar Domains when you want to expand a competitor list, surface lookalike sites for market research, or recommend alternative destinations to users. A typical workflow is to check a known domain such as shazam.com and retrieve a bounded list of related sites for analysis or enrichment.

The response schema is open-ended, so the service returns a structured JSON object without promising specific fields beyond what the API provides. That makes it useful as a lookup layer in pipelines where you need domain similarity data, but do not want to hard-code a narrower shape.

Pair Similar Domains with enrichment, lead-scoring, or SEO workflows when you need a fast way to start from one site and explore nearby properties in the same space.

▣ ENDPOINT 01 / 02

GET

Similar domains

http://localhost:8080/pankajretestflows/similar-domains

QUICKSTART

GUIDE

Quickstart

Fetch similar domains for a given domain name. This minimal example uses the required domain query parameter and the default limit.

curl -X GET "http://localhost:8080/pankajretestflows/similar-domains?domain=shazam.com&limit=20" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object. The schema does not declare any fixed top-level fields, so the response shape can vary.

{
  "domain": "example.com",
  "count": 2,
  "results": [
    {
      "id": "123456",
      "title": "Example Site",
      "domain": "related-site.com",
      "site_url": "https://related-site.com",
      "description": "A website related to the provided domain.",
      "score": 95.8
    }
  ],
  "attribution": [
    {
      "source": "Example Dataset"
    }
  ]
}

TRY ITLIVE · 10 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns similar domains for the provided domain name. The response schema is an object with no defined top-level fields in the schema, so the exact success payload shape is not yet captured here.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return. Default: 20. Minimum: 1. Maximum: 100.
domain	String	Yes	The domain to find similar domains for. Minimum length: 3.

Response

Returns a JSON object. The output schema does not define any specific top-level fields, and additionalProperties is allowed, so the exact response structure is not yet fixed in the schema.

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 20

domainREQUIRED

string

—

▣ ENDPOINT 02 / 02

GET

Similar sites by domain

http://localhost:8080/pankajretestflows/similar-domains/by-domain

QUICKSTART

GUIDE

Quickstart

Fetch similar sites for a domain using the required domain query parameter.

curl -X GET "http://localhost:8080/pankajretestflows/similar-domains/by-domain?domain=shazam.com" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object. The response schema does not declare any fixed top-level fields, so the shape may vary.

{
  "domain": "example.com",
  "count": 2,
  "results": [
    {
      "id": "123456",
      "title": "Example Site",
      "domain": "related-site.com",
      "site_url": "https://related-site.com",
      "description": "A website related to the provided domain.",
      "score": 95.8
    }
  ],
  "attribution": [
    {
      "source": "Example Dataset"
    }
  ]
}

TRY ITLIVE · 10 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns similar sites for a provided domain. The endpoint accepts the domain to analyze, with an optional limit on how many results to return.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of similar sites to return. Default: 20. Minimum: 1. Maximum: 100.
domain	String	Yes	The domain to look up. Minimum length: 3 characters.

Response

Returns a JSON object. The response schema does not declare any fixed top-level fields; it allows additional properties, so the exact success payload shape is not specified in the schema.

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 20

domainREQUIRED

string

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.