Skip to main content

⚙️ API Documentation

Scale your media sales and boost profits with PRNEWS.IO API

Written by Oleksandr Storozhuk

Unlock real-time access to 100,000+ media outlets — prices, availability, terms, and key metrics (Ahrefs, SimilarWeb, etc.) — all updated automatically.
No more juggling multiple tools or paying for analytics subscriptions.
Add your own margin and resell effortlessly — zero operational costs, zero headaches.​

With our API, you can:

  • Instantly check media prices and availability

  • See metrics and trends for smarter decisions

  • Automate your workflow and scale client offerings

  • Boost profits without hiring extra staff

How It Works

Our API is based on Elastic API. For more information, check this link:
Elastic API Guide

The price for API access is $5,000 per year (+15% PRNEWS.IO service fee).

Simply order it via the link, and we’ll quickly activate your access and send your API key so you can start using our Elastic server immediately.

Available Endpoints

You can get data using your API Key through a GET-request to https://prnews.es.eu-central-1.aws.cloud.es.io/platforms.

Limits

Every API key is limited to 3,000 results per request.

Response Parameters

Text parameters also have localized versions in responses.

General Paramenters

Request parameter

Output

Description

id

250291

Internal numeric identifier for the listing in the PRNEWS database

name_en

Fortune

Display name of the media outlet in English

alias

80015-gritdailycom.html

URL-safe slug used to construct the listing page path. Just add https://prnews.io/sites/ in the beginning

seo_url

fortune.com

SEO-friendly version of the URL, usually identical to url

cost

750

The placement price in USD — this is the field to use for pricing (not price)

description_en

<p>Fortune is a leading global business publication covering major developments in finance...

Human-readable English description of the outlet — what it covers, its audience, focus areas

condition_publication_place_description_en

The article will be published in the <em><a rel=...

Explains where on the site the article will be published

example

A direct link to a live example article previously published on this outlet via PRNEWS

type

newsmedia

The type of media outlet — object with alias and name_en

More

blog - "Blog"
localnews - "Local news"
newsmedia - "News Media"
newsagency - "News agency"
pr - "PR Distribution Service"
portal - "Portal"
socialmedia - "Social media"

format_type

pressrelease

The format of the placement — object with aliases and name_en

More

advertorial - "Article"
contributor
- "Contributor Post"
interview - "Interview"
listicle
- "Listicle"
mention
- "Mention"
news
- " Paid news"
pressrelease
- "Press Release"
thoughtleadership
- "Thought Leadership"

doc_updated_at

1775548861

Unix timestamp of the last time a format was updated (metrics, price, conditions, or any other data)

deleted_after

0

Unix timestamp when a format was removed from the marketplace. Value 0 means the outlet is still active

Classification Paramenters

Request parameter

Output

Description

country

us

The country the outlet is registered in or primarily targets — object with alias (e.g. us) and name_en (e.g. "United States of America").
ISO 3166-1 alpha-2 is used as a standard defining codes for the names of countries

country_region

northern-america

Broader geographic region — object with alias and name_en.
Possible to be multiple values

More

northern-america - "North America"

western-europe - "Western Europe"

gulf - "GULF"

arab-world - "Arab world"

apac - "Asia Pacific (APAC)"

australia-and-new-zealand - "Australia & New Zealand"

baltics - "Baltics"

benelux - "Benelux"

cis - "CIS"

caribbean - "Caribbean"

central-america - "Central America"

central-asia - "Central Asia"

dach - "DACH"

eastern-africa - "Eastern Africa"

eastern-asia - "Eastern Asia"

eastern-europe - "Eastern Europe"

europe - "Europe"

european-union - "European Union"

latam - "LATAM"

mena - "MENA"

melanesia - "Melanesia"

micronesia - "Micronesia"

middle-africa - "Middle Africa"

nordic - "Nordic"

northern-africa - "Northern Africa"

northern-europe - "Northern Europe"

polynesia - "Polynesia"

south-america - "South America"

south-eastern-asia - "Southeast Asia"

southern-africa - "Southern Africa"

