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

8 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/feed	GET	Daily updated and newly registered domains
/v2/export	GET	Trigger a CSV or JSON download job
/v2/bulk/live	POST	Batch lookup for multiple domains
/v2/bulk/reverse	POST	Bulk reverse lookup

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

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, or nameserver. Useful for competitive research and OSINT.

GET

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

Reverse lookup — find domains by a shared attribute

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

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

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

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 }

Discovery

/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

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" }]
}

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

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

Request Body · application/json

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

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

Request Body · application/json

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

JSON Response

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

API Endpoints

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

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"]
}

API Endpoints

Timeline API

Retrieve the full historical WHOIS record timeline for a domain — ownership changes, registrar transfers, and expiry events over time.

GET

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

Historical WHOIS events for a domain

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" }
  ]
}

Reference

Rate Limits

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

Credits System	1 lookup = 1 creditlive lookup = 5 creditsreverse lookup = 3 credits
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