API REFERENCE·V2

MarketXY API

Programmatic access to 480M+ domains, WHOIS records, DNS data, CMS detection, and reverse lookups. JSON-first, REST, fully filterable.

Base URL: api.marketxy.com/v2

23 endpoints

SLA: 99.95% uptime

HTTPS · API key auth

Getting Started · 1

Overview

The MarketXY API gives you programmatic access to our domain intelligence platform. Use it to query live data, run reverse lookups, build feeds, trigger exports, and perform bulk operations — all through a single RESTful interface.

Endpoint	Method	Purpose
/v2/live	GET	Single domain or filtered live data
/v2/reverse	GET	Find domains by email, IP, nameserver, company
/v2/search	GET	Discovery with full multi-filter support
/v2/count	GET	Count matching domains without fetching data
/v2/bulk/live	POST	Batch lookup for multiple domains
/v2/bulk/reverse	POST	Bulk reverse lookup
/v2/whois	GET	Raw or parsed WHOIS record for a domain
/v2/parsed	GET	Structured parsed WHOIS fields
/v2/timeline	GET	Historical WHOIS event timeline
/v2/dns	GET	Current DNS records — A, MX, NS, TXT
/v2/ssl	GET	SSL/TLS certificate details for a domain
/v2/ip	GET	Reverse IP intelligence — ASN, ISP, hosting
/v2/company	GET	Company profile linked to a domain
/v2/tech	GET	Technology stack detection — CMS, JS, CDN
/v2/category	GET	Business category classification for a domain
/v2/rank	GET	MXY/Tranco/Majestic/Umbrella/DomCop rank for a domain or subdomain
/v2/safety	GET	Blacklist/greylist status for a domain
/v2/asn	GET	ASN details, IP ranges, and hosting-provider stats
/v2/seo	GET	On-page SEO scan — title, meta, headings, load time
/v2/email	GET	Emails found associated with a domain
/v2/social	GET	Social media profiles linked to a domain
/v2/feed	GET	Daily updated and newly registered domains
/v2/export	GET	Trigger a CSV or JSON download job

API Key Auth

Pass your key as X-API-Key: YOUR_KEY header on every request.

Rate Limits

Starter: 100 req/min · Pro: 1,000 req/min · Enterprise: unlimited

Output Formats

JSON by default. Add format=csv to any endpoint for CSV output.

Getting Started · 2

Authentication

Include your API key in every request via the X-API-Key header. Never expose keys client-side. Keys are tied to your plan's rate limits.

curl

curl -H "X-API-Key: YOUR_API_KEY" \
     https://api.marketxy.com/v2/live?domain=amazon.com

Getting Started · 3

Quickstart

Get your first result in under 60 seconds. Grab your API key from the dashboard, then run the request below.

1. Single domain lookup

curl -H "X-API-Key: YOUR_KEY" \
     "https://api.marketxy.com/v2/live?domain=google.com"

2. Filter by country + CMS

curl -H "X-API-Key: YOUR_KEY" \
     "https://api.marketxy.com/v2/live?country=IN&cms=wordpress&limit=100"

3. Count before export

curl -H "X-API-Key: YOUR_KEY" \
     "https://api.marketxy.com/v2/count?category=ecommerce&country=US"

Getting Started · 4

Response Format

All responses are JSON by default. Every response wraps data in a consistent envelope with status, count, and data keys.

Standard success response

{
  "status": "ok",
  "count": 1,
  "total": 48291,
  "page": 1,
  "data": [
    {
      "domain": "example.com",
      "country": "US",
      "cms": "WordPress",
      "category": "ecommerce",
      "mxy_rank": 4218,
      "status": "active"
    }
  ]
}

Error response

{
  "status": "error",
  "code": 401,
  "message": "Invalid or missing API key"
}

Getting Started · 5

Common Parameters

These parameters work across all GET endpoints. Use ISO codes for country (IN, US) and language (en, hi). Multiple values: comma-separated like country=IN,US,GB.

Filter Parameters

