MonialApp Guide

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. 1

    Get an API key

    Create your organization, then go to Settings → API key. The same key authenticates REST calls and MCP.

  2. 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. 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. 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. 1

    Create your organization

    Sign in and name your workspace. You can invite teammates later — everything you create lives inside the organization.

  2. 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. 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. 4

    Poll for the result

    GET /api/v1/queued/:id until status is complete — result then holds the JSON payload.