apyhub
▣ MARKETING · SEO

Get Top Domains by Country API

What it does

Top Domains by Country returns a country-specific list of the most visited domains, sorted by coverage or rank. Send a country_code, and optionally set limit and sort_by, to get back the top domains for that market.

Use Top Domains by Country when you need a fast way to compare online presence across regions, seed a country-specific competitive analysis, or build dashboards around local web traffic patterns. The endpoint supports limit values from 1 to 500, and sort_by can be coverage or rank, so you can focus on breadth of reach or ordering by position.

Because the response schema is open-ended, expect a structured country-top-domains result rather than a fixed set of fields. That makes it suitable for downstream processing when you want to display, filter, or store the returned domain data in your own app.

Top Domains by Country fits SEO tooling, market research, and geographic benchmarking workflows where country-level domain popularity matters.

GET
Top Domains by Country
https://api.eu.apyhub.com/dosvak/top-domains-by-country/:country_code

QUICKSTART

GUIDE

Quickstart

Fetch the top domains for a country code, using the required path parameter and optional query filters.

curl -X GET "https://api.eu.apyhub.com/dosvak/top-domains-by-country/:country_code/" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a structured JSON object containing ranked domains and associated metadata for the requested country. The response may include additional fields depending on the available data.

{
  "country_code": "US",
  "total": 1742314,
  "domains": [
    {
      "val": "fsgw.org",
      "count": 1,
      "min_harmonic": 84072,
      "avg_ptile": 57
    }
],
  "attribution": [
  ]
}
TRY ITLIVE · 100 ATOMS
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 the top domains for a specific country code. The country code is supplied in the path, with optional query parameters to control how many domains are returned and how they are sorted.

Path Parameter(s)

AttributeTypeMandatoryDescription
country_codeStringYesCountry code identifying the country to retrieve top domains for.

Query Parameter(s)

AttributeTypeMandatoryDescription
limitIntegerNoMaximum number of domains to return. Default: 50. Minimum: 1. Maximum: 500.
sort_byStringNoSort order for the results. Allowed values: coverage, rank. Default: coverage.

Response

Returns a structured JSON object containing ranked domains and associated metadata for the requested country. The response may include additional fields depending on the available data.

Path parameters

Name
Type
Description
country_codeREQUIRED
string
—

Query parameters

Name
Type
Description
limitOPTIONAL
integer
—
DEFAULT 50
sort_byOPTIONAL
string
—
DEFAULT coverage
▣ 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.