domainSingle domain nameamazon.com
queryFree text searchcrypto
categoryCategory filterecommerce
countryISO country codeIN
langLanguage (ISO 639)en
cmsCMS filterwordpress
techTechnology filtershopify
companyCompany nameopenai
tldExtension filtercom
statusactive / inactiveactive

Lookup & Reverse

emailEmail filter[email protected]
phonePhone number919999999999
nsNameserverns1.cloudflare.com
mxMX recordaspmx.l.google.com
ipIP address8.8.8.8

Pagination & Output

pagePage number1
limitResults per page1000
sortSort fieldrank
orderasc or descdesc
formatjson or csvjson

Live Endpoints

/v2/live

Query current domain data. Use for a single domain lookup or filtered searches across the full live index.

GET

https://api.marketxy.com/v2/live

Fetch one domain or a filtered list from the live index

1 Credit

Parameter	Type	Required	Example	Description
domain	string	optional	amazon.com	Single domain to fetch (omit for filtered list)
country	string	optional	IN	ISO country code filter
cms	string	optional	wordpress	CMS filter
category	string	optional	ecommerce	Category filter
limit	integer	optional	1000	Results per page

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/live?domain=amazon.com"

URLhttps://api.marketxy.com/v2/live?domain=amazon.com

URLhttps://api.marketxy.com/v2/live?country=IN&limit=100

URLhttps://api.marketxy.com/v2/live?cms=wordpress&country=IN&limit=500

URLhttps://api.marketxy.com/v2/live?category=ecommerce&lang=en&limit=1000

JSON Response

{
  "status": "ok", "count": 1,
  "data": [{
    "domain": "amazon.com", "registered": "1994-11-01",
    "age_years": 31, "category": "ecommerce",
    "country": "US", "cms": null,
    "tech": ["React", "AWS"], "mxy_rank": 10, "status": "active"
  }]
}

Live Endpoints

/v2/reverse

Find all domains linked to an email, company, IP, nameserver, phone number, or social media handle. Useful for competitive research and OSINT.

GET

https://api.marketxy.com/v2/reverse

Reverse lookup — find domains by a shared attribute

3 Credits

Parameter	Type	Required	Example	Description
email	string	optional	[email protected]	Find domains registered with this email
company	string	optional	openai	Find domains owned by this company
ns	string	optional	ns1.cloudflare.com	Find domains using this nameserver
ip	string	optional	8.8.8.8	Find domains hosted on this IP
phone	string	optional	919999999999	Find domains registered with this phone number
social	string	optional	stripe	Find domains linking to this social media handle
limit	integer	optional	1000	Results per page

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/[email protected]"

URLhttps://api.marketxy.com/v2/reverse?email=[email protected]

URLhttps://api.marketxy.com/v2/reverse?company=openai

URLhttps://api.marketxy.com/v2/reverse?ns=ns1.cloudflare.com

URLhttps://api.marketxy.com/v2/reverse?ip=8.8.8.8&limit=1000

URLhttps://api.marketxy.com/v2/reverse?phone=919999999999

URLhttps://api.marketxy.com/v2/reverse?social=stripe

JSON Response

{
  "status": "ok", "count": 14,
  "data": [{ "domain": "example.com", "match_field": "email", "mxy_rank": 4218 }]
}

Discovery

/v2/search

General-purpose discovery. Combine filters to build custom domain lists by tech stack, industry, country, language, and more.

GET

https://api.marketxy.com/v2/search

Discovery with full multi-filter support

2 Credits

Parameter	Type	Required	Example	Description
query	string	optional	crypto	Free text keyword search across domain metadata
tech	string	optional	shopify	Filter by detected technology
category	string	optional	cybersecurity	Filter by industry category
country	string	optional	US	ISO country code filter
lang	string	optional	en	ISO 639 language filter
limit	integer	optional	100	Results per page (max 10000)

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/search?query=crypto&limit=100"

URLhttps://api.marketxy.com/v2/search?query=crypto&limit=100

URLhttps://api.marketxy.com/v2/search?tech=shopify&country=US&limit=1000

URLhttps://api.marketxy.com/v2/search?category=cybersecurity&lang=en&limit=500

JSON Response

{
  "status": "ok", "total": 48291, "page": 1, "count": 100,
  "data": [ /* array of domain objects */ ]
}

