<!-- The markdown copy of https://oppalerts.com/docs/how-to/refresh-existing-content . All pages: https://oppalerts.com/docs/llms.txt -->

[Documentation](https://oppalerts.com/docs/) / [How-To Guides](https://oppalerts.com/docs/how-to/) / How to Refresh Existing Content

# How to Refresh Existing Content

Decide which pages need an update and what each update must fix.

Tags: [Content Marketing](https://oppalerts.com/docs/tag/content-marketing), [SEO](https://oppalerts.com/docs/tag/seo)

Identify what has changed or what readers still need explained before assigning a content update. OppAlerts helps you research market questions and language, then compare a page with its intended topic and audience. You must choose the pages to review; OppAlerts does not select them or alert you to traffic losses.

- Which questions does the market ask now? Advanced Search, with the content type FAQs and Q&A.
- Which words does the market use? Keyword Research.
- Does the page still match its topic and its reader? Content Optimizer.

## Before you start: choose the page for a reason

Choose a page for a specific reason: a changed process, new evidence, or unanswered reader questions despite search visits. A page's age alone does not establish what needs fixing.

A service page can list accurate equipment details and credentials while leaving buyers unsure what to prepare or what the service includes. In that case, the update needs to address the customer's decision as well as describe the supplier.

## 1. Find the questions that the market asks now

1. Open [Advanced Search](https://oppalerts.com/docs/app/opportunities/advanced_search), and open the **News Index** tab.
2. In **Opportunity vector**, choose **Similarity text**, and paste the first paragraph of the page. Or type the main word of the page in **Title query**.
3. Click **Advanced**. In **Types**, tick **FAQs and Q&A**, and choose a minimum score, for example 60.
4. Set **Published** to a recent window, for example **Last month**, and click **Search**. The rows show the pages that answer questions about the subject now.
5. Do the same search on the **Prospect Index** tab, with **Published** on **No time limit**.
6. Compare the questions with the page. Write down each question that the page does not answer.

![Advanced Search, News Index tab, with FAQs and Q&A ticked in Types and Published on Last month.](https://oppalerts.com/img/docs/how-to/refresh-existing-content/faq-pages.png)

*Advanced Search, News Index tab, with the FAQs and Q&A type.*

- MCP: [`news_search`](https://oppalerts.com/docs/mcp/news_search) and [`prospects_search`](https://oppalerts.com/docs/mcp/prospects_search), with `{"campaign": 3, "similarity_target": "similarity_text", "similarity_text": "The first paragraph of the page.", "similarity_score_min": 25, "type_scores": [{"content_type": "faqs-and-q-and-a", "type_score_min": 60}], "sort": "best"}`. For the News Index, add `"published_from"` with a date.
- 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.

## 2. Compare the page with the words of the market

1. Open [Keyword Research](https://oppalerts.com/docs/app/content/keyword_research).
2. Read the **LLM Content Phrases** tab. It shows the phrases that the AI models use when they write about your market.
3. Read the **LLM Search Keywords** tab. It shows what the AI models say people search for in your market.
4. Identify subjects the page leaves unexplained and develop those explanations rather than adding isolated words.

![Keyword Research, LLM Content Phrases tab, with the Score, Seen, and Models columns.](https://oppalerts.com/img/docs/how-to/refresh-existing-content/content-phrases.png)

*Keyword Research, LLM Content Phrases tab.*

- MCP: [`llm_answers_content_phrases`](https://oppalerts.com/docs/mcp/llm_answers_content_phrases) and [`llm_answers_search_keywords`](https://oppalerts.com/docs/mcp/llm_answers_search_keywords), with `{"campaign": 3, "page": 1}`.
- API: [`POST https://api.oppalerts.com/v1/llm_answers/content_phrases`](https://oppalerts.com/docs/api/llm_answers_content_phrases) and [`POST https://api.oppalerts.com/v1/llm_answers/search_keywords`](https://oppalerts.com/docs/api/llm_answers_search_keywords), with the same JSON body.

## 3. Score the page against its topic and its reader

1. Open [Content Optimizer](https://oppalerts.com/docs/app/content/optimizer).
2. Paste the text of the page into the **Your writing** box. The box accepts up to 8,192 bytes. Score a long page in sections, for example the introduction apart from the practical sections.
3. In **The categories you are writing for**, choose the topic category or the audience category that the page is for.
4. Click **Score this writing**.
5. In **Where your writing actually sits**, read the top row and your highlighted row. If a different category is first, read the sections of the page and look for a real mismatch.
6. Read **Phrases to work in**. A phrase can show a subject that you did not explain.

![Draft comparison with a selected taxonomy category.](https://oppalerts.com/img/learn/content-optimizer.dark.webp)

*Draft comparison with a selected taxonomy category. Static demo example.*

If the service page's problem is an opening that dwells on company history, revising that section alone may be enough.

## How to judge the results

- **A result is a reason to look, not a cause.** Reread the page when another category ranks first. The result does not explain the cause or establish that a rewrite is necessary.
- **Pages from one template.** Similar results warrant a text comparison, but do not establish that pages were copied. Check what each page adds for its customer or service. Shared explanations can help, provided each page contains enough information of its own.
- **A phrase alone does not answer a question.** If the page does not say what the customer must prepare, explain it. Do not only add the word.
- **Check each claim.** Check each price, service, and process claim against current sources.
- **Fix the real problem.** Update outdated details, explain missing tasks, and address unsupported claims. Keep useful, accurate passages and recheck facts when the business changes.

[Browse all how-to guides](https://oppalerts.com/docs/how-to/).

## Related Pages

- [Content Optimizer](https://oppalerts.com/docs/app/content/optimizer) How to use the Content Optimizer page of the OppAlerts web app.
- [Advanced Search](https://oppalerts.com/docs/app/opportunities/advanced_search) How to use the Advanced Search page of the OppAlerts web app.
- [Keyword Research](https://oppalerts.com/docs/app/content/keyword_research) How to use the Keyword Research page of the OppAlerts web app.
- [How to Check Draft Topic Relevance](https://oppalerts.com/docs/how-to/check-draft-topic-relevance) Know before you publish whether a draft covers the topic in its brief.
- [How to Research Customer Questions](https://oppalerts.com/docs/how-to/research-customer-questions) Find the questions that your customers ask and that are worth an answer.
- [Content Optimizer](https://oppalerts.com/features/content-optimizer) See how closely your content matches the topics, audiences, and locations you're writing for.
- [Learn About Semantic Content Optimization](https://oppalerts.com/learn/learn-semantic-content-optimization) Use semantic comparisons to see how a draft relates to its intended topic and audience.
