<!-- The markdown copy of https://oppalerts.com/docs/app/content/types . All pages: https://oppalerts.com/docs/llms.txt -->

[Documentation](https://oppalerts.com/docs/) / [App](https://oppalerts.com/docs/app/) / Content Types

# Content Types

`App https://oppalerts.com/app/content/types`

## What you use it for

**A content type is a SHAPE of page, not a subject.** A blog post, an FAQ, a how-to guide, and a glossary can all be about the same thing and are four different pages to write.

This page shows examples of each content format in your market, from the Prospect Index and News Index. Read them before you write to see what publishers already cover and what your content could add.

### The content types

- **Blogs.** Who publishes regularly in this market and what their posts look like.
- **FAQs and Q&A.** The questions the market answers in public, and the pages that answer them.
- **How-to guides.** The instructional pages that win the market's searches.
- **Templates and checklists.** The templates, checklists, and worksheets people copy for a task.
- **Glossaries and definitions.** The pages that own "what is X".
- **Case studies, research, and data.** The pages other people cite.
- **Academic journals, analysis, and opinion** and the rest.

### Who this page is for

- **Anybody planning what to write next** and guessing at the format.
- **Anybody who has written a lot and ranked for none of it.** The shape is often the reason.
- **Anybody who has to justify a content plan to a client.** "Every page that wins this market is a case study" is an argument; "we think we should do case studies" is not.

## How it works

![The tab strip.](https://oppalerts.com/img/docs/app/content/types/the-tab-strip.png)

*The tab strip.*

It uses the same search mechanism as Opportunity Types to ask a different question. **Two halves, asked together, and a page has to answer both.**

### Question one: is it the right SHAPE of page?

Every page in both indexes carries a stored score for each content type, 0 to 100. The score says how strongly the page reads as that shape, from the phrases in its address, its title, and the start of its text. A how-to guide says "step by step", "how to". An FAQ page says "frequently asked questions". A glossary says "glossary of terms".

**You do not set these scores and you never see the phrases.** Min type score sets the least score a page must carry to be shown.

### Question two: is it about YOUR market?

Your campaign text: a stored description of your market, written from what the AI models said about your industry. The search keeps the pages nearest to that description in semantic similarity. **Min similarity** says how near a page must be to stay in the list. It opens at 30%, marked good start.

![The search form of a type page, as it opens.](https://oppalerts.com/img/docs/app/content/types/the-search-form-of-a-type-page-as-it-opens.png)

*The search form of a type page, as it opens.*

### The search form

- **The type name and Min type score** are first in the sidebar. Min type score goes from 100 down to 1 and opens at 40.
- **Opportunity vector opens on Campaign**, so the page searches as soon as it opens. OppAlerts makes the Campaign vector when the campaign is finalized and its research finishes. Before that, the menu opens on No vector. You can choose Campaign, but the page does not search, and it says why. The box shows the campaign's saved text, read only. You can also choose one of your saved opportunities or Similarity text to paste your own text.
- **Title query and Body query** are optional words. Every word typed is required. When you type words, a page must match the words AND be at or above Min similarity AND carry the type score.
- **Published and Added to index** open on No time limit. The menus go from Last day to Last 3 months.
- **Min domain PR and Min host PR** open at 10.
- **Advanced** opens Min domain PRoT and Min host PRoT, the Maximums, and the 12 Links out menus. There is no Types box on this page, because the page already searches one type.
- **Clear** puts every box back to how the page opens, and runs the search again.

**The words, the count line, and a search that did not run.** Title query and Body query take the [search operators](https://oppalerts.com/docs/the-data/advanced-search-operators). A query with a formatting error is not searched: the sentence names the box and the error. [How to Search the Indexes](https://oppalerts.com/docs/the-data/how-to-search-the-indexes) has every rule of a query. A number box takes digits only. The count line says how many rows the page shows, for example "100 results". "100 of 10,000 or more results" means that the search found 10,000 pages or more. When the search was sent and did not end, the count line says "The search did not finish", "The search was stopped", "No searches left today", or "Another search is running", and a sentence under it says what to do. The page opens at its own values: a value that you typed on another search page is not carried over.

**Each row shows its type score** for this type, 0 to 100, beside similar and relevance.

In the sample above, the sidebar asks for Blogs pages with a type score of 40 or more, at 30% or more similar to the campaign, on sites with a domain PR and a host PR of 10 or more.

### Sort by

Sort by opens on **Type score**: the strongest content type score first, then the pages nearest your market. Click **Vector similarity** to put the pages nearest your market first. **Keyword relevance** is how well the page matches the typed words, and it is grey until a word box holds words. **Date added** and **Date published** sort by the two dates. The sort stays on Type score until you click another button. It does not change when you type.

### The difference from Opportunity Types

**An opportunity is a page that will take something from you. A content type is a page you are going to make yourself.** Same mechanism, two completely different jobs. If you are building an outreach list you are on the wrong page; that is Opportunity Types.

## Tabs

The page has 2 tabs.

### Tab 1: Prospect Index

![The time windows on the Prospect Index tab.](https://oppalerts.com/img/docs/app/content/types/the-time-windows-on-the-prospect-index-tab.png)

*The time windows on the Prospect Index tab.*

### What it shows

**Pages of this shape from our own index**, nearest your market, ranked or not. One row per page, with the title, the start of the text, and the site's standing.

In the sample above, Added to index is on Last month: the tab then shows only the pages that came into the index in the last month, whatever their published date. A **Contacts** box can be in the results card, above the rows.

The Prospect Index shows how publishers across your market use this format, whether or not those pages rank. Read a range of examples to see how they approach the subject and who they're writing for.

### Where the data comes from

Our own index of pages, fetched and indexed for prospecting. Not a search engine's answer, not collected per campaign, and always growing.

**Shape first, market second.** A page is kept only when its score for this content type is at or above Min type score. From those, the page keeps the ones nearest in semantic similarity to your market, then orders them by Sort by: the strongest score first, unless you choose another order.

**Most prospect pages carry no published date.** When you set Published, a page with no published date is left out, so on this tab Published removes most pages. Use **Added to index** on this tab, and use the News Index tab when you need pages published recently.

![One result, on the Prospect Index and News Index tabs.](https://oppalerts.com/img/docs/app/content/types/one-result-on-the-prospect-index-and-news-index-tabs.png)

*One result, on the Prospect Index and News Index tabs.*

### Reading one result row

Every page in the application that shows an index result displays this same row, with the same fields in the same order, so learning it once is enough. **A hyphen means the row has no value there, or the value is 0.**

- **The title** is the page itself. It opens in a new tab.
- **The host under it** is the site. Click it to open the site. The mark beside it says what the site is to your campaign, such as Competitor, when it is one of your organizations. The address after it is the page's path on that site.
- **Save** is the small button before the text. It puts a label on the result, such as Follow up. The label is not stored yet, so a reload clears it.
- **The text** is what the index stored, not a search engine's snippet. It is the beginning of the page's own writing, which is why it is worth reading before you approach anybody.
- **similar, relevance, type score.** **similar** is the semantic similarity of the page to the search text, 0 to 100 percent. **relevance** is how well the page matches the typed words; it has no upper end, so compare it only with the other rows of the list. **type score** is how well the page fits the opportunity type or content type, 0 to 100. Each one needs its part of the search, and without it the row prints a hyphen.
- **Brand links and Competitor links** say whether this page already links to you or to a competitor, from your Organizations list. Each line is one host it links to. **Competitor links and no brand links is the target row.**
- **Contact** is what the site publishes about itself: email addresses, phone numbers, and social accounts. Point at an icon to see them.
- **host PR, domain PR, host PRoT, domain PRoT.** They come from a link graph built from billions of links. **PR** is the PageRank of the newest month it holds, 0 to 100. **PRoT is PageRank over Time**: the PageRank of every month the graph holds, added up. So a site that has been strong for years is high on both, and a site that is strong only now is high on PR and low on PRoT. **Host and domain differ**, often by a lot: a strong domain can carry a weak subdomain, and these are the numbers the PageRank minimums filter on.
- **published, then indexed.** published is the date on the page, when it has one. Prospect pages usually do not, and the row prints a hyphen. indexed is the date the page came into the index. Both are dates in UTC.
- **links out (article)** is how many outbound links the page's own article carries, then follow, nofollow, sponsored, and UGC split them by type. A link with 2 types counts in both. A page with many followed outbound links links freely; a page with none does not link out at all, and asking it for a link is usually wasted effort.
- **Details** opens the hosts the page links to, in the article, the navigation, and the comments, and the site's contact routes: email addresses, phone numbers, social accounts, contact pages, and RSS feeds. It is always there, whatever the row holds.
- **Similar news and Similar prospects** find the pages nearest in semantic similarity to this one, in the News Index or the Prospect Index.

### How to use it

1. **Use it to find the pattern**, not the winner. Read ten pages of one shape and the convention becomes obvious.
2. **Compare a weak site's version against a strong site's.** The difference is usually depth and structure, and it is the brief for your own page.
3. **Raise Min domain PR** if the tab is full of sites nobody has heard of.
4. **Open Details** to see how to reach the site: social accounts, email addresses, phone numbers, contact pages, and the page's outbound links.

### Tab 2: News Index

### What it shows

**This shape**, across news, podcasts, and video. One card per document.

For some shapes this tab is full: blogs, opinion, research. For others it is nearly empty, and that is correct. Nobody publishes a glossary page as news.

### Where the data comes from

The News Index: news sources, news aggregators, about 20 million RSS feeds, and more than 4 million podcast feeds. It keeps every document.

**This is the only tab that tells you what is being published NOW.** The other tab tells you what exists. For a content plan that is the difference between "this shape works" and "this shape is what people are writing this month".

![One result, on the Prospect Index and News Index tabs.](https://oppalerts.com/img/docs/app/content/types/one-result-on-the-prospect-index-and-news-index-tabs.png)

*One result, on the Prospect Index and News Index tabs.*

### Reading one result row

Every page in the application that shows an index result displays this same row, with the same fields in the same order, so learning it once is enough. **A hyphen means the row has no value there, or the value is 0.**

- **The title** is the page itself. It opens in a new tab.
- **The host under it** is the site. Click it to open the site. The mark beside it says what the site is to your campaign, such as Competitor, when it is one of your organizations. The address after it is the page's path on that site.
- **Save** is the small button before the text. It puts a label on the result, such as Follow up. The label is not stored yet, so a reload clears it.
- **The text** is what the index stored, not a search engine's snippet. It is the beginning of the page's own writing, which is why it is worth reading before you approach anybody.
- **similar, relevance, type score.** **similar** is the semantic similarity of the page to the search text, 0 to 100 percent. **relevance** is how well the page matches the typed words; it has no upper end, so compare it only with the other rows of the list. **type score** is how well the page fits the opportunity type or content type, 0 to 100. Each one needs its part of the search, and without it the row prints a hyphen.
- **Brand links and Competitor links** say whether this page already links to you or to a competitor, from your Organizations list. Each line is one host it links to. **Competitor links and no brand links is the target row.**
- **Contact** is what the site publishes about itself: email addresses, phone numbers, and social accounts. Point at an icon to see them.
- **host PR, domain PR, host PRoT, domain PRoT.** They come from a link graph built from billions of links. **PR** is the PageRank of the newest month it holds, 0 to 100. **PRoT is PageRank over Time**: the PageRank of every month the graph holds, added up. So a site that has been strong for years is high on both, and a site that is strong only now is high on PR and low on PRoT. **Host and domain differ**, often by a lot: a strong domain can carry a weak subdomain, and these are the numbers the PageRank minimums filter on.
- **published, then indexed.** published is the date on the page, when it has one. Prospect pages usually do not, and the row prints a hyphen. indexed is the date the page came into the index. Both are dates in UTC.
- **links out (article)** is how many outbound links the page's own article carries, then follow, nofollow, sponsored, and UGC split them by type. A link with 2 types counts in both. A page with many followed outbound links links freely; a page with none does not link out at all, and asking it for a link is usually wasted effort.
- **Details** opens the hosts the page links to, in the article, the navigation, and the comments, and the site's contact routes: email addresses, phone numbers, social accounts, contact pages, and RSS feeds. It is always there, whatever the row holds.
- **Similar news and Similar prospects** find the pages nearest in semantic similarity to this one, in the News Index or the Prospect Index.

### How to use it

1. **Look for formats publishers are starting to use.** If you see few examples in the Prospect Index and plenty in the News Index, read the recent pages to see what's changed.
2. **Use it to find who is publishing right now**, which is also who is most likely to take a pitch.
3. **Set Published to Last week** for a weekly review. Nearly every news page has a published date.

## On your own campaign

### The order to work in

1. **Pick a type from the menu.** With no type selected, the page opens and asks you to pick one.
2. **Open the Prospect Index tab and read three relevant pages.** Look at how they explain the subject and who they're written for.
3. **Read five more pages in the same format.** Compare what they cover, how they're organized, and what they leave unanswered. Use that to decide what your own page should include.
4. **Check the News Index tab** for what is being published this month.
5. **Repeat for the two or three types you are choosing between.** The comparison is the decision.

### Turning it into a plan

- **This page says WHICH SHAPE to write.**
- **Keyword Research says WHAT WORDS to use.** The LLM Content Phrases tab is written for exactly this.
- **Content Optimizer checks the draft** before you publish.

Those three pages in that order are a content plan.

### Reading the answer

- **If you find plenty of guides,** read them to see what they teach and which questions still need a clearer answer.
- **If you find plenty of case studies,** check which results they report and who they were written for.
- **If you find FAQs,** look at the questions they answer and whether those questions matter to your customers.
- **If your own pages appear,** read them alongside the other examples to decide what to update or add.

### When a type looks wrong

- **Off-market results.** The campaign description is wrong. Everything in the application is built on it.
- **Right market, wrong shape.** Raise Min type score. It keeps only the pages that read most strongly as this content type.
- **Almost nothing on any tab.** Some shapes genuinely do not exist in some markets, and that is a finding: it is either an opportunity or a warning, and the Prospect Index tab tells you which.

## MCP

These MCP tools give the same data. Each page has every parameter and an example.

- [`news_search`](https://oppalerts.com/docs/mcp/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. Send `type_scores` with one content type and its `type_score_min`, and sort by `type_score`.
- [`prospects_search`](https://oppalerts.com/docs/mcp/prospects_search): Search the Prospect Index, the collection of the wider web, with the same fields that news_search takes: by semantic similarity, by words in titles and bodies, or both, with date, document type, rank, outbound link, and type score filters. Send `type_scores` with one content type and its `type_score_min`, and sort by `type_score`.
- [`types_content_types`](https://oppalerts.com/docs/mcp/types_content_types): The catalogue of content types: every type with its label.

## API

These API routes give the same data.

- [`POST /v1/news/search`](https://oppalerts.com/docs/api/news_search)
- [`POST /v1/prospects/search`](https://oppalerts.com/docs/api/prospects_search)
- [`POST /v1/types/content_types`](https://oppalerts.com/docs/api/types_content_types)

## Related pages

- [All App Pages](https://oppalerts.com/docs/app/)
