MonialAPI Reference

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 URLhttps://www.monial.co
HeaderAuthorization: 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

POST/api/v1/person

Enrich 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

NameLocationDescription
queryrequiredbody · jsonUp to 100 person queries — each { name, domain } | { email } | { linkedin }.
cachebody · booleanReuse 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

POST/api/v1/company

Enrich 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

NameLocationDescription
queryrequiredbody · jsonUp to 100 company queries — each { domain } | { linkedin }.
cachebody · booleanReuse 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

POST/api/v1/tech-stack

Company 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

NameLocationDescription
queryrequiredbody · jsonUp to 100 domain queries — each { "domain": "acme.com" }.
cachebody · booleanReuse 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

POST/api/v1/employees

Company 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

NameLocationDescription
queryrequiredbody · jsonUp to 100 company queries — each { "domain": "acme.com" } plus optional category.
cachebody · booleanReuse 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

POST/api/v1/company/events

Company events

Public news and events for up to 100 companies per request — funding, product launches, leadership changes — scraped from the open web.

Parameters

NameLocationDescription
queryrequiredbody · jsonUp 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

POST/api/v1/posts

Social 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

NameLocationDescription
queryrequiredbody · jsonUp to 100 searches — each { "query": "…" } plus optional platforms, datePosted and limit.
cachebody · booleanReuse 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

POST/api/v1/jobs

Job 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

NameLocationDescription
queryrequiredbody · jsonUp to 100 searches — each { "domain": "acme.com" } | { "title": "…", "location": "…" } plus optional date and limit.
cachebody · booleanReuse 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

POST/api/v1/ads

Ad 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

NameLocationDescription
queryrequiredbody · jsonUp to 100 searches — each { "query": "…" } plus optional platforms, limit and region.
cachebody · booleanReuse 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

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

POST/api/v1/web-search-ai

AI 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

NameLocationDescription
queryrequiredbody · jsonUp to 100 questions — each { "query": "…" }.
cachebody · booleanReuse 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

POST/api/v1/website-content

Website 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

NameLocationDescription
queryrequiredbody · jsonUp to 100 page URLs — each { "url": "https://…" }.
cachebody · booleanReuse 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

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

POST/api/v1/places

Find places

Search places on maps data — up to 100 queries per request. Businesses, addresses, points of interest.

Parameters

NameLocationDescription
queryrequiredbody · jsonUp 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

GET/api/v1/queued/:id

Poll 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

NameLocationDescription
idrequiredpath · stringThe 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

GET/api/v1/monitors

List 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

NameLocationDescription
idquery · stringMonitor 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

POST/api/v1/monitors

Create 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

NameLocationDescription
namebody · stringDisplay name. Defaults to Untitled.
descriptionbody · stringOptional description.
endpointrequiredbody · stringRealtime Data API path to run, e.g. company/events?domain=acme.com or jobs?domain=stripe.com.
requestBodybody · jsonJSON request body for POST APIs such as person and company.
intervalrequiredbody · stringHow often to run: 1h, 1d or 1w.
webhookUrlrequiredbody · stringHTTP(S) URL that receives the result after every run.
isActivebody · booleanStart 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

PUT/api/v1/monitors?id=:id

Update 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

NameLocationDescription
idrequiredquery · stringMonitor id.
namebody · stringNew display name.
descriptionbody · stringNew description, or null to clear it.
endpointbody · stringNew data API path.
requestBodybody · jsonNew JSON request body, or null to clear it.
intervalbody · stringNew schedule: 1h, 1d or 1w.
webhookUrlbody · stringNew webhook URL.
isActivebody · booleanPause (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

DELETE/api/v1/monitors?id=:id

Delete a monitor

Delete a monitor and all of its stored results. The schedule stops immediately.

Parameters

NameLocationDescription
idrequiredquery · stringMonitor id.

Returns

{
  "ok": true
}
id is required

DELETE /api/v1/monitors?id=:id

id is required