=== Media List Journalist Search ===
Contributors: medialist
Tags: journalists, media list, pr, press, podcast
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Search journalists, editors, producers, podcast hosts and creators from your Media List account, right inside WordPress.

== Description ==

Media List Journalist Search connects your WordPress admin to your [Media List](https://medialist.com) account. Find the right people to pitch without leaving WordPress.

* **Search contacts** by keywords, title, outlet, city, US state, media type and topic.
* **Browse your saved lists** and the contacts in each one.
* **See your account**: plan, exports left today and API limits.

The plugin only reads data. It never changes anything in your Media List account. Emails show only when they are already unlocked in your Media List account.

A Media List API key is required. API keys come with paid Media List plans, see [Media List pricing](https://medialist.com/pricing).

== External services ==

This plugin connects to the Media List API (https://medialist.com/api/v1), a service run by Media List, to search contacts and read your saved lists and account details.

* **When:** only when a logged-in user opens one of the plugin's admin pages (Search contacts, Saved lists, Account) or saves an API key in the plugin settings.
* **What is sent:** your Media List API key (in the Authorization header), the search terms and filters you enter, list IDs you open, and the WordPress site address in the User-Agent header. No visitor data and no WordPress content are sent.
* **Service:** Media List, https://medialist.com
* **Terms of service:** https://medialist.com/terms
* **Privacy policy:** https://medialist.com/privacy

== Installation ==

1. Install and activate the plugin.
2. Go to **Media List > Settings** and paste your Media List API key. The key is checked against your account when you save it.
3. Open **Media List > Search contacts** and run a search.

== Frequently Asked Questions ==

= Where do I get an API key? =

API keys come with paid Media List plans. Request one at https://medialist.com/developers.

= Can the plugin unlock emails or send campaigns? =

No. The plugin is read-only. Unlocking emails and sending campaigns happen in the Media List app.

= Who can use it? =

Users who can edit posts can search and view lists. Only administrators can add or change the API key.

= What happens when I delete the plugin? =

The saved API key and cached filter values are removed.

== Screenshots ==

1. Search journalists and creators by keywords and filters.
2. Browse your saved lists.
3. Settings: connect your Media List API key.

== Changelog ==

= 1.0.0 =
* First release: contact search, saved lists, account page and settings.

== Upgrade Notice ==

= 1.0.0 =
First release.
