{"api_version":"v2","auth":{"preferred":"Authorization: Bearer <api_key>","legacy_query_param":"api_key"},"current_plan":null,"field_catalog":[{"field":"domain","available_from":"free","package":"Free","type":"string","label":"Domain"},{"field":"status","available_from":"free","package":"Free","type":"string","label":"Current domain status"},{"field":"profile_as_of","available_from":"free","package":"Free","type":"string","label":"Business profile observed at"},{"field":"status_since","available_from":"free","package":"Free","type":"string","label":"Current status observed since"},{"field":"status_checked_at","available_from":"free","package":"Free","type":"string","label":"Current status last checked at"},{"field":"url","available_from":"free","package":"Free","type":"string","label":"URL"},{"field":"country","available_from":"free","package":"Free","type":"string","label":"Country"},{"field":"country_iso","available_from":"free","package":"Free","type":"string","label":"Country ISO code"},{"field":"state","available_from":"free","package":"Free","type":"string","label":"State / Region"},{"field":"state_iso","available_from":"free","package":"Free","type":"string","label":"State / Region ISO code"},{"field":"city","available_from":"free","package":"Free","type":"string","label":"City"},{"field":"text_lang","available_from":"free","package":"Free","type":"string","label":"Language"},{"field":"is_ecommerce","available_from":"free","package":"Free","type":"boolean","label":"E-commerce"},{"field":"ecommerce_probability","available_from":"free","package":"Free","type":"number","label":"AI e-commerce probability"},{"field":"primary_platform","available_from":"free","package":"Free","type":"string","label":"Primary platform"},{"field":"platforms","available_from":"free","package":"Free","type":"array","label":"Platforms"},{"field":"category","available_from":"free","package":"Free","type":"string","label":"Category"},{"field":"categories","available_from":"free","package":"Free","type":"array","label":"Categories"},{"field":"subcategory","available_from":"free","package":"Free","type":"string","label":"Subcategory"},{"field":"subcategories","available_from":"free","package":"Free","type":"array","label":"Subcategories"},{"field":"subcategory_id","available_from":"free","package":"Free","type":"string","label":"Subcategory ID"},{"field":"subcategory_ids","available_from":"free","package":"Free","type":"array","label":"Subcategory IDs"},{"field":"meta_title","available_from":"standard","package":"Standard","type":"string","label":"Meta title"},{"field":"meta_description","available_from":"standard","package":"Standard","type":"string","label":"Meta description"},{"field":"tech","available_from":"standard","package":"Standard","type":"array","label":"Detected technology stack"},{"field":"tech_version","available_from":"standard","package":"Standard","type":"array","label":"Detected technology versions"},{"field":"premium_tech","available_from":"standard","package":"Standard","type":"array","label":"Detected premium technologies"},{"field":"ecommerce_plugins","available_from":"standard","package":"Standard","type":"array","label":"Detected ecommerce platform plugins and apps"},{"field":"tech_maturity_level","available_from":"standard","package":"Standard","type":"string","label":"Tech maturity level"},{"field":"estimated_monthly_tech_spend","available_from":"standard","package":"Standard","type":"number","label":"Estimated monthly tech spend"},{"field":"payment_providers","available_from":"standard","package":"Standard","type":"array","label":"Detected payment providers"},{"field":"shipping_carriers","available_from":"standard","package":"Standard","type":"array","label":"Detected shipping carriers"},{"field":"emails","available_from":"standard","package":"Standard","type":"array","label":"Emails"},{"field":"phones","available_from":"standard","package":"Standard","type":"array","label":"Phones"},{"field":"website_year","available_from":"standard","package":"Standard","type":"number","label":"Website year"},{"field":"website_month","available_from":"standard","package":"Standard","type":"string","label":"Website launch month"},{"field":"commoncrawl_web_presence_bucket","available_from":"standard","package":"Standard","type":"string","label":"Web Presence"},{"field":"commoncrawl_web_presence_trend_12m","available_from":"standard","package":"Standard","type":"string","label":"Web Presence Trend"},{"field":"crux_global_rank_bucket","available_from":"standard","package":"Standard","type":"string","label":"CrUX global rank bucket"},{"field":"public_web_visibility_tier","available_from":"standard","package":"Standard","type":"string","label":"Public web visibility"},{"field":"public_web_visibility_confidence","available_from":"standard","package":"Standard","type":"string","label":"Public visibility confidence"},{"field":"public_web_visibility_basis","available_from":"standard","package":"Standard","type":"string","label":"Public visibility evidence"},{"field":"company_name","available_from":"premium","package":"Premium","type":"string","label":"Company name"},{"field":"vat_number","available_from":"premium","package":"Premium","type":"string","label":"VAT number"},{"field":"vat_country","available_from":"premium","package":"Premium","type":"string","label":"VAT country"},{"field":"social","available_from":"standard","package":"Standard","type":"object","label":"Social links"},{"field":"store_age_tier","available_from":"premium","package":"Premium","type":"string","label":"Store age tier"},{"field":"first_seen_year","available_from":"premium","package":"Premium","type":"number","label":"First seen year"},{"field":"cross_border_countries","available_from":"premium","package":"Premium","type":"array","label":"Cross-border countries"},{"field":"cross_border_domains","available_from":"premium","package":"Premium","type":"array","label":"Cross-border domains"},{"field":"cross_border_evidence_types","available_from":"premium","package":"Premium","type":"array","label":"Cross-border evidence types"},{"field":"merchant_size_score","available_from":"enterprise","package":"Enterprise","type":"number","label":"Merchant size score"},{"field":"merchant_size_band","available_from":"enterprise","package":"Enterprise","type":"string","label":"Merchant size band"},{"field":"gmv_band_usd","available_from":"enterprise","package":"Enterprise","type":"string","label":"Estimated annual online sales / GMV band in USD"},{"field":"merchant_size_country_score","available_from":"enterprise","package":"Enterprise","type":"number","label":"Merchant size country score"},{"field":"merchant_size_country_band","available_from":"enterprise","package":"Enterprise","type":"string","label":"Merchant size country band"},{"field":"merchant_size_confidence","available_from":"enterprise","package":"Enterprise","type":"string","label":"Merchant size confidence"},{"field":"merchant_size_source","available_from":"enterprise","package":"Enterprise","type":"string","label":"Merchant size source"},{"field":"cross_border_cluster_size_range","available_from":"enterprise","package":"Enterprise","type":"string","label":"Cross-border cluster size range"}],"include_presets":[{"value":"","label":"All fields available on my plan","description":"Recommended for testing. The request omits include and returns every field your package can access."},{"value":"domain,country,country_iso,state,state_iso,city,is_ecommerce,primary_platform,meta_title,meta_description,tech,ecommerce_plugins,tech_maturity_level,estimated_monthly_tech_spend,payment_providers,shipping_carriers,emails,phones,social,website_year,website_month,crux_global_rank_bucket,commoncrawl_web_presence_bucket,commoncrawl_web_presence_trend_12m,public_web_visibility_tier,public_web_visibility_confidence,public_web_visibility_basis","label":"Standard fields","description":"Identity, geography, e-commerce classification, platform, page metadata, technologies, ecommerce plugins, tech signals, payments, shipping, contacts, social links, website age, and public web visibility."},{"value":"company_name,vat_number,store_age_tier,first_seen_year,cross_border_countries,cross_border_domains,cross_border_evidence_types","label":"Premium fields","description":"Company name, VAT, store age, first seen year, and cross-border signals."},{"value":"merchant_size_score,merchant_size_band,gmv_band_usd,merchant_size_country_score,merchant_size_country_band,merchant_size_confidence,merchant_size_source,cross_border_cluster_size_range","label":"Enterprise fields","description":"Merchant size scoring, estimated annual online-sales band, confidence, source class, and cross-border cluster size."}],"plans":{"free":{"label":"Free","credits":50,"team_size":1,"fields":["domain","status","profile_as_of","status_since","status_checked_at","url","country","country_iso","state","state_iso","city","text_lang","is_ecommerce","ecommerce_probability","primary_platform","platforms","category","categories","subcategory","subcategories","subcategory_id","subcategory_ids"]},"basic":{"label":"Basic","credits":800,"team_size":1,"fields":["domain","status","profile_as_of","status_since","status_checked_at","url","country","country_iso","state","state_iso","city","text_lang","is_ecommerce","ecommerce_probability","primary_platform","platforms","category","categories","subcategory","subcategories","subcategory_id","subcategory_ids"]},"standard":{"label":"Standard","credits":1250,"team_size":3,"fields":["domain","status","profile_as_of","status_since","status_checked_at","url","country","country_iso","state","state_iso","city","text_lang","is_ecommerce","ecommerce_probability","primary_platform","platforms","category","categories","subcategory","subcategories","subcategory_id","subcategory_ids","meta_title","meta_description","tech","tech_version","premium_tech","ecommerce_plugins","tech_maturity_level","estimated_monthly_tech_spend","payment_providers","shipping_carriers","emails","phones","website_year","website_month","commoncrawl_web_presence_bucket","commoncrawl_web_presence_trend_12m","crux_global_rank_bucket","public_web_visibility_tier","public_web_visibility_confidence","public_web_visibility_basis","social"]},"premium":{"label":"Premium","credits":10000,"team_size":5,"fields":["domain","status","profile_as_of","status_since","status_checked_at","url","country","country_iso","state","state_iso","city","text_lang","is_ecommerce","ecommerce_probability","primary_platform","platforms","category","categories","subcategory","subcategories","subcategory_id","subcategory_ids","meta_title","meta_description","tech","tech_version","premium_tech","ecommerce_plugins","tech_maturity_level","estimated_monthly_tech_spend","payment_providers","shipping_carriers","emails","phones","website_year","website_month","commoncrawl_web_presence_bucket","commoncrawl_web_presence_trend_12m","crux_global_rank_bucket","public_web_visibility_tier","public_web_visibility_confidence","public_web_visibility_basis","company_name","vat_number","vat_country","social","store_age_tier","first_seen_year","cross_border_countries","cross_border_domains","cross_border_evidence_types"]},"enterprise":{"label":"Enterprise","credits":10000,"team_size":10,"fields":["domain","status","profile_as_of","status_since","status_checked_at","url","country","country_iso","state","state_iso","city","text_lang","is_ecommerce","ecommerce_probability","primary_platform","platforms","category","categories","subcategory","subcategories","subcategory_id","subcategory_ids","meta_title","meta_description","tech","tech_version","premium_tech","ecommerce_plugins","tech_maturity_level","estimated_monthly_tech_spend","payment_providers","shipping_carriers","emails","phones","website_year","website_month","commoncrawl_web_presence_bucket","commoncrawl_web_presence_trend_12m","crux_global_rank_bucket","public_web_visibility_tier","public_web_visibility_confidence","public_web_visibility_basis","company_name","vat_number","vat_country","social","store_age_tier","first_seen_year","cross_border_countries","cross_border_domains","cross_border_evidence_types","merchant_size_score","merchant_size_band","gmv_band_usd","merchant_size_country_score","merchant_size_country_band","merchant_size_confidence","merchant_size_source","cross_border_cluster_size_range"]}},"errors_url":"https://shoprank.com/api/v2/errors","notes":["Start without include. API v2 returns every field available on the authenticated package.","Use include with comma-separated field names to reduce payload size.","Exact revenue and GMV amounts are never returned by API v2. Enterprise may expose a broad modelled annual online-sales / GMV band in USD; it is not audited total company revenue.","VAT numbers are available on Premium and above when detected.","Enterprise fields are intentionally negotiation-led because coverage, volume, and data needs vary by customer."]}