PinterestBot
Pinterest •
Since 2012
Quick Actions
Official Docs
What is PinterestBot?
Pinterestbot is Pinterest's web crawler that enables Rich Pins - enhanced pins that automatically sync information from websites. The bot crawls websites to extract metadata for different types of Rich Pins including Product Pins (with real-time pricing), Recipe Pins (with ingredients and cooking times), and Article Pins (with headlines and authors). For e-commerce sites and content creators, Pinterestbot is crucial as Pinterest drives significant purchase-intent traffic. The crawler reads structured data and meta tags to keep Pin information updated automatically, making it essential for businesses leveraging Pinterest for marketing.
User Agent String
Mozilla/5.0 (compatible; Pinterestbot/1.0; +http://www.pinterest.com/bot.html)
How to Control PinterestBot
Block Completely
To prevent PinterestBot from accessing your entire website, add this to your robots.txt file:
# Block PinterestBot
User-agent: Pinterestbot
Disallow: /
Block Specific Directories
To restrict access to certain parts of your site while allowing others:
User-agent: Pinterestbot
Disallow: /admin/
Disallow: /private/
Disallow: /wp-admin/
Allow: /public/
Set Crawl Delay
To slow down the crawl rate (note: not all bots respect this directive):
User-agent: Pinterestbot
Crawl-delay: 10
How to Verify PinterestBot
Verification Method:
Use Pinterest's Rich Pins Validator
Use Pinterest's Rich Pins Validator
Learn more in the official documentation.
Detection Patterns
Multiple ways to detect PinterestBot in your application:
Basic Pattern
/PinterestBot/i
Strict Pattern
/^Mozilla/5\.0 \(compatible; Pinterestbot/1\.0; \+http\://www\.pinterest\.com/bot\.html\)$/
Flexible Pattern
/PinterestBot[\s\/]?[\d\.]*?/i
Vendor Match
/.*Pinterest.*PinterestBot/i
Implementation Examples
// PHP Detection for PinterestBot
function detect_pinterestbot() {
$user_agent = $_SERVER['HTTP_USER_AGENT'] ?? '';
$pattern = '/PinterestBot/i';
if (preg_match($pattern, $user_agent)) {
// Log the detection
error_log('PinterestBot detected from IP: ' . $_SERVER['REMOTE_ADDR']);
// Set cache headers
header('Cache-Control: public, max-age=3600');
header('X-Robots-Tag: noarchive');
// Optional: Serve cached version
if (file_exists('cache/' . md5($_SERVER['REQUEST_URI']) . '.html')) {
readfile('cache/' . md5($_SERVER['REQUEST_URI']) . '.html');
exit;
}
return true;
}
return false;
}
# Python/Flask Detection for PinterestBot
import re
from flask import request, make_response
def detect_pinterestbot():
user_agent = request.headers.get('User-Agent', '')
pattern = r'PinterestBot'
if re.search(pattern, user_agent, re.IGNORECASE):
# Create response with caching
response = make_response()
response.headers['Cache-Control'] = 'public, max-age=3600'
response.headers['X-Robots-Tag'] = 'noarchive'
return True
return False
# Django Middleware
class PinterestBotMiddleware:
def __init__(self, get_response):
self.get_response = get_response
def __call__(self, request):
if self.detect_bot(request):
# Handle bot traffic
pass
return self.get_response(request)
// JavaScript/Node.js Detection for PinterestBot
const express = require('express');
const app = express();
// Middleware to detect PinterestBot
function detectPinterestBot(req, res, next) {
const userAgent = req.headers['user-agent'] || '';
const pattern = /PinterestBot/i;
if (pattern.test(userAgent)) {
// Log bot detection
console.log('PinterestBot detected from IP:', req.ip);
// Set cache headers
res.set({
'Cache-Control': 'public, max-age=3600',
'X-Robots-Tag': 'noarchive'
});
// Mark request as bot
req.isBot = true;
req.botName = 'PinterestBot';
}
next();
}
app.use(detectPinterestBot);
# Apache .htaccess rules for PinterestBot
# Block completely
RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} PinterestBot [NC]
RewriteRule .* - [F,L]
# Or redirect to a static version
RewriteCond %{HTTP_USER_AGENT} PinterestBot [NC]
RewriteCond %{REQUEST_URI} !^/static/
RewriteRule ^(.*)$ /static/$1 [L]
# Or set environment variable for PHP
SetEnvIfNoCase User-Agent "PinterestBot" is_bot=1
# Add cache headers for this bot
<If "%{HTTP_USER_AGENT} =~ /PinterestBot/i">
Header set Cache-Control "public, max-age=3600"
Header set X-Robots-Tag "noarchive"
</If>
# Nginx configuration for PinterestBot
# Map user agent to variable
map $http_user_agent $is_pinterestbot {
default 0;
~*PinterestBot 1;
}
server {
# Block the bot completely
if ($is_pinterestbot) {
return 403;
}
# Or serve cached content
location / {
if ($is_pinterestbot) {
root /var/www/cached;
try_files $uri $uri.html $uri/index.html @backend;
}
try_files $uri @backend;
}
# Add headers for bot requests
location @backend {
if ($is_pinterestbot) {
add_header Cache-Control "public, max-age=3600";
add_header X-Robots-Tag "noarchive";
}
proxy_pass http://backend;
}
}
Should You Block This Bot?
Recommendations based on your website type:
| Site Type | Recommendation | Reasoning |
|---|---|---|
| E-commerce | Optional | Evaluate based on bandwidth usage vs. benefits |
| Blog/News | Allow | Increases content reach and discoverability |
| SaaS Application | Block | No benefit for application interfaces; preserve resources |
| Documentation | Selective | Allow for public docs, block for internal docs |
| Corporate Site | Limit | Allow for public pages, block sensitive areas like intranets |
Advanced robots.txt Configurations
E-commerce Site Configuration
User-agent: Pinterestbot
Crawl-delay: 5
Disallow: /cart/
Disallow: /checkout/
Disallow: /my-account/
Disallow: /api/
Disallow: /*?sort=
Disallow: /*?filter=
Disallow: /*&page=
Allow: /products/
Allow: /categories/
Sitemap: https://example.com/sitemap.xml
Publishing/Blog Configuration
User-agent: Pinterestbot
Crawl-delay: 10
Disallow: /wp-admin/
Disallow: /drafts/
Disallow: /preview/
Disallow: /*?replytocom=
Allow: /
SaaS/Application Configuration
User-agent: Pinterestbot
Disallow: /app/
Disallow: /api/
Disallow: /dashboard/
Disallow: /settings/
Allow: /
Allow: /pricing/
Allow: /features/
Allow: /docs/
Quick Reference
User Agent Match
PinterestBot
Robots.txt Name
Pinterestbot
Category
social
Respects robots.txt
Yes
Copied to clipboard!