southern-asia - "Southern Asia"

southern-europe - "Southern Europe"

western-africa - "Western Africa"

western-asia - "Western Asia"

city

miami-us-fl

City associated with the outlet - object with alias (e.g. rocky-mount) and name_en (e.g. "Rocky Mount, NC").
Usually is used for regional media (Main Category - Local News)

language

en

Language(s) the outlet publishes in — array with alias (e.g. en) and name_en.
Possible to be multiple values.

main_category

business

The primary editorial category of the outlet — e.g. technology, world (General News), business

category

finance

Array of all applicable categories.

base_options

cost: 608.0,

price: 608.0,

uuid: 1400dcc3-04f4-11f1-aaf8-021ebc508ca5

name_en: Featured on Apple News

Array of optional add-ons available for this listing. Each has cost, price, uuid, name_en, and cost. Please, use cost for pricing

currency

usd

Currency code for publisher's currency

price

750

The placement price in publisher's currency. Do not use this field. Use cost instead

cost_updated_at

1775548862

Unix timestamp of the last time the price was updated

Audience & Traffic Metrics by Similarweb Paramenters

Request parameter

Output

Description

audience

29209310

Total visits (sessions) in the last month

page_per_visit

1.49105

Average number of pages a visitor views per session

bounce_rate

0.475086

Percentage of visitors who leave after viewing only one page

time_on_site

37.1154

Average time (in seconds) visitors spend on the site per session

source_search

47.64

% of visitors from search engines

source_referrals

9.11

% of visitors from referral websites

source_direct

37.16

% of visitors from direct access

source_social

5.44

% of visitors from social media

source_display

0.55

% of visitors from display ads

source_mail

0.1

% of visitors from email

audience_source_search

1,287,137

Absolute number of visitors from search engines

audience_source_referrals

246,244

Absolute number of visitors from referral websites

audience_source_direct

1,004,016

Absolute number of visitors from direct access

audience_source_social

146,964

Absolute number of visitors from social media

audience_source_display

14946

Absolute number of visitors from display ads

audience_source_mail

2598

Absolute number of visitors from email

country_audience

country_audience.au.visits: 571743

Array of top countries by visitor volume, plus individual visit counts stored as country_audience.<ISO 3166-1 alpha-2 country code>.visits (e.g. country_audience.us.visits)

cost_per_thousand

163.83

Cost per 1,000 estimated views — useful for comparing value across outlets

SEO & Authority Metrics Paramenters

Request parameter

Output

Description

ahrefs_dr

91

Ahrefs Domain Rating (0–100) — measures the strength of the outlet's backlink profile; highly regarded by SEO professionals

ahrefs_positions_metrics_traffic

2345613

Ahrefs estimate of monthly organic search traffic

semrush_authority_score

78

SEMrush's composite authority metric (0–100) combining backlinks, traffic, and spam signals

semrush_organic_traffic

4580328

SEMrush estimate of monthly organic search traffic

moz_domain_authority

57

Moz DA score (0–100) — measures overall domain strength and ranking potential

mj_tf

73

Majestic Trust Flow — measures the quality/trustworthiness of backlinks pointing to the domain

mj_cf

76

Majestic Citation Flow — measures the quantity/volume of backlinks; compare with TF to assess link quality

trust_rank

2

The final indicator of the quality of the site, based on the indicators Majestic Citation Flow и Majestic Trust Flow.

estimated_views

4578

Estimated number of views a placed article is expected to receive (internal PRNEWS metric)

Conditions Paramenters

Request parameter

Output

Description

lead_times

120

Turnaround Time (TAT) in hours

homepage

without-homepage

Whether the article title will appear on the outlet's homepage - object with aliases and name_en:

More

homepage - "Homepage title"
without-homepage - "No homepage title"
homepage-is-optional - "Homepage title is optional"
Homepage-fee - "Homepage title for a fee"

condition_homepage_description

Article title not shown on the website's main page

Raw homepage condition description

condition_homepage_description_en

Article title not shown on the website’s main page