Discovery

/v2/count

Returns only the match count for a given filter set with no data transferred. Ideal for checking result size before an export.

GET

https://api.marketxy.com/v2/count

Count matching domains without fetching data

1 Credit

Parameter	Type	Required	Example	Description
category	string	optional	ecommerce	Category filter
country	string	optional	US	ISO country code filter
cms	string	optional	wordpress	CMS filter

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/count?category=ecommerce"

URLhttps://api.marketxy.com/v2/count?category=ecommerce

URLhttps://api.marketxy.com/v2/count?cms=wordpress&country=IN

JSON Response

{ "status": "ok", "query": { "category": "ecommerce" }, "count": 4829104 }

Feeds & Export

/v2/feed

Access daily updated and newly indexed domains. Filter by category, country, or date to stream fresh data into your pipeline.

GET

https://api.marketxy.com/v2/feed

Daily updated domain feed

1 Credit

Parameter	Type	Required	Example	Description
category	string	optional	ecommerce	Category filter
country	string	optional	IN	ISO country code filter
date	string	optional	2026-04-23	Feed date (YYYY-MM-DD)

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/feed?category=ecommerce&date=2026-04-23"

URLhttps://api.marketxy.com/v2/feed?category=ecommerce&date=2026-04-23

URLhttps://api.marketxy.com/v2/feed?country=IN&limit=1000

JSON Response

{
  "status": "ok", "date": "2026-04-23", "count": 1000,
  "data": [{ "domain": "newshop.com", "indexed_at": "2026-04-23T06:14:22Z", "category": "ecommerce" }]
}

Feeds & Export

/v2/export

Trigger a bulk download job. Large exports are queued and delivered via a signed download URL. Supports JSON and CSV output.

GET

https://api.marketxy.com/v2/export

Export filtered domain data as CSV or JSON

Variable · by row count

Parameter	Type	Required	Example	Description
category	string	optional	ecommerce	Category filter
cms	string	optional	shopify	CMS filter
country	string	optional	US	ISO country code filter
format	string	optional	csv	csv or json

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/export?category=ecommerce&format=csv"

URLhttps://api.marketxy.com/v2/export?category=ecommerce&format=csv

URLhttps://api.marketxy.com/v2/export?cms=shopify&country=US&format=json

JSON Response

{
  "status": "queued", "job_id": "exp_4f8a92cd",
  "estimated_rows": 482910, "format": "csv",
  "download_url": "https://export.marketxy.com/exp_4f8a92cd.csv",
  "expires_at": "2026-04-24T06:00:00Z"
}

Bulk

/v2/bulk/live

Look up many domains in a single POST request. Up to 10,000 domains per call. Combine with optional filters to enrich only the matching subset.

POST

https://api.marketxy.com/v2/bulk/live

Batch lookup — up to 10,000 domains per request

1 Credit / domain

Parameter	Type	Required	Example	Description
domains	array<string>	required	["amazon.com","openai.com"]	Up to 10,000 domains per request
country	string	optional	IN	Restrict results to this country
limit	integer	optional	1000	Max results returned

Request Body · application/json

{
  "domains": ["amazon.com", "openai.com", "shopify.com"],
  "country": "IN",
  "lang": "en",
  "limit": 1000
}

Example Request · cURL

curl -X POST https://api.marketxy.com/v2/bulk/live \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains":["amazon.com","openai.com"],"limit":1000}'

JSON Response

{ "status": "ok", "requested": 3, "found": 3, "data": [/* ... */] }

Bulk

/v2/bulk/reverse

Perform reverse lookups for multiple inputs (emails, IPs, nameservers) in a single request.

POST

https://api.marketxy.com/v2/bulk/reverse

Batch reverse lookup for multiple inputs

2 Credits / lookup

Parameter	Type	Required	Example	Description
emails	array<string>	optional	["[email protected]"]	Emails to reverse lookup
ips	array<string>	optional	["8.8.8.8"]	IPs to reverse lookup
limit	integer	optional	500	Max results per input

Request Body · application/json

