On This Page

Meet the Medialister API: A Media Placement API for Platforms, Agencies and AI Agents

Share to

Meet the Medialister API: A Media Placement API for Platforms, Agencies and AI Agents

Share to

Written by

Alexander Storozhuk

Founder & Board Member at PRNEWS.IO, content marketing platform helping brands be mentioned in online media. Official Member at Forbes Business Council

Meet the Medialister API: A Media Placement API for Platforms, Agencies and AI Agents

On This Page

The Medialister API is now available. It is a media placement API that opens our marketplace of more than 100,000 publisher offers to other software. SEO platforms, marketing tools, agencies and AI agents can now search publishers, build campaigns, check out and manage orders from inside their own products, without sending users to a separate dashboard.

For small and midsize businesses, this means one thing: you can place branded content in a cost-effective, predictable and convenient way, right inside the tools you already use.

On This Page

  • Why we built the Medialister API

  • What the media placement API can do

  • Built for white-label and embedded workflows

  • Why strict validation matters for AI agents

  • API or MCP: which one do you need?

  • How to get access

Why We Built the Medialister API

Buying sponsored articles, press releases, and guest posts has long been slow and manual. Every publisher sets its own prices, formats, turnaround times and editorial rules. Most deals still happen over email, with spreadsheets to track them.

Our marketplace already fixed a big part of that. Prices, formats and turnaround times are visible before you buy, and every order is tracked through publication.

But many of our clients don't start their work in Medialister. They start in an SEO platform that shows content gaps, an AI-visibility tool that shows where a brand is missing from AI answers, or a planning tool that sets the marketing budget. Then they leave that tool to buy the placement.

The API removes that extra step. The tool that finds the opportunity can now book it.

"Editorial media has always been sold one email at a time. Our marketplace made it searchable and comparable. The API makes it infrastructure. Our partners keep the customer relationship and the interface. Medialister handles the publisher network, pricing and order workflow behind it."
— Tim Sedov, Head of Product Medialister

What the Media Placement API Can Do

The Medialister API covers the full buying cycle, not just catalog lookups.

Catalog search and discovery. Filter publisher offers by:

  • Format type, including Articles, Press Releases, Guest Posts, Contributor Posts, Interviews and Paid News

  • Media type, category, outlet location and audience country

  • Language and accepted sensitive topics, such as crypto or gambling

  • Price range, audience size and turnaround time

  • SEO metrics, including Ahrefs Domain Rating and Semrush organic traffic

  • Hyperlink type and number of links allowed

  • Placement conditions, such as permanent placement or homepage announcement

You can also check up to 200 domains in a single request to see which publishers have offers available.

Publisher metrics. Each offer returns its price, format, languages and example placements, along with outlet data: traffic sources, engagement, audience geography, estimated views per placement and the Medialister Attention Index (MAI), our metric for reader attention on an outlet.

Projects, campaigns and cart. Create projects and campaigns, add offers to a cart one by one or in batches, and check out against your account balance.

Orders and content. Track order status, submit and update content, set publication dates, accept publisher conditions, approve or reject link placements and cancel orders.

Publisher communication. Send and read order messages, so editorial back-and-forth can appear inside your own interface.

Start Using Medialister Now

Sign up and get access now

Here is what a simple request looks like. This one asks for fast, permanent placements in the United States and the United Kingdom:


textcurl "https://api.medialister.com/api/offers?location=United States,United Kingdom&turnAroundTimeMax=3&permanentPlacement=true&sortBy=turnAroundTime&sortOrder=asc" \
  -H "apikey: YOUR_API_KEY"
textcurl "https://api.medialister.com/api/offers?location=United States,United Kingdom&turnAroundTimeMax=3&permanentPlacement=true&sortBy=turnAroundTime&sortOrder=asc" \
  -H "apikey: YOUR_API_KEY"
textcurl "https://api.medialister.com/api/offers?location=United States,United Kingdom&turnAroundTimeMax=3&permanentPlacement=true&sortBy=turnAroundTime&sortOrder=asc" \
  -H "apikey: YOUR_API_KEY"

Built for White-Label and Embedded Workflows

Some partners want to offer media placements to their own customers under their own brand. The API supports this with dedicated checkout and messaging endpoints that let a platform place orders and run publisher conversations on behalf of its end customers.

This opens up a few practical use cases:

  • SEO and AI-visibility platforms can turn a coverage gap into a list of specific publishers with prices, and then into a booked placement.

  • Marketing and business planning tools can use real media prices and turnaround times in budgets and campaign plans.

  • Software for SMBs can give customers a simple, self-serve way to get published in relevant media.

  • Agencies and resellers can run placements for many clients from their own systems.

[OPTIONAL, requires partner approval: Two platforms, Maintouch and X8it, are already integrating the Medialister API.]

Why Strict Validation Matters for AI Agents

When a person searches a catalog, they notice if the results look wrong. An AI agent building a media plan may not.

That's why the Medialister API checks every request strictly. If a filter value is misspelled, such as an incorrect country name, or a parameter isn't recognized, the API returns an error that names the problem. It never quietly returns a wider set of results than you asked for.

For teams building agents, this means fewer surprises. The agent either gets exactly the slice of the catalog it requested, or it gets a clear message about what to fix.

API or MCP: Which One Do You Need?

Medialister now offers two ways for software to work with the marketplace.


Medialister MCP Server

Medialister API

Best for

Marketers working in an AI assistant

Developers building Medialister into their own product

How it works

Connect Claude, ChatGPT, Gemini CLI or another MCP client to https://api.medialister.com/mcp

REST requests to https://api.medialister.com with an API key

Who signs in

You, with your Medialister account

Your application, with its API key

Checkout

Finalized in the Medialister app

Available through the API

White-label use

No

Yes


If you want to plan campaigns in a chat window, start with the Medialister MCP server. If you want media buying to happen inside your own software, use the API.

How to Get Access

The Medialister API is available now. Full documentation is published at api.medialister.com/docs, with a practical guide in the Medialister Help Center.

To request an API key, contact our team at support@medialister.com. We'll discuss your use case and send the details you need to start building.

Start Using Medialister Now

Sign up and get access now