Website Rank API: Get a Website's Global Rank

You need to rank and qualify domains before they flow into your stack—whether that’s to block low-quality inventory, enforce brand-safety thresholds, enrich signups with traffic context, or audit where ads run. By the end of this guide, you’ll know how to call Klazify’s traffic intelligence endpoint to get a website’s global rank, country rank, category rank, monthly visits, engagement metrics, traffic sources, and top countries, and how to combine that with categorization data to automate decisions at scale.

Why Klazify is the best fit when you care about rank and category together

Ranking a domain without understanding its topic can produce false positives in ad tech, filtering, and enrichment. Klazify brings both: traffic intelligence for rank and engagement, plus IAB-based categorization to keep your decisions context aware.

• Accurate website categorization using AI: The API analyzes full-site content rather than just metadata, so when you gate inventory based on rank you can also verify it’s relevant (for example, distinguishing general news from niche sub-verticals within News & Politics).
• Global coverage: Many high-traffic properties aren’t English-only. Klazify handles multi-language sites so rank and categories reflect real-world audiences across regions.
• Real-time classification: Fresh content means shifting categories; Klazify returns up-to-date categorization so rank thresholds you set for sponsorships or ad placements stay current.
• Industry-level categories (IAB): The IAB taxonomy is standard in ad ops and brand safety. With it, you can enforce rules like “only accept placements in Business/Finance above a rank threshold.”
• Simple API integration: A straightforward REST interface lets you pull rank, visits, engagement, and categories in the same workflow—ideal for ETL, streaming evaluations, or server-side checks.
• Compliance and filtering: Combine IAB categories, brand-safety cues, and rank/engagement to detect, block, or whitelist domains programmatically.

What you can extract from the Website Rank and Traffic Intelligence endpoint

Use the traffic intelligence endpoint to power ranking- and quality-based rules. You will work with these fields as returned by the API:

• global_rank: A website’s worldwide rank.
• country_rank: A website’s rank within a specific country or its main country.
• category_rank: Rank within a topical category (useful when gating by vertical quality thresholds).
• monthly_visits: Estimated monthly visit counts.
• engagement: Typical engagement measures such as visit duration, pages per visit, and bounce rate (interpretation and use depend on your decision logic).
• traffic_sources: Relative contribution of channels like direct, search, social, referrals, etc.
• top_countries: Countries that contribute the most traffic (vital when your campaigns target specific markets).

These are the core signals teams use to:

• Block or allow ad placements based on rank and top countries.
• Enrich CRM/company profiles with visit volume and primary geos.
• Score leads by inferred web reach or prioritize outreach by category_rank within an industry.
• Audit partner and affiliate lists, pruning long-tail sites below thresholds.

Call the endpoint: curl you can paste into your terminal

The traffic intelligence endpoint uses a POST request with a Bearer token and a JSON body specifying the URL you want to analyze.

curl -X POST "https://www.klazify.com/api/domain_traffic_intelligence" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://cbsnews.com"}'

Operational notes:

• Use HTTPS only. Set a reasonable timeout in your HTTP client.
• Failed or unreachable calls are not billed.
• Cache responses per domain to reduce repeat lookups and latency downstream (consider a TTL that matches how often you need fresh rank/signals).

Parse the response in code and wire it into your pipeline

This example demonstrates how to request rank and traffic intelligence and read the fields used for gating and enrichment. Adjust the parsing to your own data model.

import os
import json
import requests

API_KEY = os.getenv("KLAZIFY_API_KEY", "YOUR_API_KEY")
ENDPOINT = "https://www.klazify.com/api/domain_traffic_intelligence"

def fetch_traffic_intel(url):
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
payload = {"url": url}
resp = requests.post(ENDPOINT, headers=headers, json=payload, timeout=20)
resp.raise_for_status()
return resp.json()

def evaluate_domain(url):
data = fetch_traffic_intel(url)

# Defensive parsing: only access fields that exist in the payload.
global_rank = data.get("global_rank")
country_rank = data.get("country_rank")
category_rank = data.get("category_rank")
monthly_visits = data.get("monthly_visits")
engagement = data.get("engagement", {})
traffic_sources = data.get("traffic_sources", {})
top_countries = data.get("top_countries", [])