Explains homepage visibility — whether/how the article appears there

page_index

page-index-no

Whether the published article page is open to search engine indexing - object with aliases and name_en:

More

page-index-yes - "Page indexing allowed"
page-index-no - "Page indexing prevented"
page-index-possible - "Possible page indexing prevented"

condition_page_index_description_en

Page will be closed to search engine indexing

Explains search engine indexing policy

newsletter

without-newsletter

Whether the outlet distributes placed content to its email newsletter subscribers - object with aliases and name_en:

More

newsletter-to-the-subscribers - "Newsletter to subscribers"
without-newsletter - "No newsletter to subscribers"
newsletter-to-the-subscribers-paid - "Newsletter to subscribers for a fee"
newsletter-is-optional - "Newsletter is optional"

condition_newsletter_description_en

Included in the newsletter to the subscribers

Explains newsletter distribution details

socialnetwork

without-repost-in-social-nets

Whether the outlet reposts placed content on its social media accounts - object with aliases and name_en:

More

repost-in-social-nets - "Repost on social media"
without-repost-in-social-nets - "Without repost on social media"
repost-social-media-fee - "Repost on social media for a fee"
repost-in-social-nets-is-possible - "Repost on social media is possible"

condition_socialnetwork_description

Repost on social media for an additional fee

Lists which social platforms content gets reposted to

max_hyperlinks

5

Maximum number of hyperlinks allowed in the article

hyperlinks_type

nofollow

Whether the links in the article are dofollow or nofollow - object with aliases and name_en:

More

dofollow - "Dofollow hyperlinks"
nofollow - "Nofollow hyperlinks"
without-hyperlinks - "Without hyperlinks"
sponsored - "Sponsored hyperlinks"
dofollow-paid - "Dofollow hyperlinks for a fee"
sponsored-paid - "Sponsored hyperlinks for a fee"
hyperlinks-are-optional - "Hyperlinks are optional"

condition_max_hyperlinks_description

A redirect link

Explains hyperlink conditions and limits

max_images

7

Maximum number of images allowed in the article

condition_max_images_description

720 х 480 pixels. With a copyright approval

Explains image requirements (count, dimensions, format)

video

without-video

Whether the outlet accepts embedded video - object with aliases and name_en:

More

with-video - "With video"
without-video - "Without video"
with-video-fee - "With video for a fee"
video-is-optional - "Video is optional"

condition_video_description_en

MP4 format

Explains the video policy

tracking_pixel

tracking_pixel-no

Whether the outlet allows tracking pixels to be embedded in the placement - object with aliases and name_en:

More

tracking-pixel - "Tracking Pixel"
tracking_pixel-no - "❌ Tracking Pixel"
tracking_pixel-na - "❓ Tracking Pixel"

meta_tags

meta_tags-no

Whether custom meta tags (title, description for SEO) can be specified for the article - object with aliases and name_en:

More

meta-tags - "Meta Tags"
meta-tags-no - "❌ Meta Tags"
meta-tags-na - "❓ Meta Tags"

text_limit_type

1

Text length type
(0 - Characters,1 - Words)

text_limit

2000

Maximum text length (in characters or words)
0 means no limit

release_text_limit

10000

Maximum text length in characters
999999 means no limit

min_text_limit

500

Minimum text length (in characters or words)
0 means no limit

condition_release_text_limit_description_en

Recommended text size is up to 2000 characters

Explains text length limits

uniqtext

accept-any-text

Whether the article text must be unique/original — only-unique-text requires 90%+ originality - object with aliases and name_en:

More

only-unique-text - "Unique text only"
accept-any-text - "Unique text is not mandatory"

condition_uniqtext_description_en

Unique texts are not a mandatory provision

Explains the unique text requirement

text

changes-in-text-are-possible

Policy on whether text will be modified by publisher after submission - object with aliases and name_en:

More

text-without-changes - "Text without changes"
text-by-author - "Text by publisher"
changes-in-text-are-possible - "Possible text changes"
text-by-author-paid - "Text by publisher for a fee"

condition_text_description_en

Texts with possible changes

