API v2 Data Access
See what each package unlocks, how upgrade gates work, and which flat fields are returned by API v2.
Fields by package
This is the access model. Each API v2 field has one minimum package. Omit include to receive all fields available on the authenticated package, or request individual fields by name.
include=domain,country,vat_number| Field | Available from | Type | Label |
|---|---|---|---|
| domain | Free | string | Domain |
| status | Free | string | Current domain status |
| profile_as_of | Free | string | Business profile observed at |
| status_since | Free | string | Current status observed since |
| status_checked_at | Free | string | Current status last checked at |
| url | Free | string | URL |
| country | Free | string | Country |
| country_iso | Free | string | Country ISO code |
| state | Free | string | State / Region |
| state_iso | Free | string | State / Region ISO code |
| city | Free | string | City |
| text_lang | Free | string | Language |
| is_ecommerce | Free | boolean | E-commerce |
| ecommerce_probability | Free | number | AI e-commerce probability |
| primary_platform | Free | string | Primary platform |
| platforms | Free | array | Platforms |
| category | Free | string | Category |
| categories | Free | array | Categories |
| subcategory | Free | string | Subcategory |
| subcategories | Free | array | Subcategories |
| subcategory_id | Free | string | Subcategory ID |
| subcategory_ids | Free | array | Subcategory IDs |
| meta_title | Standard | string | Meta title |
| meta_description | Standard | string | Meta description |
| tech | Standard | array | Detected technology stack |
| tech_version | Standard | array | Detected technology versions |
| premium_tech | Standard | array | Detected premium technologies |
| ecommerce_plugins | Standard | array | Detected ecommerce platform plugins and apps |
| tech_maturity_level | Standard | string | Tech maturity level |
| estimated_monthly_tech_spend | Standard | number | Estimated monthly tech spend |
| payment_providers | Standard | array | Detected payment providers |
| shipping_carriers | Standard | array | Detected shipping carriers |
| emails | Standard | array | Emails |
| phones | Standard | array | Phones |
| website_year | Standard | number | Website year |
| website_month | Standard | string | Website launch month |
| commoncrawl_web_presence_bucket | Standard | string | Web Presence |
| commoncrawl_web_presence_trend_12m | Standard | string | Web Presence Trend |
| crux_global_rank_bucket | Standard | string | CrUX global rank bucket |
| public_web_visibility_tier | Standard | string | Public web visibility |
| public_web_visibility_confidence | Standard | string | Public visibility confidence |
| public_web_visibility_basis | Standard | string | Public visibility evidence |
| company_name | Premium | string | Company name |
| vat_number | Premium | string | VAT number |
| vat_country | Premium | string | VAT country |
| social | Standard | object | Social links |
| store_age_tier | Premium | string | Store age tier |
| first_seen_year | Premium | number | First seen year |
| cross_border_countries | Premium | array | Cross-border countries |
| cross_border_domains | Premium | array | Cross-border domains |
| cross_border_evidence_types | Premium | array | Cross-border evidence types |
| merchant_size_score | Enterprise | number | Merchant size score |
| merchant_size_band | Enterprise | string | Merchant size band |
| gmv_band_usd | Enterprise | string | Estimated annual online sales / GMV band in USD |
| merchant_size_country_score | Enterprise | number | Merchant size country score |
| merchant_size_country_band | Enterprise | string | Merchant size country band |
| merchant_size_confidence | Enterprise | string | Merchant size confidence |
| merchant_size_source | Enterprise | string | Merchant size source |
| cross_border_cluster_size_range | Enterprise | string | Cross-border cluster size range |
include with comma-separated field names for smaller responses, for example include=domain,country,vat_number.
Add include_meta=true only when you need request diagnostics, returned field names, credits, or freshness metadata in the JSON body.
Example response shape
{
"object": "domain",
"found": true,
"domain": "aboutyou.com",
"status": "active",
"profile_as_of": "2026-05-08T10:30:00.000Z",
"status_since": "2026-05-08T10:30:00.000Z",
"status_checked_at": "2026-08-04T16:50:10.000Z",
"url": "https://aboutyou.com",
"country": "Germany",
"country_iso": "DE",
"state": "Hamburg",
"state_iso": "DE-HH",
"city": null,
"text_lang": "English",
"is_ecommerce": true,
"ecommerce_probability": 0.99,
"primary_platform": "Custom",
"platforms": ["Custom"],
"category": "Clothing & Accessories",
"categories": ["Clothing & Accessories"],
"subcategory": "General clothing",
"subcategories": ["General clothing", "Streetwear"],
"subcategory_id": "general_clothing",
"subcategory_ids": ["general_clothing", "streetwear"],
"meta_title": "Online fashion from over 500 top brands | ABOUT YOU",
"meta_description": "Order your fashion today at ABOUT YOU. Free and fast delivery.",
"tech": ["React", "PWA", "Cloudflare", "PayPal", "HTTP/3"],
"tech_version": ["HTTP/3"],
"premium_tech": [],
"ecommerce_plugins": [],
"tech_maturity_level": "Scaling",
"estimated_monthly_tech_spend": 1482,
"payment_providers": ["JCB", "MasterCard", "American Express", "PayPal", "Svea"],
"shipping_carriers": ["Asendia"],
"emails": [],
"phones": ["+494083509377"],
"website_year": 1996,
"website_month": "1996-08",
"commoncrawl_web_presence_bucket": "Very High",
"commoncrawl_web_presence_trend_12m": "stable",
"crux_global_rank_bucket": "top_10k",
"public_web_visibility_tier": "very_high",
"public_web_visibility_confidence": "high",
"public_web_visibility_basis": "crux_and_commoncrawl",
"company_name": null,
"vat_number": "339819462",
"vat_country": "DE",
"social": {
"facebook": "https://www.facebook.com/aboutyouglobal/",
"instagram": "https://www.instagram.com/aboutyou/",
"linkedin": null,
"pinterest": null,
"tiktok": null,
"twitter": null,
"youtube": null
},
"store_age_tier": "10y_plus",
"first_seen_year": 1996,
"cross_border_countries": ["Austria", "Poland", "Sweden", "France"],
"cross_border_domains": ["aboutyou.at", "aboutyou.pl", "aboutyou.se", "fr.aboutyou.ch"],
"cross_border_evidence_types": ["website_presence", "product_listings"],
"merchant_size_score": 100,
"merchant_size_band": "top_1_percent",
"gmv_band_usd": "usd_100m_500m",
"merchant_size_country_score": 100,
"merchant_size_country_band": "top_1_percent",
"merchant_size_confidence": "high",
"merchant_size_source": "reported",
"cross_border_cluster_size_range": "25 - 100 related domains"
}
Public web visibility uses the Chrome UX Report by Google (CC BY 4.0) and Common Crawl WebGraph data subject to the Common Crawl Terms of Use. Its values are coarse evidence buckets, not exact rank or visit estimates.
Metadata is optional. Request include_meta=true to add _meta.request_id, _meta.fields, _meta.credits_remaining, and data freshness values to the response body. The same request ID and credit usage are also returned in HTTP headers.
{
"_meta": {
"request_id": "01f3b41a-0ff6-4e0e-94d3-06a8e19d9892",
"api_version": "v2",
"plan": "premium",
"fields": ["domain", "country", "tech"],
"credits_cost": 1,
"credits_remaining": 8743,
"stack_observed_at": "2026-05-08T10:30:00.000Z",
"stack_source": "techscan"
}
}
Raw field catalog JSON is available at /api/v2/fields.