App Guide
Using Monial
Monial is a Realtime Data API Platform. It gives your backend and your agents live access to people and company data, web search, ads, jobs and places — through the Console, the REST API, and MCP. This guide walks through every part of the app, feature by feature.
How the app works
Everything in Monial happens in the Console — the workspace you land in after signing in. It brings together the Overview dashboard and settings in one place. The data itself lives behind the REST API and MCP server.
A typical loop looks like this:
- 1
Get an API key
Create your organization, then go to Settings → API key. The same key authenticates REST calls and MCP.
- 2
Call a data endpoint
POST /api/v1/person, POST /api/v1/web-search — every endpoint takes { query: [...] } and returns a cache hit immediately, or a queuedId you poll until complete.
- 3
Automate with Monitors
Create a Monitor to run any data endpoint on a schedule (hourly, daily, weekly) and deliver the result to your webhook URL.
- 4
Watch the Overview
The Overview dashboard tracks credits and every API call your organization makes.
What's in the API
The platform is one REST surface with three groups of endpoints:
Enrichment
Resolve people and companies to structured JSON by name, domain, email or LinkedIn — plus company events, social posts, job postings and ad libraries.
Web & Content
Public web search, AI answers grounded in live page content, and any website's title, content and markdown — JavaScript pages are auto-scraped via a real browser.
Discovery
People search with waterfall prioritization and places lookup on maps data — plus the queued endpoint you poll for async results.
What's in the Console
Each page of the Console has its own detailed guide. New to Monial? Read them in order — or jump straight to the feature you're here for.
Quick start
From sign-up to your first API result takes about five minutes:
- 1
Create your organization
Sign in and name your workspace. You can invite teammates later — everything you create lives inside the organization.
- 2
Copy your API key
Go to Settings → API key and copy it. Keep it server-side — it authorizes full data access for your organization.
- 3
Call an endpoint
Try POST /api/v1/company/events with { query: [{ domain: "acme.com" }] } from curl or your backend. Cached results come back immediately; fresh ones return a queuedId.
- 4
Poll for the result
GET /api/v1/queued/:id until status is complete — result then holds the JSON payload.