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
- New to OppAlerts: read Getting Started.
- Connect an AI Agent, for example Claude Code or Codex: the MCP server is
https://mcp.oppalerts.com/mcp. Read Connect an AI Agent, or paste the "Set up my agent" prompt of Use OppAlerts in Your AI Agent into your agent. - Manage your plan, your tokens, and your team: read Account.
- Call OppAlerts from your own code: the API is at
https://api.oppalerts.com/v1/. Read Authentication and Limits. - Get an API token: read Create an API Token.
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
- How to Check Draft Topic Relevance
- How to Compare Content to Target Audiences
- How to Coordinate Content, PR, and SEO
- How to Find AI Citation Opportunities
- How to Find Award Submissions
- How to Find Competitor Backlink Gaps
- How to Find Content Ideas
- How to Find Event Speaking Opportunities
- How to Find Expert Roundup Opportunities
- How to Find Industry Directory Opportunities
- How to Find Local Sponsorships
- How to Find Newsletter Sponsorships
- How to Find Op-Ed Opportunities
- How to Find Outreach Contact Details
- How to Find Podcast Guest Opportunities
- How to Find Relevant Guest Post Opportunities
- How to Find Research Partnerships
- How to Find Resource Page Opportunities
- How to Find Unlinked Brand Mentions
- How to Improve AI Search Visibility
- How to Monitor Brand Mentions
- How to Monitor Competitor Mentions
- How to Monitor New Brand Links
- How to Optimize Local Service Content
- How to Prioritize Link Prospects
- How to Refresh Existing Content
- How to Research a New Client Market
- How to Research AI Recommended Competitors
- How to Research Customer Questions
- How to Research Digital PR Targets
- How to Research Industry News
- How to Review Client Campaign Progress
- How to Review Prospect Site History
Opportunity Types
- How to Find Advertising Opportunities and Media Kits
- How to Find Websites That Sell Display Ads
- How to Find Native and In-Content Advertising
- How to Find Newsletter Ads and Sponsorships
- How to Find Podcast Advertising Opportunities
- How to Find Sponsored Content Opportunities
- How to Find Video Sponsorship and Video Ad Opportunities
- How to Find Web Shows and Livestreams
- How to Find Podcasts That Take Guests
- How to Find Podcasts in Your Market
- How to Find Radio Show Opportunities
- How to Find Television Program Opportunities
- How to Find Video Collaboration Opportunities
- How to Find Webinar Series and Webinar Hosts
- How to Find YouTube Channels in Your Market
- How to Find Award Submission Opportunities
- How to Find Awards Lists and Awards Calendars
- How to Find Buyer Guides
- How to Find Comparison and Alternatives Pages
- How to Find Sites That Review Products
- How to Find AMA and Q&A Opportunities
- How to Find Blog Commenting Opportunities
- How to Find Community Submission Opportunities
- How to Find Forums and Message Boards
- How to Find Listicles and Best-Of Lists
- How to Find Collaboration Opportunities
- How to Find Guest Post Opportunities
- How to Find Infographic Opportunities
- How to Find Quiz Opportunities
- How to Find Slide Deck Opportunities
- How to Find Testimonial Opportunities
- How to Find User-Generated Content Campaigns
- How to Find Association Member Directories
- How to Find Business Directories to Join
- How to Find Link Directories
- How to Find Software and Tool Directories
- How to Find Vendor and Supplier Directories
- How to Find Award Ceremonies and Galas
- How to Find Calls for Papers
- How to Find Conferences and Trade Shows
- How to Find Event Calendars and Event Listings
- How to Find Event Sponsorship Opportunities
- How to Find Expos, Trade Shows, and Vendor Booth Opportunities
- How to Find Meetups, User Groups, and Networking Events
- How to Find Roundtable Discussions and Executive Forums
- How to Find Speaker Proposals and Calls for Speakers
- How to Find Expert Directories and Expert Networks
- How to Find Expert Roundups and Expert Panels
- How to Find Interview Opportunities
- How to Find Blogrolls and Recommended Blog Lists
- How to Find Link Exchange Opportunities
- How to Find Link Roundups
- How to Find Resource Pages
- How to Find Wiki Contribution Opportunities
- How to Find Blogs in Your Market
- How to Find News Sites and Publishers
- How to Find Newsletters in Your Market
- How to Find Newspapers and Business Press
- How to Find Newsrooms and Press Centers
- How to Find Op-Ed Opportunities
- How to Find Press Release Distribution Sites
- How to Find Trade Magazines and Industry Publications
- How to Find Advocacy Groups
- How to Find Local Chapters and Chambers of Commerce
- How to Find Nonprofits in Your Market
- How to Find Trade Associations and Professional Societies
- How to Find Affiliate and Referral Partners
- How to Find Brand Ambassadors and Influencers
- How to Find Co-Marketing and Strategic Partners
- How to Find Media Partnerships
- How to Find Product Collaboration Opportunities
- How to Find Research Partnership Opportunities
- How to Find Corporate Giving Programs
- How to Find Donation Opportunities
- How to Find Fundraisers and Charity Events
- How to Find Grants and Foundations
- How to Find Contests and Giveaways
- How to Find Local Sponsorship Opportunities
- How to Find Sponsorship Packages
Content Types
- How to Find Academic Journals and Research Publications
- How to Find Industry Reports and Benchmarks
- How to Find Industry Statistics and Survey Data
- How to Find Industry Trends and Forecasts
- How to Find White Papers and Ebooks
- How to Find Case Studies and Customer Success Stories
- How to Find Courses and Training Programs in Your Market
- How to Find Certifications and Accreditation Programs
- How to Find How-To Guides and Tutorials
- How to Find Best Practices and Guides in Your Market
- How to Find Glossaries and Term Definitions
- How to Find FAQs and Questions That a Market Asks
- How to Find Books and Reading Lists on Any Topic
- How to Find Templates and Checklists
- How to Find Online Tools and Calculators
- How to Find Resource Lists and Libraries
- How to Find Blogs and Bloggers in Your Market
- How to Find Analysis and Opinion Pieces in Your Market
MCP and API
The 50 tools, in alphabetical order. Each tool has an MCP page and an API page.
- account_calls_left
How many calls this account has left today, from the server's own counts. - account_team_members
The team of this account: each person with permissions in the account, or invited, and what that person can see and change, in plain words. - account_usage
The calls of this account in the last 14 days: the tokens that read the account, the calls of each day by source, and the newest calls.- MCP: account_usage
- API: POST /v1/account/usage
- backlinks
The sites that link to one or more of the sites named, from the stored link graph, with the PageRank, the backlink count, and the outbound link count of each linker.- MCP: backlinks
- API: POST /v1/backlinks
- backlinks_link_gap
The link gap: sites that link to the sites named and do not link to any of your excluded sites. - campaigns_activate
Makes an archived campaign active again. - campaigns_archive
Archives one campaign. Its daily counts and its daily opportunities email stop, and its data stays.- MCP: campaigns_archive
- API: POST /v1/campaigns/archive
- campaigns_create
Creates a new campaign in your account, with its label, industry, and description.- MCP: campaigns_create
- API: POST /v1/campaigns/create
- campaigns_dashboard
The campaign dashboard read: the opportunities counted each day on each index, the PageRank of every organization host month by month, and the index links found over time. - campaigns_finalize
Finalizes one campaign, so that its research starts. Finalize cannot be undone. - campaigns_list
Lists every campaign in your account, with its id, label, state, whether it is finalized, and how far its research got.- MCP: campaigns_list
- API: POST /v1/campaigns/list
- campaigns_organization_add
Adds one organization to a campaign: your own brand, a competitor, a partner, or a publisher. - campaigns_organization_delete
Deletes one organization from a campaign. - campaigns_organization_update
Changes one organization of a campaign. The call replaces the whole organization. - campaigns_organizations
Lists the organizations of one campaign, each with its relationship, its hosts, its brand names, and its chart color. - campaigns_rebuild_counts
Asks for the stored daily counts of one campaign to be counted again. - campaigns_rerun_research
Starts the research of one campaign again after it stopped. - campaigns_saved_opportunities
Lists the saved opportunities of one campaign and what each one searches. - campaigns_saved_opportunity_activate
Makes an archived saved opportunity active again. - campaigns_saved_opportunity_add
Adds one saved opportunity to a campaign: a saved search that is counted every day. - campaigns_saved_opportunity_archive
Archives one saved opportunity of a campaign. - campaigns_saved_opportunity_update
Changes one saved opportunity of a campaign. The call replaces the whole saved opportunity. - campaigns_set_daily_opportunities_email
Sets the daily opportunities email of one campaign. - campaigns_set_taxonomy_presets
Sets the 3 taxonomy presets of one campaign: the taxonomy categories the Content Optimizer opens with. - campaigns_settings
Returns the settings of one campaign: its label, industry, description, state, research, taxonomy presets, and daily opportunities email settings. - campaigns_update
Changes the label, the industry, or the description of one campaign.- MCP: campaigns_update
- API: POST /v1/campaigns/update
- linkgraph_history
The month-by-month PageRank and PRoT of one or more hosts, at three levels: the host itself, its www variant, and its registrable domain.- MCP: linkgraph_history
- API: POST /v1/linkgraph/history
- llm_answers_content_phrases
The wording the AI models use when they write about this market: the content phrases, scored across every model and run. - llm_answers_search_keywords
The search keywords the AI models say this market types, scored across every model and run. - llm_answers_top_sites
The domains the AI models name when they are asked who to use in this market, scored across every model and run. - news_brand_link_gap
Lists News Index pages that link to your competitors, on sites that link to none of your own sites. - news_brand_links
Lists the News Index pages that link to the sites of your campaign's brand, or to the sites of its competitors.- MCP: news_brand_links
- API: POST /v1/news/brand_links
- news_brand_mentions
Lists the News Index pages that name your campaign's brand, or its competitors, whether or not they link. - news_opportunities
The pages found on the News Index for one saved opportunity on the days from date_from to date_to, 1 to 7 days. - news_search
Search the News Index, a permanent collection of news pages, podcasts, and videos: by semantic similarity, by words in titles and bodies, or both, with date, document type, rank, outbound link, and type score filters.- MCP: news_search
- API: POST /v1/news/search
- news_similar_to_id
Lists the News Index documents nearest in semantic similarity to one document, named by its document_id. - news_unlinked_brand_mentions
Lists the News Index pages that name your brand and do not link to any of its sites. - prospects_brand_link_gap
Lists the Prospect Index pages that link to your competitors, on sites that link to none of your own sites. - prospects_brand_links
Lists the Prospect Index pages that link to the sites of your campaign's brand, or to the sites of its competitors. - prospects_brand_mentions
Index pages that NAME this campaign's own brand, or its competitors, without regard to linking, on the Prospect Index. - prospects_opportunities
The pages found on the Prospect Index for one saved opportunity on the days from date_from to date_to, 1 to 7 days. - prospects_search
Search the Prospect Index, the wider-web collection, with the same fields that news_search takes: by semantic similarity, by words over titles and bodies, or both, with date, type, rank, and outbound-link filters.- MCP: prospects_search
- API: POST /v1/prospects/search
- prospects_similar_to_id
The Prospect Index pages nearest in semantic similarity to one page, named by its document_id. - prospects_unlinked_brand_mentions
Index pages that NAME the brand and do NOT link to any of its sites, on the Prospect Index. - siteinfo_site
Who owns one site and how to reach them: titles, meta tags, social accounts, email addresses, phone numbers, feeds, paths, and street addresses, merged from the stored page data.- MCP: siteinfo_site
- API: POST /v1/siteinfo/site
- taxonomy_categories
The categories of one taxonomy: the id, the name, and the depth of each category, sorted by name. - taxonomy_semantic_content_analyzer
How near a piece of writing is to the taxonomy categories you aim at, and the phrases that would move it nearer. - taxonomy_taxonomies
The taxonomies of the category tools: the name of each one, which the taxonomy field of taxonomy_categories takes, and how many categories it holds. - types_content_types
The catalogue of content types: every type with its label. - types_opportunity_types
The catalogue of opportunity types: every group with its label and its types, each type as opportunity_type with its label.
App
The web app, one page for each page of the app. The groups follow the app menu.
- Campaign
- Brand
- Competition
- Opportunity Types
- News and Prospects
- Link Prospecting
- Content
- Content Types
- Site Info
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
- OppAlerts for Account Managers
- OppAlerts for AI Search Agencies
- OppAlerts for B2B SaaS Companies
- OppAlerts for Brand Managers
- OppAlerts for Competitive Intelligence Teams
- OppAlerts for Content Teams
- OppAlerts for Copywriters
- OppAlerts for Digital PR Teams
- OppAlerts for Ecommerce Teams
- OppAlerts for Hospitality Marketers
- OppAlerts for In-House Marketing Teams
- OppAlerts for Link Builders
- OppAlerts for Local Service Businesses
- OppAlerts for Marketing Consultants
- OppAlerts for SEO Agencies
- OppAlerts for SEO Teams
FAQ
- Are Contact Details Always Available?
- Can Agencies Manage Multiple Clients?
- Do I Need OppAlerts If I Have Ahrefs?
- Do I Need OppAlerts If I Have Semrush?
- Does OppAlerts Do Rank Tracking?
- Does OppAlerts Guarantee AI Rankings?
- Does OppAlerts Include Site Audits?
- Does OppAlerts Send Outreach?
- Does OppAlerts Write or Publish Content?
- How Fresh Is the Data?
- Are the API and MCP Available?
- What Does a Content Score Mean?
- What Happens After a Paid Plan Ends?
- Why Not Use ChatGPT Manually?