=== Keyword Research for Pinterest ===
Contributors: lalokupfer
Tags: pinterest, keyword research, pinterest seo, seo, blogging
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Research Pinterest keywords while you write: how hard a term is to rank for, how strong the pins already winning it are, and what to write instead.

== Description ==

You can write a post that Pinterest never shows anyone, and nothing tells you until months later.

This plugin puts the check where the writing happens. Type a keyword and you get what decides whether it is worth a post: how hard it is to rank for, judged by how strong the pins already winning it are, and which related keywords share the same audience.

**What you can see**

* Competition, in words — very low through very high, based on how strong the pins that already rank for the term are.
* Total saves, average saves per pin, and the best-performing pin's saves.
* Estimated outbound clicks, so you can tell a keyword that drives traffic from one that only collects saves.
* An opportunity score — demand weighed against how many pins already compete.
* The three pins currently winning the keyword, with their saves, and three keywords that rank on the same pins.
* The niche Pinterest associates the keyword with.
* Pins analysed — how many pins the verdict rests on.

**Every one of those is on the free plan.** The paid plans are about volume, not
about unlocking numbers: 5,000 lookups a month instead of 15, up to 50 keywords in
one batch, the full pin and related lists (50 apiece, with rank and overlap) rather
than three, and demand history — how the saves on a keyword's pins move day by day.

**Where it works**

* A full research screen under **Pinterest Keywords**.
* A panel in the post editor, pre-filled with your post title, so you can check a heading without leaving the draft.
* Both the block editor and the classic editor.

**It does not spend a lookup when it has nothing to tell you**

If we have no data for a keyword, the search is free and we show you the closest keywords we do have. Coverage is uneven — we know more about some niches than others — and charging you for an empty answer would be charging you for our gap. Where we have too few pins to judge a keyword honestly we say "not enough data" rather than guessing at a rating.

**Repeat lookups are free too.** A keyword you have already researched is cached on your own site, so checking it again, or another author checking the same term next week, costs nothing.

**Works on the free plan**

Nothing in this plugin is locked, time-limited, or waiting for an upgrade. A free PinPinterest account includes **15 keyword lookups a month**, for as long as you have the account, and every feature of the plugin works on it — including every metric. Paid plans raise the monthly allowance and add batch lookups, the full pin and related lists, and demand history. See [pinpinterest.com/pricing](https://pinpinterest.com/pricing).

**It never touches your public site**

There is no front-end code in this plugin at all. It adds nothing to your pages, changes no markup, and cannot slow a visitor down. Everything happens inside wp-admin.

**Your Pinterest account stays out of it**

The plugin does not connect to Pinterest and never asks for your Pinterest login. The data comes from PinPinterest, which analyses public Pinterest search results.

== External services ==

This plugin is a client for **PinPinterest**, a Pinterest keyword research service at [https://pinpinterest.com](https://pinpinterest.com). The plugin cannot work without it: the keyword statistics are produced by PinPinterest's own analysis of public Pinterest search results, and WordPress has no way to obtain them on its own.

**When it contacts the service:** only when a logged-in editor asks for a keyword, or when an administrator opens the settings screen and presses "Check connection". Nothing is sent when a visitor views your site, and nothing is sent on a schedule.

**What is sent:** the keyword being researched; your API key, for authentication; your site address and the plugin version, in two headers, so that the account owner can see on their own dashboard which site is using which key. No post content, no user accounts, no visitor data, and no personal information are ever transmitted.

**What is stored:** your API key and settings, in your site's options table, plus keyword results cached as transients. Deleting the plugin removes all of it.

Service terms: [https://pinpinterest.com/terms](https://pinpinterest.com/terms)
Privacy policy: [https://pinpinterest.com/privacy](https://pinpinterest.com/privacy)

== Installation ==

1. Install and activate the plugin.
2. Create a free account at [pinpinterest.com](https://pinpinterest.com), open the **API** tab and press **Create key**.
3. Copy the key — it is shown once — and paste it into **Pinterest Keywords → Settings** in WordPress.
4. Press **Check connection** to confirm, then start researching.

== Frequently Asked Questions ==

= Do I need a paid account? =

No. A free PinPinterest account includes 15 keyword lookups a month and never expires, and every metric this plugin shows is on it. Paid plans are about volume: 5,000 lookups a month, batches of up to 50 keywords, the full pin and related lists instead of three apiece, and demand history.

= Does this post to Pinterest or schedule pins? =

No. This plugin is research only. It reads keyword statistics and does not publish anything anywhere.

= Do I have to connect my Pinterest account? =

No, and you cannot. The plugin never asks for your Pinterest credentials. The statistics come from public Pinterest search results analysed by PinPinterest.

= What happens when I run out of lookups? =

The plugin tells you how many you have left and when they reset — the first of each month. Keywords you already researched stay readable from your site's cache, and searches that find no data never counted in the first place.

= Why does it say there is no data for my keyword? =

Coverage is uneven: some niches are researched far more deeply than others. When we have nothing for a term we say so, suggest the closest keywords we do have, and do not count the search against your allowance.

= Can my authors use it, or only administrators? =

By default anyone who can edit posts can research keywords. Because lookups come from one allowance shared by the whole site, an administrator can restrict this to authors or to administrators only, in Settings.

= Does it slow my site down? =

No. The plugin has no front-end code whatsoever — it adds nothing to any page a visitor sees.

= Where does the data come from? =

PinPinterest crawls public Pinterest search results and aggregates the statistics. Nothing is scraped from your site, and no private Pinterest data is involved.

== Screenshots ==

1. The research screen — the verdict, the numbers behind it, and the pins already winning the keyword.
2. The panel in the post editor, pre-filled with the post title so you can check a heading without leaving the draft.
3. A keyword we have no data for: the search is free, and the closest keywords we do have are offered instead.
4. Settings — paste your API key, choose who may spend the site's monthly allowance, and set how long results are cached.

== Changelog ==

= 1.0.1 =
* First public release.
* Every metric is on the free plan: competition, total and average saves, the best-performing pin, estimated outbound clicks, opportunity score, the three pins winning the keyword and three keywords ranking on the same pins. Paid plans differ by volume, not by which numbers you are allowed to see.
* "Competing pins" is now "Pins analysed" — it is how many pins were sampled for the term, not a count of Pinterest's inventory, and the old label overstated it by orders of magnitude.
* A keyword with too few pins to judge honestly now says "not enough data" instead of guessing at a rating.
* Pin thumbnails are requested with no referrer, so the address of your admin screen is never handed to Pinterest.

= 1.0.0 =
* Submitted for review. Never published.

== Upgrade Notice ==

= 1.0.1 =
First public release.
