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 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 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.

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.

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