# MDataAccess

> Data access built for autonomous AI agents.

MDataAccess provides machine-native, pay-per-request access to web content,
company enrichment, person enrichment, search, and business intelligence.

Base URL: https://api.mdataaccess.com

API documentation: https://api.mdataaccess.com/docs
OpenAPI schema: https://api.mdataaccess.com/openapi.json
Service discovery: https://api.mdataaccess.com/services
Pricing: https://api.mdataaccess.com/pricing

## Payments

Protocol: x402
Environment: mainnet
Network: Base
Network ID: eip155:8453
Currency: USDC

No MDataAccess API key or subscription is required for paid endpoints.

A paid request returns HTTP 402 Payment Required when no valid x402 payment
authorization is supplied.

IMPORTANT: This deployment uses Base mainnet and real USDC payments.

## Which endpoint should I use?

Choose the narrowest endpoint that matches the task:

- Need readable text from a known webpage URL -> GET /read
- Know a company name or domain and want company enrichment -> GET /company
- Need to find a company using custom search criteria -> GET /companies/search
- Know a person's email, LinkedIn URL, or name and want person enrichment -> GET /person
- Need to find a person using custom search criteria -> GET /people/search
- Know a company + business function and want one senior decision-maker -> GET /decision-makers
- Know a company + target function and want one compact sales-ready lead -> GET /lead

Prefer /company and /person for known entities. Prefer /companies/search and /people/search when the entity is not known and search criteria are required. Prefer /decision-makers and /lead when you want MDataAccess to construct the people-search logic for you.

## Services

### Read Web Content

GET /read

Price: $0.002

Parameters:
- url: webpage URL

Example:
GET https://api.mdataaccess.com/read?url=https://example.com

### Company Enrichment

GET /company

Price: $0.15

Provide at least one:
- name
- website

Example:
GET https://api.mdataaccess.com/company?website=openai.com

### Person Enrichment

GET /person

Price: $0.35

Provide at least one:
- email
- linkedin_url
- name

Optional:
- company

### Company Search

GET /companies/search

Price: $0.15

Parameters:
- sql: PDL Company Search SQL query

Exactly one company is returned per paid call.

Example:
GET https://api.mdataaccess.com/companies/search?sql=SELECT%20*%20FROM%20company%20WHERE%20name%20=%20%27google%27

### Decision Maker

GET /decision-makers

Price: $0.45

Parameters:
- company: company name
- function: business function or department, such as engineering, sales, marketing, finance, or HR

MDataAccess converts these simple inputs into a senior-person search and returns one matching decision-maker.

Example:
GET https://api.mdataaccess.com/decision-makers?company=google&function=engineering

### Lead

GET /lead

Price: $0.49

Parameters:
- company: company name
- function: target business function or department

Returns one senior sales-ready lead using MDataAccess targeting logic over licensed person data.

Example:
GET https://api.mdataaccess.com/lead?company=google&function=engineering

### Person Search

GET /people/search

Price: $0.35

Parameters:
- sql: PDL Person Search SQL query

Exactly one profile is returned per paid call.

Example:
GET https://api.mdataaccess.com/people/search?sql=SELECT%20*%20FROM%20person%20WHERE%20job_title%20=%20%27software%20engineer%27

## Machine Discovery

OpenAPI:
https://api.mdataaccess.com/openapi.json

Service catalog:
https://api.mdataaccess.com/services

Pricing:
https://api.mdataaccess.com/pricing

## Contact

MDataAccess
info@mdataaccess.com
https://mdataaccess.com