Partners

Partners & embed

Embed visibility in your product, automate with webhooks, or offer MencionAI under your brand.

Partners & embed

Integrate MencionAI visibility into your product — embedded dashboards, partner-branded experiences, and marketplace connections.

Who this is for

  • SaaS platforms that want to offer GEO/AI visibility to their customers
  • Agencies reselling visibility reports under their brand
  • Marketplace apps (e.g. CRM integrations) showing visibility inside another product

If you only need API access for your own team, start with the API getting started guide instead.

Embedded visibility

The fastest integration: show a live visibility summary inside your app via iframe.

How it works

  1. Your server creates an API key with the embed:create scope.
  2. Your server calls POST /api/v1/embed-tokens to get a short-lived token (met_…).
  3. Your frontend loads an iframe pointing at MencionAI embed URL with that token.
// Server-side (Node, etc.)
const res = await fetch('https://www.mencionai.com/api/v1/embed-tokens', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MENCIONAI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ workspace_id: 42, ttl_sec: 3600 }),
});

const { token } = await res.json();

<!-- Your page -->
<iframe
  src="https://www.mencionai.com/embed/v1/workspaces/42/summary?token=TOKEN_FROM_SERVER"
  width="100%"
  height="480"
  style="border: none; border-radius: 12px;"
  title="Brand visibility"
/>

Security rules

  • Never put your API key in the iframe URL or client-side JavaScript.
  • Embed tokens expire (default 1 hour). Refresh them from your backend when needed.
  • Only embed on origins allowed for your partner account.

Webhooks for automation

Keep your system in sync when scans complete (using the TypeScript SDK):

import { MencionAiClient } from '@mencionai/sdk';

const client = new MencionAiClient({ apiKey: process.env.MENCIONAI_API_KEY! });

await client.createWebhook({
  url: 'https://your-platform.com/hooks/mencionai',
  events: ['visibility.scan.completed'],
});

Use the signing secret from the create response to verify X-MencionAI-Signature on incoming requests. See API webhooks for details.

White-label experience

Partners can offer MencionAI under their own brand:

  • Custom logo in the app header
  • Brand colors applied to the interface
  • Custom domain (e.g. visibility.yourcompany.com)

White-label is enabled per partner agreement. Contact us to discuss:

  • Your customer volume and use case
  • Domain and branding requirements
  • Plan limits (API keys, webhooks, embed)

Marketplace integrations

MencionAI supports installing into third-party platforms so users can connect their workspace without leaving your product.

RD Station — OAuth install flow links a MencionAI organization to an RD Station account and enables embedded visibility inside RD.

Partner marketplace features require a separate enablement. Reach out via contact or your partner manager.

Recommended architecture

Your backend                    MencionAI API
     │                                │
     ├─ API key (server only) ───────►│ REST /api/v1
     ├─ Create embed token ──────────►│ POST /embed-tokens
     └─ Register webhooks ───────────►│ POST /webhooks

Your frontend
     └─ iframe with embed token ◄──── embed URL (no API key)

Limits by plan

| Feature | Free | Starter+ | |---------|------|----------| | API access | Yes | Yes | | Webhooks | — | Yes | | Embed tokens | — | Yes | | White-label domain | Partner agreement | Partner agreement |

Rate limits follow your organization plan. See API rate limits.

Get started

  1. Create an account and set up a workspace
  2. Create an API key with the scopes you need
  3. Try the TypeScript SDK or curl examples
  4. For partner / white-label: contact sales