{
  "emails": ["[email protected]", "[email protected]"],
  "ips": ["8.8.8.8", "1.1.1.1"],
  "limit": 500
}

Example Request · cURL

curl -X POST https://api.marketxy.com/v2/bulk/reverse \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails":["[email protected]"],"ips":["8.8.8.8"],"limit":500}'

JSON Response

{
  "status": "ok",
  "results": {
    "[email protected]": { "count": 8, "domains": [/* ... */] },
    "8.8.8.8": { "count": 3421, "domains": [/* ... */] }
  }
}

WHOIS & Historical

/v2/whois

Returns the WHOIS record for a domain — registrar, key dates, nameservers, and status codes. format=raw returns a plain-text summary synthesized from these fields, not the original registry response.

GET

https://api.marketxy.com/v2/whois

Current WHOIS record for a domain, raw or JSON

1 Credit

Parameter	Type	Required	Example	Description
domain	string	required	amazon.com	Domain to look up
format	string	optional	json	json (default) or raw

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/whois?domain=amazon.com"

URLhttps://api.marketxy.com/v2/whois?domain=amazon.com

URLhttps://api.marketxy.com/v2/whois?domain=amazon.com&format=raw

JSON Response

{
  "status": "ok",
  "domain": "amazon.com",
  "registrar": "MarkMonitor Inc.",
  "created": "1994-11-01",
  "expires": "2027-11-01",
  "updated": "2024-08-14",
  "nameservers": ["ns1.p31.dynect.net", "ns2.p31.dynect.net"],
  "status_codes": ["clientTransferProhibited"]
}

WHOIS & Historical

Parsed API

Returns structured, parsed WHOIS data — registrar, registrant, dates, nameservers — in clean JSON fields rather than raw text.

GET

https://api.marketxy.com/v2/parsed

Structured parsed WHOIS fields for any domain

2 Credits

Parameter	Type	Required	Example	Description
domain	string	required	amazon.com	Domain to look up
fields	string	optional	registrar,nameservers	Comma-separated fields to include

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/parsed?domain=amazon.com"

URLhttps://api.marketxy.com/v2/parsed?domain=amazon.com

JSON Response

{
  "status": "ok",
  "domain": "amazon.com",
  "registrar": "MarkMonitor Inc.",
  "registrant": { "name": "Amazon Technologies, Inc.", "country": "US" },
  "created": "1994-11-01",
  "expires": "2027-11-01",
  "updated": "2024-08-14",
  "nameservers": ["ns1.p31.dynect.net", "ns2.p31.dynect.net"],
  "status": ["clientTransferProhibited"]
}

WHOIS & Historical

Timeline API

Retrieve the nameserver and registrar change history for a domain — each snapshot diffed against the previous one to surface transfers and nameserver changes over time.

GET

https://api.marketxy.com/v2/timeline

Historical WHOIS events for a domain

3 Credits

Parameter	Type	Required	Example	Description
domain	string	required	shopify.com	Domain to fetch history for
limit	integer	optional	50	Max number of events

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/timeline?domain=shopify.com&limit=50"

URLhttps://api.marketxy.com/v2/timeline?domain=shopify.com&limit=50

JSON Response

{
  "status": "ok",
  "domain": "shopify.com",
  "count": 12,
  "timeline": [
    { "date": "2006-09-15", "event": "registered", "registrar": "GoDaddy" },
    { "date": "2011-04-02", "event": "registrar_transfer", "registrar": "MarkMonitor" },
    { "date": "2024-09-15", "event": "renewed", "expires": "2026-09-15" }
  ]
}

DNS & SSL

/v2/dns

Fetch current DNS records for a domain — A, AAAA, MX, NS, TXT, CNAME, and SOA.

GET

https://api.marketxy.com/v2/dns

Current DNS records for a domain

1 Credit

Parameter	Type	Required	Example	Description
domain	string	required	shopify.com	Domain to query
type	string	optional	ALL	A, AAAA, MX, NS, TXT, CNAME, SOA, or ALL

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/dns?domain=shopify.com"

URLhttps://api.marketxy.com/v2/dns?domain=shopify.com

