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

[Documentation](https://oppalerts.com/docs/) / [Content Types](https://oppalerts.com/docs/content-types/) / How to Find Case Studies and Customer Success Stories

# How to Find Case Studies and Customer Success Stories

Find the proof that a market publishes, and learn which companies have results to show.

Tags: [Content Marketing](https://oppalerts.com/docs/tag/content-marketing), [Competitive Analysis](https://oppalerts.com/docs/tag/competitive-analysis)

## What this type finds

This type finds pages that tell the story of one customer, client, or project. It groups these kinds of pages together:

- **Case studies.** A page with a problem, an action, and a result.
- **Customer and client success stories.** The same idea, in the voice of the company that sells the service.
- **Customer and client spotlights.** A short profile of one customer.
- **Case study libraries.** A page that lists many case studies, often with a filter.
- **Project highlights and featured projects.** Pages from agencies and builders that show finished work.
- **Results pages.** Pages showing the results a company achieved for its clients.
- **Calls for case studies.** Pages in which a publisher or a vendor asks for customer stories, with a template or a submission form.

Most pages are written by the company that did the work. They show how that company wants the market to see it.

## Why it matters

This type is for research. When you take on a new client, case studies show you what buyers in the market want to see as proof. You learn which results matter, which numbers companies quote, and which kinds of customers they choose to show.

It also finds experts. A company with many strong case studies has real experience. A competitor with an extensive case study library shows you how it sells. A call for case studies shows you a publisher that wants stories like yours.

## Find it in the web app

1. Open **Content** in the web app menu.
2. Under **Content Types**, choose **Case Studies**.
3. Start with the **Prospect Index** tab. It shows pages of this type from the OppAlerts index, with the closest semantic matches to your campaign first. To filter by date, use **Added to index**. Most pages on this tab have no published date, so using **Published** filters them out.
4. Open the **News Index** tab. It shows what news sources, podcasts, and videos publish now.
5. Read the first ten results of each tab. Note the results that companies quote, and the customers that they show.

**Min type score** starts at 40, and **Min similarity** starts at 30%. Raise **Min domain PR** if the list includes sites that nobody in your market knows.

![The Case Studies page, Prospect Index tab, with the first results.](https://oppalerts.com/img/docs/content-types/case-studies/prospect-index.png)

*Case Studies, Prospect Index tab.*

## See the new pages

The Search for menu on the Opportunities tab of Edit Campaign lists the brand searches and the opportunity types. To see new pages of this content type, open Content Types again and set **Added to index** to **Last day**. The tab then shows only pages added to the index in the last day.

For details about the daily opportunities email and the saved opportunities it uses, read [Daily Monitoring and Alerts](https://oppalerts.com/docs/getting-started/daily-monitoring-and-alerts).

## In MCP and the API

Two tools search this type. One request body works for both:

```json
{
  "campaign": 3,
  "similarity_target": "campaign",
  "type_scores": [{"content_type": "case-studies", "type_score_min": 50}],
  "sort": "type_score"
}
```

- MCP: [`news_search`](https://oppalerts.com/docs/mcp/news_search) searches the News Index. [`prospects_search`](https://oppalerts.com/docs/mcp/prospects_search) searches the Prospect Index.
- API: [`POST https://api.oppalerts.com/v1/news/search`](https://oppalerts.com/docs/api/news_search) and [`POST https://api.oppalerts.com/v1/prospects/search`](https://oppalerts.com/docs/api/prospects_search), with the same JSON body.

In `type_scores`, `type_score_min` sets the minimum type score, from 1 to 100. Sorting by `type_score` puts the highest type score first. To keep only the newest pages, add `published_from` or `indexed_from`, with a date in YYYY-MM-DD format. The MCP pages list every parameter and include the full example response.

To connect your AI agent or to send API requests, read [Use OppAlerts in Your AI Agent](https://oppalerts.com/docs/getting-started/use-oppalerts-in-your-ai-agent), [Create an API Token](https://oppalerts.com/docs/getting-started/create-an-api-token), and [Your First API Call](https://oppalerts.com/docs/getting-started/your-first-api-call).

## How to judge the results

- **Check the numbers.** A result with a number, a time, and a customer name is worth more than "great results".
- **Check the date.** An old case study can show a product that no longer exists.
- **Check who wrote it.** A company writes about itself. Treat its claims as claims.
- **Check the customer.** Check whether the customer is like your client in size, sector, and need.
- **Check if it is gated.** Some case studies require you to fill out a form before you can read them. Decide whether filling out the form is worth it.
- **Check a call for case studies.** Read the rules for who can submit one and what the publisher does with it.

[Browse all content types](https://oppalerts.com/docs/content-types/).

## Related Pages

- [Case Studies](https://oppalerts.com/docs/app/content/types/case-studies) The Case Studies content type finds pages of this type in the indexes.
- [`news_search`](https://oppalerts.com/docs/mcp/news_search) Searches the News Index by semantic similarity, words, dates, rank, outbound links, and type scores.
- [How to Find Content Ideas](https://oppalerts.com/docs/how-to/find-content-ideas) Turn customer questions and current coverage into content ideas that your business can support with evidence.
- [How to Research a New Client Market](https://oppalerts.com/docs/how-to/research-a-new-client-market) Learn a new client's market: the buyers, the competitors, the coverage, and the first work to do.
- [How to Monitor Competitor Mentions](https://oppalerts.com/docs/how-to/monitor-competitor-mentions) Know where your competitors are mentioned, and find the coverage that your business is missing.
- [White Papers & Ebooks](https://oppalerts.com/docs/app/content/types/white-papers-and-ebooks) The White Papers & Ebooks content type finds pages of this type in the indexes.
