Sandbox
Requests use your live organization data. Sent as Authorization: Bearer.
Sign in or paste a key.
Authentication
API Reference
The Monial API is organized around REST. Authenticate with an organization API key from Settings. Send it as a bearer token. The base URL is your Monial host.
| Base URL | https://www.monial.co |
| Header | Authorization: Bearer <api_key> |
Create or rotate a key in Console → Settings. MCP uses the same API key.
cURL
curl https://www.monial.co/api/v1/company/events \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"domain": "acme.com"
}
]
}'The panel on every endpoint sends a live request with this key.
Core resources
Enrichment
/api/v1/personEnrich people
Resolve up to 100 people per request to structured JSON. Identify each by name + company domain, by email, or by LinkedIn profile. When every query resolves from cache the results return inline with 200; otherwise the batch is queued (202) and you poll the queued endpoint.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 person queries — each { name, domain } | { email } | { linkedin }. |
| cache | body · boolean | Reuse stored enrichments when they exist (default true). Set false to force a fresh scrape. |
Returns
{
"cached": false,
"queuedId": "qj_8f3c2b91"
}curl https://www.monial.co/api/v1/person \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"name": "Jordan Rivera",
"domain": "northstar.health"
}
],
"cache": false
}'POST /api/v1/person
/api/v1/companyEnrich companies
Resolve up to 100 companies per request to structured JSON by domain or LinkedIn page. When every query resolves from cache the results return inline with 200; otherwise the batch is queued (202).
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 company queries — each { domain } | { linkedin }. |
| cache | body · boolean | Reuse stored enrichments when they exist (default true). Set false to force a fresh scrape. |
Returns
{
"cached": false,
"queuedId": "qj_8f3c2b91"
}curl https://www.monial.co/api/v1/company \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"domain": "acme.com"
}
],
"cache": false
}'POST /api/v1/company
/api/v1/tech-stackCompany tech stack
Detect the technologies behind up to 100 company websites per request — frameworks, analytics, hosting, CRM and more — via Wappalyzer-style script analysis in the scraping browser. When every query resolves from a recent stored scan the results return inline with 200; otherwise the batch is queued (202).
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 domain queries — each { "domain": "acme.com" }. |
| cache | body · boolean | Reuse stored scans when they exist (default true). Set false to force a fresh scan. |
Returns
{
"cached": true,
"result": [
{
"domain": "acme.com",
"url": "https://acme.com",
"status": "ok",
"scannedAt": "2026-02-14T09:30:00.000Z",
"techStack": [
{
"name": "React",
"slug": "react",
"description": "A JavaScript library for building user interfaces.",
"categories": [
{
"id": 12,
"slug": "javascript-frameworks",
"name": "JavaScript frameworks",
"groups": [
{
"id": 12,
"name": "JavaScript frameworks"
}
]
}
],
"confidence": 100,
"version": "19.0.0",
"website": "https://react.dev",
"icon": "React.svg",
"cpe": "cpe:2.3:a:meta:react:19.0.0:*:*:*:*:*:*:*"
},
{
"name": "Cloudflare",
"slug": "cloudflare",
"description": "Cloudflare is a web-infrastructure company.",
"categories": [
{
"id": 62,
"slug": "cdn",
"name": "CDN",
"groups": [
{
"id": 20,
"name": "Web servers and reverse proxies"
}
]
}
],
"confidence": 100,
"version": null,
"website": "https://www.cloudflare.com",
"icon": "Cloudflare.svg",
"cpe": "cpe:2.3:a:cloudflare:cloudflare:*:*:*:*:*:*:*:*"
}
]
}
]
}curl https://www.monial.co/api/v1/tech-stack \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"domain": "acme.com"
}
],
"cache": false
}'POST /api/v1/tech-stack
/api/v1/employeesCompany employees
Find the people working at up to 100 companies per request, by job title, via public LinkedIn-profile search across a catalog of job-title categories — executives, engineering, sales-and-marketing and more. When every query resolves from a stored scan the results return inline with 200; otherwise the batch is queued (202). Scans run one SERP query per title, so a full scan can take several minutes.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 company queries — each { "domain": "acme.com" } plus optional category. |
| cache | body · boolean | Reuse stored scans when they exist (default true). Set false to force a fresh scan. |
Returns
{
"cached": true,
"result": [
{
"domain": "acme.com",
"employees": [
{
"personLinkedIn": "https://www.linkedin.com/in/jordanrivera",
"title": "CTO",
"seniority": "c-level",
"companyLinkedIn": "https://www.linkedin.com/company/acme"
}
],
"scannedAt": "2026-02-14T09:30:00.000Z"
}
]
}curl https://www.monial.co/api/v1/employees \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"domain": "acme.com",
"category": "engineering"
}
],
"cache": false
}'POST /api/v1/employees
/api/v1/company/eventsCompany events
Public news and events for up to 100 companies per request — funding, product launches, leadership changes — scraped from the open web.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 domain queries — each { "domain": "acme.com" } plus optional limit and page. |
Returns
{
"result": [
{
"results": [
{
"title": "Acme raises $40M Series B",
"url": "https://techcrunch.com/…",
"date": "2026-01-12",
"snippet": "Acme announced a Series B to scale its agent platform…"
}
]
}
]
}curl https://www.monial.co/api/v1/company/events \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"domain": "acme.com",
"limit": 10,
"page": 1
}
]
}'POST /api/v1/company/events
/api/v1/postsSocial media posts
Search social posts across Reddit, X (Twitter) and YouTube — up to 100 queries per request. Pass platforms per query to narrow the search; omit it to search all three.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 searches — each { "query": "…" } plus optional platforms, datePosted and limit. |
| cache | body · boolean | Reuse stored results when they exist (default true). Set false to force a fresh scrape. |
Returns
{
"result": [
{
"results": [
{
"platform": "reddit",
"title": "We switched our SDR stack to agents",
"url": "https://reddit.com/r/sales/…",
"date": "2026-01-20"
}
]
}
]
}curl https://www.monial.co/api/v1/posts \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"query": "Monial",
"platforms": "reddit,twitter"
}
],
"cache": false
}'POST /api/v1/posts
/api/v1/jobsJob postings
Job postings for up to 100 queries per request — by company domain, or by title + location across the open web. Results are cached per query.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 searches — each { "domain": "acme.com" } | { "title": "…", "location": "…" } plus optional date and limit. |
| cache | body · boolean | Reuse stored postings when they exist (default true). Set false to force a fresh search. |
Returns
{
"result": [
{
"results": [
{
"title": "Senior SDR",
"company": "Acme",
"location": "Remote",
"url": "https://acme.com/careers/…"
}
]
}
]
}curl https://www.monial.co/api/v1/jobs \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"domain": "acme.com"
},
{
"title": "Backend Engineer",
"location": "Chennai"
}
],
"cache": false
}'POST /api/v1/jobs
/api/v1/adsAd library
Live and archived ads from platform ad libraries for up to 100 queries per request. Pass platforms per query to pick specific libraries; leave it empty to scrape all of them.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 searches — each { "query": "…" } plus optional platforms, limit and region. |
| cache | body · boolean | Reuse stored ads when they exist (default true). Set false to force a fresh scrape. |
Returns
{
"result": [
{
"results": [
{
"platform": "meta",
"title": "Acme — hiring agents",
"url": "https://facebook.com/ads/…"
}
]
}
]
}curl https://www.monial.co/api/v1/ads \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"query": "acme",
"platforms": "meta"
}
],
"cache": false
}'POST /api/v1/ads
Core resources
Web & Content
/api/v1/web-searchWeb search
Public web search — up to 100 queries per request. The same results a search engine returns, with page content included for every hit.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 searches — each { "query": "…" } plus optional limit, page and date. |
Returns
{
"result": [
{
"results": [
{
"title": "Best AI agents of 2026",
"url": "https://example.com/…",
"description": "We tested…"
}
]
}
]
}curl https://www.monial.co/api/v1/web-search \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"query": "Best AI Agent",
"limit": 10
}
]
}'POST /api/v1/web-search
/api/v1/web-search-aiAI web answer
Runs the web search for up to 100 questions per request, reads the page content of every result, and uses AI to synthesize a grounded answer with cited sources.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 questions — each { "query": "…" }. |
| cache | body · boolean | Reuse stored answers when they exist (default true). Set false to force fresh answers. |
Returns
{
"result": [
{
"query": "Best AI Agent",
"answer": "Based on the top results…",
"sources": [
{
"title": "…",
"url": "https://…"
}
]
}
]
}curl https://www.monial.co/api/v1/web-search-ai \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"query": "Best AI Agent"
}
],
"cache": false
}'POST /api/v1/web-search-ai
/api/v1/website-contentWebsite content
Return the title, content and markdown of up to 100 URLs per request. Pages that need JavaScript are auto-scraped through a real browser.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 page URLs — each { "url": "https://…" }. |
| cache | body · boolean | Reuse stored page content when it exists (default true). Set false to force fresh fetches. |
Returns
{
"result": [
{
"url": "https://example.com",
"title": "Example Domain",
"markdown": "# Example Domain\n\nThis domain is for use in…"
}
]
}curl https://www.monial.co/api/v1/website-content \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"url": "https://example.com"
}
],
"cache": false
}'POST /api/v1/website-content
Core resources
Discovery
/api/v1/searchSearch people
Search people by location, industry and keywords — up to 100 queries per request. Pass a waterfall — an ordered list of { title, size } steps — and the API walks each step until it has enough candidates.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 searches — each { location, industry, keywords, waterfall: [{"title":"CMO","size":"100-200"}], limit }. |
Returns
{
"result": [
{
"people": [
{
"name": "Jordan Rivera",
"title": "CMO",
"company": "Northstar Health",
"domain": "northstar.health",
"step": 0
}
]
}
]
}curl https://www.monial.co/api/v1/search \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"location": "Chennai",
"industry": "software",
"waterfall": [
{
"title": "CMO",
"size": "100-200"
}
]
}
]
}'POST /api/v1/search
/api/v1/placesFind places
Search places on maps data — up to 100 queries per request. Businesses, addresses, points of interest.
Parameters
| Name | Location | Description |
|---|---|---|
| queryrequired | body · json | Up to 100 searches — each { "query": "…" } plus optional limit. |
Returns
{
"result": [
{
"results": [
{
"name": "Third Wave Coffee",
"address": "MG Road, Chennai",
"rating": 4.5
}
]
}
]
}curl https://www.monial.co/api/v1/places \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": [
{
"query": "coffee shops in Chennai",
"limit": 10
}
]
}'POST /api/v1/places
/api/v1/queued/:idPoll a queued request
Read the status of a queued request. status is queued, running or complete — and result holds the JSON payload once complete. A failed job reports status failed with an error message.
Parameters
| Name | Location | Description |
|---|---|---|
| idrequired | path · string | The queuedId returned when the request was enqueued. |
Returns
{
"status": "complete",
"result": {
"name": "Jordan Rivera",
"title": "VP RevOps",
"company": "Northstar Health",
"domain": "northstar.health",
"email": "jordan@northstar.health",
"linkedin": "https://www.linkedin.com/in/jordanrivera",
"location": "Austin, TX"
}
}id is required
GET /api/v1/queued/:id
id is required
Core resources
Monitors
/api/v1/monitorsList monitors
Return every monitor for the organization. A monitor runs one data API endpoint on a schedule (every hour, day or week) and POSTs the result to your webhook URL after every run. Pass ?id= to fetch one monitor with its 20 most recent results.
Parameters
| Name | Location | Description |
|---|---|---|
| id | query · string | Monitor id — returns that monitor plus recent results. |
Returns
{
"monitors": [
{
"id": "mon_8f3c2b91",
"name": "Acme company news",
"description": "Track news about Acme",
"endpoint": "company/events?domain=acme.com",
"interval": "1d",
"webhookUrl": "https://example.com/hooks/monial",
"isActive": true,
"lastRunAt": "2026-11-02T09:00:00.000Z"
}
]
}curl https://www.monial.co/api/v1/monitors \ -X GET \ -H "Authorization: Bearer $MONIAL_API_KEY"
GET /api/v1/monitors
/api/v1/monitorsCreate a monitor
Schedule a recurring API call. Give it an optional name and description, pick any data API as the endpoint, how often it should run — interval 1h, 1d or 1w — and the webhook URL that receives the result as a POST body after every run. The payload posted is { monitorId, status, result, error }.
Parameters
| Name | Location | Description |
|---|---|---|
| name | body · string | Display name. Defaults to Untitled. |
| description | body · string | Optional description. |
| endpointrequired | body · string | Realtime Data API path to run, e.g. company/events?domain=acme.com or jobs?domain=stripe.com. |
| requestBody | body · json | JSON request body for POST APIs such as person and company. |
| intervalrequired | body · string | How often to run: 1h, 1d or 1w. |
| webhookUrlrequired | body · string | HTTP(S) URL that receives the result after every run. |
| isActive | body · boolean | Start paused with false. Defaults to true. |
Returns
{
"id": "mon_8f3c2b91",
"name": "Acme company news",
"description": "Track news about Acme",
"endpoint": "company/events?domain=acme.com",
"interval": "1d",
"webhookUrl": "https://example.com/hooks/monial",
"isActive": true,
"lastRunAt": null
}curl https://www.monial.co/api/v1/monitors \
-X POST \
-H "Authorization: Bearer $MONIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme company news",
"description": "Track news about Acme",
"endpoint": "company/events?domain=acme.com",
"interval": "1d",
"webhookUrl": "https://example.com/hooks/monial"
}'POST /api/v1/monitors
/api/v1/monitors?id=:idUpdate a monitor
Change a monitor's name, description, endpoint, interval, webhook URL or active flag — only the fields you pass change. Set isActive false to pause the schedule without deleting it.
Parameters
| Name | Location | Description |
|---|---|---|
| idrequired | query · string | Monitor id. |
| name | body · string | New display name. |
| description | body · string | New description, or null to clear it. |
| endpoint | body · string | New data API path. |
| requestBody | body · json | New JSON request body, or null to clear it. |
| interval | body · string | New schedule: 1h, 1d or 1w. |
| webhookUrl | body · string | New webhook URL. |
| isActive | body · boolean | Pause (false) or resume (true) the schedule. |
Returns
{
"id": "mon_8f3c2b91",
"endpoint": "company/events?domain=acme.com",
"interval": "1w",
"webhookUrl": "https://example.com/hooks/monial",
"isActive": true
}id is required
PUT /api/v1/monitors?id=:id
id is required
/api/v1/monitors?id=:idDelete a monitor
Delete a monitor and all of its stored results. The schedule stops immediately.
Parameters
| Name | Location | Description |
|---|---|---|
| idrequired | query · string | Monitor id. |
Returns
{
"ok": true
}id is required
DELETE /api/v1/monitors?id=:id
id is required