URLhttps://api.marketxy.com/v2/dns?domain=shopify.com&type=MX

JSON Response

{
  "status": "ok", "domain": "shopify.com", "count": 4,
  "records": [
    { "type": "A", "value": "23.227.38.65", "ttl": 300 },
    { "type": "MX", "value": "aspmx.l.google.com", "priority": 1, "ttl": 3600 },
    { "type": "NS", "value": "ns1.p19.dynect.net", "ttl": 86400 },
    { "type": "TXT", "value": "v=spf1 include:_spf.google.com ~all", "ttl": 3600 }
  ]
}

DNS & SSL

/v2/ssl

Get the current SSL/TLS certificate details for a domain — issuer, validity window, cipher suite, and subject alternative names.

GET

https://api.marketxy.com/v2/ssl

SSL/TLS certificate details for a domain

1 Credit

Parameter	Type	Required	Example	Description
domain	string	required	stripe.com	Domain to query

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/ssl?domain=stripe.com"

URLhttps://api.marketxy.com/v2/ssl?domain=stripe.com

JSON Response

{
  "status": "ok", "domain": "stripe.com",
  "issuer": "DigiCert Inc", "subject": "stripe.com",
  "valid_from": "2026-01-15", "valid_to": "2027-01-15",
  "cipher": "TLS_AES_256_GCM_SHA384",
  "san": ["stripe.com", "www.stripe.com", "api.stripe.com"]
}

IP & Network

/v2/ip

Reverse IP intelligence — ASN, ISP, country, and the number of domains hosted on an IP address or CIDR block.

GET

https://api.marketxy.com/v2/ip

ASN, ISP, and hosting intelligence for an IP or CIDR block

2 Credits

Parameter	Type	Required	Example	Description
ip	string	required	8.8.8.8	IP address to look up
cidr	string	optional	8.8.8.0/24	CIDR block instead of a single IP

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/ip?ip=8.8.8.8"

URLhttps://api.marketxy.com/v2/ip?ip=8.8.8.8

URLhttps://api.marketxy.com/v2/ip?cidr=8.8.8.0/24

JSON Response

{
  "status": "ok", "ip": "8.8.8.8",
  "asn": "AS15169", "isp": "Google LLC",
  "country": "US", "domain_count": 42
}

Company & Technology

/v2/company

Look up the company profile linked to a domain — legal name, HQ country, and social profiles.

GET

https://api.marketxy.com/v2/company

Company profile linked to a domain or name

3 Credits

Parameter	Type	Required	Example	Description
domain	string	optional	stripe.com	Domain to resolve company data for
company	string	optional	openai	Company name (alternative to domain)

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/company?domain=stripe.com"

URLhttps://api.marketxy.com/v2/company?domain=stripe.com

URLhttps://api.marketxy.com/v2/company?company=openai

JSON Response

{
  "status": "ok", "domain": "stripe.com",
  "company_name": "Stripe, Inc.", "hq_country": "US",
  "socials": { "linkedin": "linkedin.com/company/stripe", "twitter": "@stripe" }
}

Company & Technology

/v2/tech

Detect the technology stack running on a domain — CMS, JS frameworks, analytics tools, and CDN.

GET

https://api.marketxy.com/v2/tech

Technology stack detection for a domain

1 Credit

Parameter	Type	Required	Example	Description
domain	string	required	shopify.com	Domain to analyze

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/tech?domain=shopify.com"

URLhttps://api.marketxy.com/v2/tech?domain=shopify.com

JSON Response

{
  "status": "ok", "domain": "shopify.com",
  "cms": "Shopify",
  "frameworks": ["React", "Node.js"],
  "analytics": ["Google Analytics", "Segment"],
  "cdn": "Cloudflare"
}

Classification & Trust

/v2/category

Business category classification for a domain, scored against our category keyword index using the domain name, meta title, and meta description.

GET

https://api.marketxy.com/v2/category

Category classification for a domain

1 Credit

Parameter	Type	Required	Example	Description
domain	string	required	shopify.com	Domain to classify

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/category?domain=shopify.com"

URLhttps://api.marketxy.com/v2/category?domain=shopify.com

JSON Response

