What is the OPR (Open PageRank) score?#

OPR (Open PageRank) is an authority score from 0 to 10 that APITube attaches to every news source — the publishing domain, not the individual article. A higher number means a more established, higher-authority publisher. Every article returned by the News API carries the score of its source under source.rankings.opr, and you can filter results by it with source.rank.opr.min and source.rank.opr.max.

Because OPR describes the source, every article from the same domain shares the same OPR value. It measures how authoritative the publisher is — not whether a specific story is accurate, positive, or breaking. For those, APITube has separate fields such as sentiment and is_breaking.

Where do I find the OPR score in a response?#

Every article includes its source’s OPR under source.rankings.opr as a whole number from 0 to 10:

{
    "source": {
        "domain": "example-news.com",
        "rankings": { "opr": 8 }
    }
}

You do not need a special parameter to get it — the value is part of the standard source object on each article, the same object that also holds the publisher’s domain, bias, and location. For the full list of fields on an article, see what’s inside a news article.

What does the OPR score mean, from 0 to 10?#

OPR is scored on a 0 to 10 integer scale, where 0 is an unranked or unknown domain and 10 is the strongest authority. APITube treats OPR 5 as its own bar for a well-ranked publisher: that is the floor used by top headlines and by the built-in quality flags described below.

As a rough guide for setting your own floor:

• OPR 5 and above — established, well-ranked publishers. APITube’s default authority bar.
• OPR 6 and above — the top tier, used by the premium-source flag.
• Below 5 — smaller, newer, or niche domains. Useful for wide coverage, weaker as an authority signal.

OPR rates the domain’s standing, so it is a signal of publisher reputation, not a fact-check of the article.

How do I filter news by OPR score?#

Use source.rank.opr.min to set a floor and source.rank.opr.max to set a ceiling. Pass a whole number between 0 and 10 — the value is read as an integer, so a floor of 7 keeps only publishers ranked 7 or higher:

curl "https://api.apitube.io/v1/news/everything?source.rank.opr.min=7&api_key=YOUR_API_KEY"

You can send the key as a header (X-API-Key: YOUR_API_KEY) instead of the api_key query parameter. If the value is not a number the request returns HTTP 400 with error ER0044; a negative value returns ER0045; a value whose length is outside 1–10 characters returns ER0046. The matching source.rank.opr.max errors are ER0047, ER0048, and ER0049. Combine the two to keep a band, for example mid-tier publishers only:

curl "https://api.apitube.io/v1/news/everything?source.rank.opr.min=4&source.rank.opr.max=7&api_key=YOUR_API_KEY"

Which built-in filters already use the OPR score?#

Several ready-made switches are built on the OPR-5 bar, so you do not have to set the floor by hand:

• Top headlines — /v1/news/top-headlines only returns articles from high-authority sources with OPR 5 or higher. See how to get top headlines.
• is_high_quality=1 — keeps articles from an OPR-5+ publisher that are not duplicates, carry an image, and have a named author.
• is_verified_source=1 — keeps OPR 5+ publishers and drops duplicates.
• is_premium_source=1 — keeps only the top tier at OPR 6 or higher.

For a full walkthrough of these flags and when to pick each one, see how to filter for high-quality, verified sources.

Does OPR affect how local news is ranked?#

Yes. On /v1/news/local, OPR is one of the weights that decides ordering. The authority ranking preset leans most heavily on it, blending source authority with distance, recency, and importance, so higher-OPR publishers surface first when you ask for authoritative local coverage.

Common Questions#

• Does a higher OPR mean the article is true?
• Is OPR set per article or per source?
• Can I pass a decimal like 0.6 to the OPR filter?

Does a higher OPR mean the article is true?#

No. OPR measures the publisher’s authority, not the accuracy of any single story. A high-OPR domain is more established, but the score does not verify claims. Treat OPR as a reputation signal and pair it with your own checks when accuracy matters.

Is OPR set per article or per source?#

Per source. OPR belongs to the publishing domain, so every article from the same source reports the same source.rankings.opr value. Filtering on source.rank.opr.min therefore keeps or drops whole publishers, not individual stories.

Can I pass a decimal like 0.6 to the OPR filter?#

Use a whole number. source.rank.opr.min and source.rank.opr.max are read as integers on a 0–10 scale, so pass values like 5, 6, or 7 rather than a decimal. Whole numbers match the same scale you see in source.rankings.opr.