Documentation / Opportunity Types / How to Find Buyer Guides
How to Find Buyer Guides
Find guides that help buyers choose products or vendors in your market, and learn what those buyers are told to check.
What this type finds
The Buyer Guides type finds pages that help a customer choose and buy. It includes several kinds of pages:
- Buyer guides, buying guides, purchasing guides, and procurement guides.
- Selection guides and evaluation guides, with the criteria to use.
- How-to-choose pages and pages about what to look for before you buy.
- Vendor selection pages with checklists and questions to ask vendors.
- Comparison guides that put several products or vendors side by side.
- Guides produced by vendors, often as downloads.
- Consumer guides, such as a guide to buy a car or a home.
- Pages that invite a vendor to submit a listing.
The type identifies the page's format rather than its subject. Your campaign determines which subject comes first.
Why it matters
A buyer guide reaches a person who is close to a decision. If your business is in the guide, the buyer sees it at the right time. The guide can also link to your site.
A buyer guide also shows the criteria that your market uses to choose. You can use them to write your own pages, to check your product, and to answer the questions that buyers ask. The type fits a business that sells to buyers who compare options before they pay.
Find it in the web app
- Open Opportunity Types in the web app menu.
- Choose Commerce, then choose Buyer Guides.
- Read the Prospect Index tab first. It contains pages from all dates. Min type score starts at 40. Raise it to see only the pages that match this type most closely.
- Click Vector similarity in Sort by to put the pages most relevant to your market first.
- Open the guides that fit your market. Read the criteria and the vendors that each guide names, and see if your business is there.
- Read the News Index tab for current pages. Set Published to the last few weeks.
Get new pages every day
- Open your campaign in Edit Campaign, and open the Opportunities tab.
- In Search for, choose Buyer Guides in the Commerce group. In Opportunity vector, choose Campaign. Click Add opportunity.
- Open the Daily Email tab, select the checkbox, choose the hour, and click Save.
Each day, the pages added to the indexes in the last 24 hours appear on the Dashboard tab and in the daily opportunities email. See Daily Monitoring and Alerts.
In MCP and the API
Two tools search this type. One request body works for both:
{
"campaign": 3,
"similarity_target": "campaign",
"type_scores": [{"opportunity_type": "commerce/buyer-guides", "type_score_min": 50}],
"sort": "type_score"
}
- MCP:
news_searchsearches the News Index.prospects_searchsearches the Prospect Index. - API:
POST https://api.oppalerts.com/v1/news/searchandPOST https://api.oppalerts.com/v1/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, Create an API Token, and Your First API Call.
How to judge the results
A high type score indicates that the page matches this type. It does not tell you whether the page is a good fit for you. Check these points before you act:
- Check the author. Editors, vendors, and sellers of leads write guides for different reasons. Check which one wrote the guide.
- Check the date. A buyer guide with outdated prices and products can hurt your business if it describes it incorrectly.
- Check the criteria. If your product meets them, look for how to request a listing or correction. If it does not, learn why.
- Check for payment. Some guides charge a vendor for a place. Look for a note about paid listings.
- Check the reach. Use the domain PR column and the page itself to see if real buyers read the guide.