<!-- The markdown copy of https://oppalerts.com/docs/the-data/search-results . All pages: https://oppalerts.com/docs/llms.txt -->

[Documentation](https://oppalerts.com/docs/) / [The Data](https://oppalerts.com/docs/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 with `news_similar_to_id` and `prospects_similar_to_id`.
- `url` and `host`: the address of the page and its host.
- `document_type`: `page`, `podcast`, or `video`.
- `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 example `2026-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_host` and `pr_domain`: the PageRank of the host and of its domain, 0 to 100.
- `prot_host` and `prot_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](https://oppalerts.com/docs/the-data/pagerank-database) explains PageRank and PRoT.

### Scores

- `similarity_score`: how semantically similar the page is to your search, 0 to 100. It is `null` when 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 is `null` when 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 with `type_scores` in 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`, or `org_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 of `follow`, `nofollow`, `sponsored`, and `ugc` links.
- `page.meta`: the favicon, the feeds, and the contact pages.
- `page.sections.article`, `page.sections.nav`, and `page.sections.comments`: for each part of the page, four lists.
  - `links`: each outbound link. `url` is the link target, `text` the anchor text, `title` the title attribute, and `rel` the list of rel values, for example `nofollow` or `sponsored`. When the search specifies a campaign and the target belongs to one of its organizations, `org.relationship` identifies 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 has `service`, for example `linkedin`, `username`, `label`, and `url`.

## The whole answer

- `results`: the list of rows.
- `returned`: the number of rows.
- `partial`: `true` when 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`: only `news_search` gives 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_search` and `prospects_search` combine contact details from all result rows.
  - `accounts`: four parts of the page, `head`, `nav`, `article`, and `comments`. Each maps a service to a list of accounts: `username`, `url`, `type`, `count`, and `nsfw`.
  - `emails`: a list of `email` and `count`.
  - `phones`: a list of `phone` and `count`.
  - `count` is 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.

```json
{
  "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.

```json
{
  "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
    }
  ]
}
```

## Related Pages

- [news_search](https://oppalerts.com/docs/mcp/news_search) Search the News Index, a collection of news pages, podcasts, and videos that keeps every document: by semantic similarity (similarity_text), by words over titles and bodies, or both, with date, type, rank, and outbound-link filters.
- [prospects_search](https://oppalerts.com/docs/mcp/prospects_search) Search the Prospect Index, the wider-web collection, with the same request the news/search endpoint takes: by semantic similarity, by words over titles and bodies, or both, with date, type, rank, and outbound-link filters.
- [News Index](https://oppalerts.com/docs/the-data/news-index) The search engine of OppAlerts for current news pages, podcasts, and videos.
- [Prospect Index](https://oppalerts.com/docs/the-data/prospect-index) The search engine of OppAlerts for pages that show a way to take part in your market.
- [PageRank Database](https://oppalerts.com/docs/the-data/pagerank-database) The monthly PageRank of each site since July 2017, so that you can see how established a site is and where it goes.
- [Site Info Database](https://oppalerts.com/docs/the-data/site-info-database) The contact details that a website publishes about itself, so that you can find the right way to reach it.