# Example rules (replace with your own):
# - Require global_rank threshold
# - Require at least one top country to match a target market
target_markets = {"US", "GB", "DE"}
markets_match = any(
(c.get("country_code") in target_markets) for c in top_countries if isinstance(c, dict)
)

decision = {
"allow": (isinstance(global_rank, int) and global_rank <= 50000) and markets_match,
"reason": "Meets rank and geo criteria" if markets_match else "Geo mismatch or rank too low",
"global_rank": global_rank,
"country_rank": country_rank,
"category_rank": category_rank,
"monthly_visits": monthly_visits,
"engagement": engagement,
"traffic_sources": traffic_sources,
"top_countries": top_countries
}
return decision

if __name__ == "__main__":
url = "https://cbsnews.com"
result = evaluate_domain(url)
print(json.dumps(result, indent=2))

How to use the fields:

• global_rank and country_rank: Gate inventory, pick sponsorships, or trigger manual review for borderline ranks.
• category_rank: Normalize quality comparisons inside a vertical when global rank is skewed by cross-vertical giants.
• monthly_visits: Use as a size proxy for lead scoring and prioritization in CRMs.
• engagement: Helpful heuristics for content quality filters (e.g., bounce rate thresholds for content syndication partners).
• traffic_sources: Identify sites with disproportionate paid vs. organic discovery when that matters to your quality rules.
• top_countries: Ensure geos align with your campaign’s target markets or compliance constraints.

Combine traffic intelligence with categorization and company data

In many workflows you’ll fetch rank first, then confirm the site’s topical fit and brand-safety posture using Klazify’s categorization. Here is the official categorization response sample—use it to map IAB categories and enrich a record with company metadata, logos, and related domains.

{
"domain": {
"categories": [
{
"confidence": 0.92,
"name": "/Computers & Electronics/Consumer Electronics",
"IAB-632-596": "Consumer Electronics/Technology & Computing/Consumer Electronics"
},
{
"confidence": 0.89,
"name": "/Internet & Telecom/Mobile & Wireless/Mobile Phones"
}
],
"social_media": null,
"logo_url": "https://klazify.s3.amazonaws.com/2110787991611585019600ed5fb1d1300.04730104.png"
},
"success": true,
"objects": {
"company": {
"url": "https://www.apple.com/",
"name": "Apple",
"city": "Cupertino",
"stateCode": "CA",
"countryCode": "US",
"employeesRange": "100K+",
"revenue": 274515000000,
"raised": null,
"tags": [
"E-commerce",
"Consumer Electronics",
"Mobile",
"B2C"
],
"tech": [
"omniture_adobe_analytics",
"atlassian_confluence",
"successfactors",
"apache_apex",
"talend",
"oracle_peoplesoft",
"salesforce",
"stripe",
"dell_boomi_atomsphere",
"gigya",
"sage_50cloud",
"quickbooks",
"webmethods",
"apache_tomcat",
"alteryx",
"tibco_rendezvous",
"atlassian_jira",
"..."
]
}
},
"domain_registration_data": {
"domain_age_date": "1987-02-19",
"domain_age_days_ago": "13026",
"domain_expiration_date": "2030-02-20",
"domain_expiration_days_left": "123"
},
"similar_domains": [
"bestbuy.com",
"icloud.com",
"microsoft.com",
"macrumors.com",
"google.com",
"samsung.com",
"twitter.com",
"hp.com",
"bhphotovideo.com",
"dell.com"
]
}

How to use these fields with rank:

• domain.categories and IAB-... fields: Map to your internal taxonomy and brand-safety policies. Keep a translation table from IAB to your in-house tags.
• domain.logo_url: Display in internal tools when reviewing rank decisions or account enrichment outcomes.
• objects.company.*: Sync name, location, employeesRange, tags, and tech into CRM profiles for richer segmentation paired with monthly_visits and top_countries signals.
• domain_registration_data: Use domain age and expiration to flag newly registered or soon-to-expire sites for special handling.
• similar_domains: Expand lookalike discovery workflows; optionally apply the rank endpoint to these domains in batch to pre-qualify new partners.

