You can get access to our extensive media database via API. Our API is based on Elasatic API. For more information on how to use it, check this link:
How to Get an API Key and the Host Data
To get access to PRNEWS.IO's API, you need to have an active yearly plan for the PRO subscription: https://prnews.io/get/pro/. After you have it, you will get your API key to the email address with the host data to get access to our Elastic server API.
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 requests. But you can also get multiple media in one response with the paginated search requests.
Response Parameters
Text parameters also have localized versions in responses.
Parameter | Description |
name_en | The English name of a media |
audience | Total number of visitors |
id | Unique identifier for the media format |
cost | The cost associated with the placement or service in USD |
max_hyperlinks | Maximum number of hyperlinks allowed |
audience_source_search | Audience sourced from search engines |
audience_source_referrals | Audience sourced from referral websites |
audience_source_direct | Audience sourced directly |
audience_source_social | Audience sourced from social media platforms |
page_per_visit | Average number of pages viewed per visit |
lead_times | How many hours it takes to publish an article |
meta_tags | permission=1 if meta tags are allowed |
estimated_views | Estimated number of views the placement is expected to generate |
alexaTrafRank | Alexa traffic ranking of the media |
country | Country information |
language | Primary language of the placement |
main_category | Main category of the placement |
category | Sub-category information |
seo_url | SEO-friendly URL associated with the item |
visits | Total visits the media has received the last month |
city | City information |
trust_rank | Trust rank of the media |
release_text_limit | The text size in symbols (unlimited if 99,999) |
news_aggregator | Points out if the published content will be broadcasted tonews aggregators |
type | Type of media |
condition_publication_place_description_en | Description where the publication will be placed |
condition_homepage_description_en | Homepage condition description |
condition_ad_description_en | Advertisement condition description |
condition_text_description_en | Text condition description |
release_text_limit | Maximum limit for placement in symbols |
backdated | Indicates if the placement can be backdated |
bounce_rate | The rate at which visitors leave the media website after viewing only one page |
time_on_site | Average time spent on the media website by visitors |
max_images | Maximum number of images allowed |
country_audience | Audience details for specific countries |
source_referrals | Source referral rate or value |
source_search | Source search rate or value |
source_social | Source social rate or value |
source_direct | Source direct rate or value |
format_type | Format type of the placement |
homepage | Homepage information |
moz_domain_authority | Domain authority, as rated by Moz |
ahrefs_dr | Domain rating as rated by Ahrefs |
mj_tf | Majestic Trust Flow score |
mj_cf | Majestic Citation Flow score |
video | Information on video availability |
alcohol | Indicates if alcohol-related content is allowed |
gambling | Indicates if gambling-related content is allowed |
dating | Indicates if dating-related content is allowed |
politics_news | Indicates if political news content is allowed |
cbd | Indicates if CBD-related content is mentioned |
text | Text information |
ad | Advertisement details such as 'with ad label' |
page_index | Indicates if page indexing is allowed |
tracking_pixel | Indicates if tracking pixels are allowed |
uniqtext | Indicates if unique text is mandatory |
socialnetwork | Indicates social network repost status |
condition_ad_description | Additional conditions for advertising descriptions |
condition_publication_description | Additional conditions for publication descriptions |
condition_max_images_description | Additional conditions for maximum images descriptions |
condition_homepage_description | Additional conditions for homepage descriptions |
condition_text_description | Additional conditions for text descriptions |
condition_max_hyperlinks_description | Additional conditions for maximum hyperlinks descriptions |
condition_socialnetwork_description | Additional conditions for social network descriptions |
publication | Indicates the permanent placement status |
hyperlinks_type | Type of hyperlinks allowed |
extra_features | Additional features |
base_options | Additional offers provided for this placement |
country_region | Region details with different country aliases and translations |
condition_max_images_description | Additional conditions for maximum images descriptions |
condition_socialnetwork_description | Additional conditions for social network descriptions |
description | General description of the placement |
ahrefs_positions_metrics_traffic | Ahrefs traffic metrics for the positions |
doc_updated_at | The last time a format was updated (metrics, price, conditions, or any other data) |
deleted_after | When a format was removed from the marketplace |