{
  "status": "ok", "domain": "shopify.com",
  "categories": [
    { "category": "Business to Business Service", "score": 40, "percentage": 40 },
    { "category": "Services for industry", "score": 40, "percentage": 40 }
  ]
}

Classification & Trust

/v2/rank

MXY Rank plus third-party rank signals (Tranco, Majestic, Umbrella, DomCop) for a domain, or rank data for a subdomain from a separate subdomain index.

GET

https://api.marketxy.com/v2/rank

Rank and score data for a domain or subdomain

1 Credit

Parameter	Type	Required	Example	Description
domain	string	optional	amazon.com	Domain to fetch rank for
subdomain	string	optional	mail.amazon.com	Subdomain to fetch rank for (alternative to domain)

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/rank?domain=amazon.com"

URLhttps://api.marketxy.com/v2/rank?domain=amazon.com

URLhttps://api.marketxy.com/v2/rank?subdomain=mail.amazon.com

JSON Response · domain

{
  "status": "ok",
  "domain": "amazon.com",
  "mxy_rank": 14, "tranco": 27, "majestic": 27,
  "umbrella": 88, "domcop": 26
}

JSON Response · subdomain

{
  "status": "ok",
  "subdomain": "mail.amazon.com",
  "umbrella": 402, "domcop": null
}

Classification & Trust

/v2/safety

Blacklist/greylist status for a domain, checked against our listing index and a separately maintained blacklist feed.

GET

https://api.marketxy.com/v2/safety

Trust and safety status for a domain

1 Credit

Parameter	Type	Required	Example	Description
domain	string	required	example.com	Domain to check

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/safety?domain=example.com"

URLhttps://api.marketxy.com/v2/safety?domain=example.com

JSON Response

{
  "status": "ok",
  "domain": "example.com",
  "listed_status": "white",
  "blacklisted": false,
  "first_found": null
}

Network Intelligence

/v2/asn

Autonomous system (ASN) details and IP ranges, country-level network stats, or hosting-provider market share — depending on which parameter is passed.

GET

https://api.marketxy.com/v2/asn

ASN, country, or hosting-provider network stats

2 Credits

Parameter	Type	Required	Example	Description
asn	string	optional	AS15169	ASN number — returns ASN details + IP ranges
country	string	optional	US	ISO country code — returns country-level ASN/IP stats
(none)	—	optional	—	Omit both to get hosting-provider market share

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/asn?asn=AS15169"

URLhttps://api.marketxy.com/v2/asn?asn=AS15169

URLhttps://api.marketxy.com/v2/asn?country=US

URLhttps://api.marketxy.com/v2/asn

JSON Response · by ASN

{
  "status": "ok", "count": 53,
  "data": { "asn_number": "AS15169", "asname": "GOOGLE", "description": "Google LLC", "country": "US", "category": "hosting" }
}

JSON Response · market share

{
  "status": "ok", "total_providers": 1773, "count": 5,
  "data": [{ "provider": "Amazon.com, Inc.", "total_ip": 172875264, "market_share": 58.9 }]
}

Network Intelligence

/v2/seo

On-page SEO scan for a domain — title, meta description, headings, favicon presence, and page load time.

GET

https://api.marketxy.com/v2/seo

On-page SEO scan results for a domain

1 Credit

Parameter	Type	Required	Example	Description
domain	string	required	shopify.com	Domain to scan

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/seo?domain=shopify.com"

URLhttps://api.marketxy.com/v2/seo?domain=shopify.com

JSON Response

{
  "status": "ok",
  "domain": "shopify.com",
  "seo_score": null,
  "page_load_time": 6.67,
  "has_title": true, "has_meta_description": true,
  "has_favicon": false,
  "has_h1": true, "has_h2": true, "has_h3": true
}

Email & Social

/v2/email

Company email addresses found associated with a domain, paginated across our email discovery dataset.

GET

https://api.marketxy.com/v2/email

Emails found associated with a domain

2 Credits

Parameter	Type	Required	Example	Description
domain	string	required	amazon.com	Domain to look up
page	integer	optional	1	Page number
limit	integer	optional	100	Results per page (max 5000)

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/email?domain=amazon.com"