Field reference at a glance

Pipeline design: batching, caching, rate considerations, and unknowns

Batching

When evaluating many domains (e.g., partner lists, ad exchanges, or nightly CRM enrichment), run requests in controlled batches and parallelize to meet your SLA. Keep batch sizes and concurrency within your environment’s limits. If you need more throughput, coordinate with your team’s job scheduler to shard work by domain hash to avoid hot shards.

Caching

Cache traffic intelligence per domain with a TTL that suits your freshness needs (e.g., daily or weekly for rank/visits; shorter for frequent checks). For categorization, cache longer and invalidate when you detect material content shifts or at defined intervals.

Rate limits

If your organization enforces internal rate caps or backpressure, add client-side throttling and exponential backoff on HTTP 429 or transient errors. Align retries with your job window so you don’t delay downstream tasks.

Unknown or new domains

Some domains will be newly registered, low-traffic, or otherwise not fully resolved. Handle null or missing fields gracefully. Queue these domains for recheck after a backoff period and log them separately so operations can monitor coverage over time.

Mapping to your taxonomy

If you maintain a custom category system, keep a deterministic mapping from IAB categories to your tags. When a category has multiple possible mappings, prefer the one with the higher confidence score. Maintain an overrides table for strategic domains.

Decision playbooks you can implement today

• Ad placement gate: allow a site only if global_rank ≤ threshold, top_countries includes a target market, and domain.categories does not match blocked IAB groups.
• Signup enrichment: on domain capture, fetch monthly_visits, global_rank, and employeesRange to score accounts in your CRM and route to the right sales segment.
• Affiliate audit: weekly re-scan for rank deltas and downgrade partners that drop below category_rank thresholds inside their vertical.
• Content filtering: combine IAB category checks with engagement heuristics to detect overtly low-quality destinations for network policies.

Monitoring, retries, and data hygiene

• Timeouts: set client timeouts and capture partial failures; requeue failed domains. Failed or unreachable calls are not billed.
• Idempotency: avoid duplicate charges by deduping incoming domain events before calling the API.
• Change detection: store prior rank and monthly_visits and compute deltas. Trigger alerts on significant movement.
• Normalization: lower-case domains, strip URL fragments/query params when appropriate for domain-level intelligence; for page-level classification, pass full URLs to categorization.

Getting started, pricing, and useful links

Create an account to obtain your API key and begin testing. The Starter plan is $39.99/mo with a 7-day trial, and failed or unreachable calls are not billed. You can integrate immediately with curl and a few lines of Python or JavaScript.

• Register to get your API key and start your trial.
• Read the Documentation for request details and response fields.
• Explore model coverage and product notes in the MCP.

When you’re ready to automate beyond one-off checks, visit https://www.klazify.com for an overview of features across categorization, company data, and domain signals, and share the link with teammates who will depend on these results. You can always return to https://www.klazify.com to review capabilities as your requirements evolve.

FAQ

• Can I call the traffic intelligence endpoint with full URLs or just domains?
  Provide a URL in the JSON body. For domain-level rank and traffic, normalize to the registrable domain before caching so you avoid duplicate lookups.
• How often should I refresh rank and monthly visits?
  Set a refresh cadence that matches your business rules. Many teams cache for a day or a week and trigger immediate refreshes for high-priority domains or when a decision hinges on recent changes.
• What if a field like top_countries or traffic_sources is missing?
  Handle nulls gracefully and fall back to available fields (e.g., rely on global_rank). Queue a retry after a backoff interval and log for observability.
• Can I map IAB categories to my internal taxonomy?
  Yes. Maintain a translation table keyed by IAB path. Use the confidence scores to prefer the highest-confidence category when reconciling multiple mappings.
• Are failed calls billed?
  No. Failed or unreachable calls are not billed, so implement retries with backoff to ride out transient issues.

Ready to put rank and categorization into production? Create a key and start testing with a few lines of code. Register now and follow the Documentation to ship your integration today.