Documentation / The Data / Search Results
Search Results
Understand the fields returned for each result from the News Index or Prospect Index.
One result is one document
Each result is one document from the News Index or the Prospect Index. Both indexes return the same fields. The web app, the MCP server, and the API show the same data.
In the web app
Each result in the web app shows:
- The title, the URL, and the host of the page.
- The opening text of the page.
- The Rank table: PR and PRoT, for the host and for the domain.
- Links out (article): the count of follow, nofollow, sponsored, and UGC links in the article.
- Brand links, competitor links, and contact details.
- Details: all stored data for the page.
- Similar News and Similar Prospects: pages that are semantically closest to this one.
The fields
The page
id: the document ID. Use it withnews_similar_to_idandprospects_similar_to_id.urlandhost: the address of the page and its host.document_type:page,podcast, orvideo.page.title: the title.page.snippet: the first 400 characters of the stored text.
Dates
published_at: the published date and time, as ISO 8601 text in UTC, for example2026-05-10T00:00:00Z. It is an empty string when OppAlerts could not read a date from the page. Most Prospect Index pages have no published date.indexed_at: the time the page was added to the index, in the same format.
Rank of the site
pr_hostandpr_domain: the PageRank of the host and of its domain, 0 to 100.prot_hostandprot_domain: PageRank over Time (PRoT), the sum of the monthly PageRank values. It has no upper limit. A high number means a long history, a high rank, or both.
PageRank Database explains PageRank and PRoT.
Scores
similarity_score: how semantically similar the page is to your search, 0 to 100. It isnullwhen the search had no vector ("similarity_target": "none").relevance_weight: the word-match weight of the page. Compare it only with other results in the same response. It isnullwhen the search did not search by words.type_scores: a map from each requested opportunity type or content type to the page's score for that type, 0 to 100, for example{"advertising/newsletter-ads": 62}. A search withtype_scoresin the request returns this map. Otherwise the key is absent.
Your campaign
org.relationship: the relationship when the search specifies a campaign and the host belongs to one of its organizations:org_owned_brand,org_competitor,org_partner, ororg_publisher. Otherwise the key is absent.
Links and contact details
OppAlerts splits each page into three parts: article,
nav, and comments (comments and other text that
users write).
page.link_counts: for each part, the count offollow,nofollow,sponsored, andugclinks.page.meta: the favicon, the feeds, and the contact pages.page.sections.article,page.sections.nav, andpage.sections.comments: for each part of the page, four lists.links: each outbound link.urlis the link target,textthe anchor text,titlethe title attribute, andrelthe list of rel values, for examplenofolloworsponsored. When the search specifies a campaign and the target belongs to one of its organizations,org.relationshipidentifies the relationship.emails: the email addresses in that part.phones: the phone numbers in that part.service_accounts: the social accounts in that part. Each hasservice, for examplelinkedin,username,label, andurl.
The whole answer
results: the list of rows.returned: the number of rows.partial:truewhen more than 15,000 pages match a search with a vector. The results then come from only a subset of matching pages. Make the search more specific.total_matches: onlynews_searchgives it. With a vector, it is at most 10,000, and 10,000 means 10,000 or more: the web app then shows the count line "100 of 10,000 or more results". With"sort": "type_score", the search does not count the matches, and it is 0.contacts:news_searchandprospects_searchcombine contact details from all result rows.accounts: four parts of the page,head,nav,article, andcomments. Each maps a service to a list of accounts:username,url,type,count, andnsfw.emails: a list ofemailandcount.phones: a list ofphoneandcount.countis the number of result rows containing the value. The lists start with the highest count.
Example row
A complete result row from news_search, for a search with
type_scores. A Prospect Index row has the same fields.
{
"id": "1152921504611003120",
"url": "https://cityguide-example.org/advertise/media-kit",
"host": "cityguide-example.org",
"document_type": "page",
"published_at": "2026-05-10T00:00:00Z",
"indexed_at": "2026-08-17T21:00:00Z",
"pr_host": 39,
"prot_host": 678,
"pr_domain": 61,
"prot_domain": 861,
"similarity_score": 46.8,
"type_scores": {
"advertising/newsletter-ads": 62
},
"relevance_weight": 1247.0,
"org": {
"relationship": "org_publisher"
},
"page": {
"title": "Advertise with City Guide: media kit",
"snippet": "Reach 400,000 monthly readers planning weekend trips. Sponsorship and hotel placements available.",
"link_counts": {
"article": {
"follow": 12,
"nofollow": 3,
"sponsored": 2,
"ugc": 0
},
"nav": {
"follow": 34,
"nofollow": 0,
"sponsored": 0,
"ugc": 0
},
"comments": {
"follow": 0,
"nofollow": 0,
"sponsored": 0,
"ugc": 0
}
},
"meta": {
"favicon": "https://cityguide-example.org/favicon-32.png",
"feeds": [
"https://cityguide-example.org/feed"
],
"contact": [
"https://cityguide-example.org/contact"
]
},
"sections": {
"article": {
"links": [
{
"url": "https://grand-resorts.example/awards",
"text": "Grand Resorts",
"title": "",
"rel": [
"nofollow"
],
"org": {
"relationship": "org_competitor"
}
}
],
"emails": [
"press@cityguide-example.org"
],
"phones": [
"+1 555 0100"
],
"service_accounts": [
{
"service": "linkedin",
"username": "cityguide",
"label": "City Guide",
"url": "https://linkedin.com/company/cityguide"
}
]
},
"nav": {
"links": [
{
"url": "https://partner-example.com/",
"text": "Our partner",
"title": "Partner",
"rel": [
"sponsored"
],
"org": {
"relationship": "org_partner"
}
}
],
"emails": [
"hello@cityguide-example.org"
],
"phones": [
"+1 555 0101"
],
"service_accounts": [
{
"service": "twitter",
"username": "cityguide",
"label": "",
"url": "https://x.com/cityguide"
}
]
},
"comments": {
"links": [
{
"url": "https://reader-blog-example.net/trip-notes",
"text": "my trip notes",
"title": "",
"rel": [
"ugc"
],
"org": {
"relationship": "org_publisher"
}
}
],
"emails": [
"comments@cityguide-example.org"
],
"phones": [
"+1 555 0102"
],
"service_accounts": [
{
"service": "reddit",
"username": "cityguide",
"label": "",
"url": "https://reddit.com/u/cityguide"
}
]
}
}
}
}
Example contacts
The contacts object from a complete news_search response.
{
"accounts": {
"head": {
"facebook": [
{
"username": "cityguide",
"url": "https://www.facebook.com/cityguide",
"type": "page",
"count": 14,
"nsfw": false
}
],
"x": [
{
"username": "cityguide",
"url": "https://x.com/cityguide",
"type": "user",
"count": 21,
"nsfw": false
},
{
"username": "cityguidedeals",
"url": "https://x.com/cityguidedeals",
"type": "user",
"count": 3,
"nsfw": false
}
]
},
"nav": {
"instagram": [
{
"username": "cityguide",
"url": "https://www.instagram.com/cityguide",
"type": "user",
"count": 18,
"nsfw": false
}
],
"x": [
{
"username": "cityguide",
"url": "https://x.com/cityguide",
"type": "user",
"count": 17,
"nsfw": false
}
]
},
"article": {
"linkedin": [
{
"username": "grand-resorts",
"url": "https://www.linkedin.com/company/grand-resorts",
"type": "page",
"count": 6,
"nsfw": false
}
],
"youtube": [
{
"username": "boutiquestays",
"url": "https://www.youtube.com/@boutiquestays",
"type": "channel",
"count": 4,
"nsfw": false
}
]
},
"comments": {
"onlyfans": [
{
"username": "examplecreator",
"url": "https://onlyfans.com/examplecreator",
"type": "user",
"count": 1,
"nsfw": true
}
],
"reddit": [
{
"username": "tripnotes",
"url": "https://www.reddit.com/user/tripnotes",
"type": "user",
"count": 2,
"nsfw": false
}
]
}
},
"emails": [
{
"email": "press@cityguide-example.org",
"count": 9
},
{
"email": "hello@cityguide-example.org",
"count": 4
}
],
"phones": [
{
"phone": "+1 555 0100",
"count": 7
},
{
"phone": "+1 555 0101",
"count": 2
}
]
}