URLhttps://api.marketxy.com/v2/email?domain=amazon.com

JSON Response

{
  "status": "ok", "total": 38749, "page": 1, "limit": 100, "count": 100,
  "data": { "domain": "amazon.com", "emails": ["[email protected]", "[email protected]"] }
}

Email & Social

/v2/social

Social media profiles linked to a domain across 16 supported platforms.

GET

https://api.marketxy.com/v2/social

Social media profiles linked to a domain

1 Credit

Parameter	Type	Required	Example	Description
domain	string	required	shopify.com	Domain to look up

Example Request · cURL

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.marketxy.com/v2/social?domain=shopify.com"

URLhttps://api.marketxy.com/v2/social?domain=shopify.com

JSON Response

{
  "status": "ok", "count": 7,
  "data": {
    "domain": "shopify.com",
    "socials": {
      "facebook": "shopify", "instagram": "shopify", "twitter": "shopify",
      "linkedin": "company/shopify", "tiktok": "@shopify"
    }
  }
}

Reference

Rate Limits

All plans include API access. Limits are per-minute, per-hour, and per-day per key. The X-RateLimit-Remaining response header shows credits left in the current window.

Plan	Req / min	Req / day	Concurrent	Monthly credits
Free Trial	10	500	2	1,000
Starter	60	20,000	5	50,000
Pro	300	150,000	20	500,000
Business	1,000	1,000,000	50	5,000,000
Enterprise	Custom	Custom	Custom	Custom

Authentication Headers	Authorization: Bearer YOUR_API_KEY
Request Headers	Content-Type: application/json
Response Headers	X-RateLimit-Remaining: 4500
Pagination	?page=1&limit=100
Filtering Rules	?country=IN&lang=en&cms=wordpress
Sorting Rules	?sort=created_date&order=desc
Date Filters	?created_after=2026-01-01
Output Formats	?format=json?format=csv
Bulk Job Status	GET /v2/bulk/status?job_id=abc123
Export Job Status	GET /v2/export/status?job_id=exp456
Retry Policy	Retry after 5 seconds if 429 error
Timeout Rules	Request timeout after 30 sec
Data Freshness	Updated every 4–6 hours
API Versioning	/v1//v2/
Compression Support	Accept-Encoding: gzip
Async Processing	Returns job_id for long requests
Pagination Limits	limit=10 to 10000
Best Practices	Use limit + filters for faster results

Reference

Error Codes

All errors return a JSON body with status, code, and message. Use the HTTP status code to determine retry logic.

Code	Meaning	Action
200	OK	Request succeeded
400	Bad Request	Check query parameters — a required param may be missing or malformed
401	Unauthorized	Invalid or missing X-API-Key header
403	Forbidden	Your plan does not have access to this endpoint
404	Not Found	Domain or resource does not exist in our index
422	Unprocessable	Parameters are valid types but fail validation rules
429	Rate Limited	Retry after 5 seconds — check X-RateLimit-Remaining
500	Server Error	Internal error — retry with exponential backoff
503	Unavailable	Service temporarily down — check status.marketxy.com

Error response format

{
  "status": "error",
  "code": 429,
  "message": "Rate limit exceeded. Retry after 5 seconds.",
  "retry_after": 5
}

Reference

SDKs & Libraries

Official and community SDKs for the MarketXY API. All SDKs wrap authentication, pagination, and error handling automatically.

JavaScript / Node.js

npm install marketxy

npmjs.com/package/marketxy →

Python

pip install marketxy

pypi.org/project/marketxy →

Go

go get github.com/marketxy/go-sdk

pkg.go.dev/marketxy →

PHP

composer require marketxy/sdk

packagist.org/marketxy →

Node.js example

// npm install marketxy
const mxy = require('marketxy')({ apiKey: 'YOUR_KEY' });

const result = await mxy.live({ domain: 'amazon.com' });
console.log(result.data);

Python example

# pip install marketxy
import marketxy

client = marketxy.Client(api_key="YOUR_KEY")
result = client.live(domain="amazon.com")
print(result["data"])

✓ Copied