Explains the text modification policy

ad

with-adv-mark

How the placement is labeled - object with aliases and name_en:

More

with-adv-mark - "With ad label"
without-adv-mark - "Unlabeled Placement"
adv-mark-may-be-added - "Unlabeled is possible"
without-ad-label-fee- "Unlabeled for a fee"

condition_ad_description

Non-English / raw version of the ad label condition

condition_ad_description_en

With <em>Partner Content</em> label

Explains the advertisement labeling policy

several_languages

false

True if the outlet accepts articles in multiple languages, false if one language only

condition_severallanguages_description_en

The price includes a publication in one language only

Explains multi-language acceptance policy

publication

permanent-link

Whether the placement is permanent (stays up indefinitely) or temporary

condition_publication_description

The article link will be Archived and accessible only via a direct link or search...

Full explanation of publication permanence and refund policy

Sensitive Paramenters

Request parameter

Output

Description

alcohol

alcohol-no

Whether alcohol-related content is accepted - object with aliases and name_en:

More

alcohol - "Alcohol" (accepted)
alcohol-no - "❌ Alcohol" (not accepted)
alcohol-na - "❓Alcohol" (unknown)

gambling

gambling-no

Whether gambling-related content is accepted - object with aliases and name_en:

More

gambling - "Gambling" (allowed)
gambling-no - "❌ Gambling" (not allowed)
gambling-na - "❓Gambling" (unknown)

betting

betting-no

Whether sports betting / wagering content is accepted - object with aliases and name_en:

More

betting - "Betting" (allowed)
betting-no - "❌ Betting" (not allowed)
betting-na - "❓Betting" (unknown)

dating

dating-no

Whether dating/matchmaking content is accepted - object with aliases and name_en:

More

dating - "Dating" (allowed)
dating-no - "❌ Dating" (not allowed)
dating-na - "❓Dating" (unknown)

cbd

cbd-no

Whether CBD or hemp-related content is accepted - object with aliases and name_en:

More

cbd - "CBD" (allowed)
cbd-no - "❌ CBD" (not allowed)
cbd-na - "❓CBD" (unknown)

politics_news

politics-news-na

Whether political news content is accepted - object with aliases and name_en:

More

politics-news - "Politics News" (allowed)
politics-news-no - "❌ Politics News" (not allowed)
politics-news-na - "❓Politics News" (unknown)

adult

adult-no

Whether adult content is accepted - object with aliases and name_en:

More

adult - "Adult" (allowed)
adult-no - "❌ Adult" (not allowed)
adult-na - "❓Adult" (unknown)

trade

trade-no

Whether trading (financial instruments, forex, etc.) content is accepted - object with aliases and name_en:

More

trade - "Trading" (allowed)
trade-no - "❌ Trading" (not allowed)
trade-na - "❓Trading" (unknown)

crypto

crypto-no

Whether cryptocurrency content is accepted - object with aliases and name_en:

More

crypto - "Crypto" (allowed)
crypto-no - "❌ Crypto" (not allowed)
crypto-na - "❓Crypto" (unknown)

loans

loans

Whether loan/lending-related content is accepted - object with aliases and name_en:

More

loans - "Loans" (allowed)
loans-no - "❌ Loans" (not allowed)
loans-na - "❓Loans" (unknown)

smoking

smoking-no

Whether tobacco/smoking-related content is accepted - object with aliases and name_en:

More

smoking - "Smoking" (allowed)
smoking-no - "❌ Smoking" (not allowed)
smoking-na - "❓Smoking" (unknown)

medicine

medicine-na

Whether medical/pharmaceutical content is accepted - object with aliases and name_en:

More

medicine - "Medicine" (allowed)
medicine-no - "❌ Medicine" (not allowed)
medicine-na - "❓Medicine" (unknown

backdated

backdated-no

Whether the outlet allows flexible/backdated publication dates - object with aliases and name_en:

More

backdated - "Flexible Date"
backdated-no - "❌ Flexible Date"
backdated-na - "❓ Flexible Date"

Did this answer your question?