Documentation / Getting Started / Key Terms
Key Terms
Understand the terms used in OppAlerts, with a short explanation of each one.
Campaigns
- Campaign
- One brand and its market: its sites, its brand names, its competitors, a description of the market, and the saved opportunities. See Campaigns.
- Organization
- A company in a campaign, with its hosts and its brand names.
- Relationship
- How an organization relates to a campaign: Owned Brand, Competitor, Partner, or Publisher. Reports use this relationship to label each site. A relationship belongs to one campaign: a company can be a competitor in one campaign and a publisher in another.
- Finalize
- The step that starts research for a new campaign. After finalizing, the industry and the description cannot change.
- Saved opportunity
- A search that OppAlerts monitors daily for a campaign: a brand search or an opportunity type. See Daily Monitoring and Alerts.
- Daily opportunities email
- One email a day with new pages for each saved opportunity.
The data
- News Index
- The OppAlerts search engine for news pages, podcasts, and videos. See News Index.
- Prospect Index
- The OppAlerts search engine for pages with opportunities to participate in a market. See Prospect Index.
- Document
- One page, podcast episode, or video in an index.
- Published date
- The publication date given by the source. Many prospect pages do not have one.
- Indexed date
- The date a document was added to an index.
- Index search
- A call to any
news_orprospects_tool, in the web app, MCP, or the API. All index searches of an account share one daily count.
Types
- Opportunity type
- A way to participate in a market, for example Guest Posts, Podcast Guesting, or Business Directories. There are 79, in 15 groups.
- Content type
- The format of a page, for example Blogs, Case Studies, or Glossaries. There are 18.
- Type score
- A score from 0 to 100 showing how closely a page matches an opportunity type or content type. Each document has a score for each type. Min type score excludes pages below your chosen score. See Opportunity Types and Content Types.
Mentions and links
- Mention
- A page that names a brand in its title or its body.
- Link
- A page that contains an outbound link to one of a brand's hosts.
- Unlinked mention
- A page that names a brand and does not link to any of its hosts.
- Link gap
- A page or a site that links to a competitor and not to you.
- Page sections
- OppAlerts reads links in three parts of each page:
article,nav, andcomments(comments and other text that users write). - Link types
follow,nofollow,sponsored, andugc, from therelvalue of the link.
Rank and semantic similarity
- Host and domain
blog.example.comis a host.example.comis its registrable domain. Many tools let you choose the level.- PageRank (PR)
- A score of 0 to 100 for a host or a domain, from the sites that link to it. It is measured each month. It is not a Google score.
- PageRank over Time (PRoT)
- The sum of the monthly PageRank values since July 2017. A high PRoT comes from a high PageRank, a long history, or both. See PageRank Database.
- Semantic search
- A search by semantic similarity: the index returns pages similar to the search text, even when they use different words. See How Semantic Search Works.
- Similarity
- How similar a page is to the meaning of your search text, from 0 to 100 percent. Min similarity excludes pages below your chosen percentage.
- Opportunity vector
- The text that a semantic search matches against: No vector, Similarity text, the Campaign text, or a saved opportunity.
- Title query and Body query
- Word searches within page titles and page text, respectively. Both boxes accept the search operators.
- Relevance
- How well a page matches the words of a search. It has no upper limit, so compare it only with other results in the same response.
Permissions
- Team member
- A person invited to your account: an account editor, an account viewer, or an editor or viewer of chosen campaigns.
- Read permissions and edit permissions
- A viewer can read campaigns but cannot change them. An editor can
change campaigns. A token needs the scope
api:writefor a change. See Team. - API token
- A secret that starts with
pat_live_. Your code sends it to the API or the MCP server. - MCP
- Model Context Protocol: the way an AI agent calls tools.
OppAlerts runs an MCP server at
https://mcp.oppalerts.com/mcp.