Docs / Other
Medialister API
How to get and use Medialister API to get our media database
How to Get Access to Medialister API
Contact us via [email protected] and we will get to you as soon as possible to clarify the details.
After, we will provide you with an API key.
How to Use Medialister API
Here is a Postman documentation to use:
{
"info": {"_postman_id": "033a0297-b4dc-4cdc-8dda-54dadbd9598b","name": "Medialister API","schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json","_exporter_id": "6960664","_collection_link": "https://dark-satellite-733361.postman.co/workspace/My-Workspace~a8a6af31-f68d-474d-80d8-e5431c8ecbd8/collection/6960664-033a0297-b4dc-4cdc-8dda-54dadbd9598b?action=share&source=collection_link&creator=6960664"
},
"item": [{
"name": "List offers",
"request": {
"auth": {
"type": "apikey",
"apikey": [
{
"key": "value",
"value": "{{apikey}}",
"type": "string"
},
{
"key": "key",
"value": "apikey",
"type": "string"
}
]
},
"method": "GET",
"header": [],
"url": {
"raw": "{{endpoint}}/api/offers",
"host": [
"{{endpoint}}"
],
"path": [
"api",
"offers"
]
}
},
"response": []}
],
"event": [{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"packages": {},
"requests": {},
"exec": [
""
]
}},{
"listen": "test",
"script": {
"type": "text/javascript",
"packages": {},
"requests": {},
"exec": [
""
]
}}
],
"variable": [{
"key": "endpoint",
"value": ""},{
"key": "apikey",
"value": ""}
]}
Or you can do this in your console:
curl https://api.medialister.com/api/offers \
-H 'apikey: {apikey here}'How an API Response Looks Like
{
"@context": "/api/contexts/Format",
"@id": "/api/offers",
"@type": "hydra:Collection",
"hydra:totalItems": 108125,
"hydra:member": [
{
"@id": "/api/formats/7a0088a6-2945-48be-9317-e381131c56fd",
"@type": "Format",
"id": "7a0088a6-2945-48be-9317-e381131c56fd",
"formatType": {
"@id": "/api/format_types/1b04f264-8bd8-48a0-9fac-ac97bf801ce3",
"@type": "FormatType",
"name": "Article"
},
"mediaProject": {
"@id": "/api/media_projects/26bb8dbe-e141-4bfd-82af-1a3fc36a37ab",
"@type": "MediaProject",
"website": "https://www.citizen.co.za"
},
"price": "214.84",
"urlExamples": [
"www.citizen.co.za/south-coast-herald/news-headlines/advertorial/2024/01/12/mobile-gambling-experience-in-south-africa-a-game-changer-for-casino-enthusiasts/"
],
"seoMetric": {
"@id": "/api/seo_metrics/latest_media_metrics",
"@type": "SeoMetric",
"audience": 7932373,
"audienceSourceDirect": 275452,
"audienceSourceReferrals": 18052,
"audienceSourceSearch": 264048,
"audienceSourceSocial": 51026,
"sourceDirect": 44.99,
"sourceReferrals": 2.95,
"sourceSearch": 43.12,
"sourceSocial": 8.33,
"sourceDisplay": 0.54,
"sourceMail": 0.07,
"ahrefsDr": 76,
"organicTrafficByAhrefs": 445727,
"estimatedViews": 5870,
"leadingCountries": {
"South Africa": 7525046,
"India": 67723,
"Ethiopia": 50121,
"United States of America": 40975,
"United Kingdom": 27717
},
"bounceRate": 0.38635,
"timeOnSite": 56.9112,
"pagePerVisit": 1.84471,
"mai": 37,
"visits": []
}
}, {.....}, {...}How to get a Link to Medialister Marketplace Offer
Take the format ID and put it into this URL:
https://app.medialister.com/media/{format_id}Offers API Response Reference
Collection Metadata
Field | Description |
|---|---|
| JSON-LD context path for the resource type |
| Canonical URI of this collection |
| Always |
| Total number of offers across all pages |
| Array of individual offer objects |
Offer Object
Field | Description |
|---|---|
| Canonical URI of this offer |
| Always |
| UUID of the offer |
| Publication format: Article, Press Release, Contributor Post, Guest Post, Interview, Paid News, or Mention |
| Domain of the publisher's media website |
| Marketplace offer price (in USD) |
| Example URLs of previously published placements on this media |
SEO Metrics (seoMetric)
Audience & Traffic Volume
Field | Description |
|---|---|
| Estimated total monthly visits (from SimilarWeb) |
| Monthly visits from direct traffic (absolute) |
| Monthly visits from referral sources (absolute) |
| Monthly visits from search engines (absolute) |
| Monthly visits from social media (absolute) |
Traffic Source Breakdown (%)
Field | Description |
|---|---|
| Share of direct traffic, % |
| Share of referral traffic, % |
| Share of search traffic, % |
| Share of social traffic, % |
| Share of display ad traffic, % |
| Share of email traffic, % |
SEO Authority
Field | Description |
|---|---|
| Ahrefs Domain Rating (0–100). Measures backlink authority. Higher is better. |
| Estimated monthly organic search visitors according to Ahrefs |
Engagement
Field | Description |
|---|---|
| Share of sessions where users left without any interaction (0–1 scale, lower is better) |
| Average session duration in seconds |
| Average number of pages viewed per session |
| Historical visit data array (may be empty if not yet populated) |
Placement & Attention Metrics
Field | Description |
|---|---|
| Estimated views a single placement is likely to receive, calculated from monthly traffic with format-specific coefficients |
| Medialister Attention Index—a proprietary metric measuring reader attention quality on this media in days (higher is better). Refer to https://roadmap.medialister.com/docs/marketplace/medialister-attention-index-mai |
Audience Geography
Field | Description |
|---|---|
| Top countries by audience volume. Keys are country names, values are estimated monthly visitor counts from each country. |
Was this helpful?