OppAlerts Documentation

How to use OppAlerts in the web app, from an AI agent through the MCP server, and from your own code through the API.

  • - searchable news articles, from over 25 million sources
  • - searchable link prospects, filtered from over 10 billion web pages

Start here

All pages

Getting Started

  • Free 14-Day Trial: the full OppAlerts application for 14 days before you pay, on all plan levels.
  • Set Up Your First Campaign: create one campaign for your brand, so that OppAlerts can research your market and start the daily monitoring.
  • Campaigns: what a campaign is and how to set one up.
  • Daily Monitoring and Alerts: get the new mentions, links, and opportunities of your market each morning, without searching for them.
  • Use OppAlerts in Your AI Agent: ask your AI agent for link prospects, mentions, and reports in plain language, and let it call OppAlerts for you.
  • Your First API Call: make three calls to the OppAlerts API and read the full answer of each one.
  • Authentication: login, API tokens, and OAuth.
  • Create an API Token: get a token that lets your code or your AI agent call the OppAlerts API and MCP server.
  • Team Members: give your team and your clients access to your account, and choose which campaigns each person can see or change.
  • Agencies and Clients: run the research of every client from one account, and give each client access to their own campaign only.
  • Billing and Plans: choose the plan that fits your campaigns and your team, and change it when your work changes.
  • Usage and Daily Limits: know how many calls your account has left today, and see who used them.
  • How the API Handles Requests: know when a call is refused, what it costs, and when to send it again.
  • Free Account: a small, limited version of OppAlerts for small and local businesses that have no budget for the full application.
  • Account Settings: find the page in your account that does what you need.
  • Key Terms: the words that the OppAlerts documentation and web app use, each in one or two sentences.
  • Support: get an answer to your question, or report a problem.

The Data

  • How to Search the Indexes: type a query that the News Index and the Prospect Index can search, and correct a query that is refused.
  • News Index: the search engine of OppAlerts for current news pages, podcasts, and videos.
  • Prospect Index: the search engine of OppAlerts for pages that show a way to take part in your market.
  • Search Results: what you get back for each page that a News Index or Prospect Index search finds.
  • How Semantic Search Works: find the pages about your subject even when they use other words than you do.
  • Opportunity Types and Content Types: find the pages that are a certain type of opportunity or a certain shape of content, whatever words they use.
  • How Mentions and Links Are Matched: know exactly why a page shows in a brand report, so that you can trust it and set your campaign up well.
  • Advanced Search Operators: use operators to make a word search more exact or more wide.
  • Duplicates and Copies: see where one story was copied, and find the original reporting behind it.
  • Daily Counts: read the numbers on the Dashboard and in the daily opportunities email correctly, and know what each one includes.
  • AI Model Answers: see your market the way AI models see it: the sites they recommend, the words they say people search, and the way the market writes.
  • Backlink Database: the links between websites: who links to a site, who links to your competitors, and who does not link to you yet.
  • PageRank Database: the monthly PageRank of each site since July 2017, so that you can see how established a site is and where it goes.
  • Site Info Database: the contact details that a website publishes about itself, so that you can find the right way to reach it.
  • Taxonomies: check what a piece of writing is about against standard category lists that advertisers, publishers, and search engines use.
  • Data Freshness: know how new each data set is, so that you read each result with the right date in mind.
  • Coverage: know what the OppAlerts data covers, so that you know when to look somewhere else.

How-To Guides

Opportunity Types

Content Types

MCP and API

The 50 tools, in alphabetical order. Each tool has an MCP page and an API page.

App

The web app, one page for each page of the app. The groups follow the app menu.

Account

The account pages of the profile menu, and what MCP and the API can and cannot do for your account.

  • Profile: see which email you are signed in with and which plan you have, and set the name that the web app shows.
  • Subscription: see your plan and the next billing date, and upgrade, downgrade, or cancel.
  • Email Notifications: choose which OppAlerts account emails you get.
  • Downloads: download again the files that you asked for by email.
  • API & MCP Tokens: make and revoke the tokens of the MCP server and the API, and see the apps that you connected.
  • Team: give a person access to your account, choose what each person can see and change, and remove a person.
  • Usage: see the calls of your account for each token and each day, and why a call was refused.
  • Password: change the password that you sign in with.

Use Cases

FAQ

Tags