Skip to content

Developers

MentionOwl API

Read-only REST API for your MentionOwl account. Authenticate with a bearer API key from Profile → API Key.

Authentication

Every request needs a bearer API key, which you generate in Profile → API Key. Send it in the Authorization header:

curl https://www.mentionowl.com/api/me \
  -H "Authorization: Bearer MentionOwl_{userId}_{token}"

The API is read-only. The full machine-readable schema is at /api/openapi.json.

Endpoints

GET/api/me

Current user and sites

  • 200 — User id, email, plan, and owned/shared sites.
  • 401 — Missing or malformed Authorization header.
  • 403 — Invalid key or plan without API access.
GET/api/user/{id}

A user (self or admin)

  • 200 — User summary.
  • 403 — Not your user.
GET/api/site/{domain}

Site metadata

  • 200 — Domain, summary, owner, and members.
  • 404 — Site not found or inaccessible.
GET/api/site/{domain}/metrics

Visibility metrics

  • 200 — Current and previous visibility score, coverage, and citation counts.
GET/api/site/{domain}/queries

Runs, questions, answers, and citations

  • 200 — Recent platform runs with full detail.
GET/api/admin/users

All users (admin)

  • 200 — User list.
GET/api/admin/cron

Cron health (admin)

  • 200 — Job config and run history.