​
Overview

The Pinterest API Suite offers multiple types of APIs, each designed for specific data collection needs from Pinterest. Below is an overview of how these APIs connect and interact, based on the available features:

Profiles API

This API allows users to collect profile details based on a single input: profile URL.
  •   Discovery functionality:
  •   Discover by Keywords.

  •   Interesting Columns:
  •   name, following_count, website, follower_count.

Posts API

This API allows users to collect multiple posts based on a single input.
  •   Discovery functionality:
    •   - Discover by profile URL.
    •   - Discover by Keywords.

  •   Interesting Columns:
  •   title, content, user_name, likes.

​
Profiles API

​
Collect by URL

This API allows users to retrieve detailed Pinterest profile information using the provided profile URL. Input Parameters:
​
URL
string
required
The Pinterest profile URL.
Output Structure:
Includes comprehensive data points:
  • Profile Details:
    url, profile_picture, name, nickname, website, bio, country_code, profile_id.
    For all data points, click here.
  • Engagement & Metrics:
    following_count, follower_count, boards_num, saved.
  • Additional Information:
    last_updated, posts_page_url, discovery_input.
This API allows users to collect detailed insights into a Pinterest profile, including user statistics, engagement metrics, and profile information.

​
Discover by Keywords

This API allows users to discover Pinterest profiles based on a specified keyword. Input Parameters:
​
keyword
string
required
The keyword to search for profiles.
Output Structure:
Includes comprehensive data points:
  • Profile Details:
    url, profile_picture, name, nickname, website, bio, country_code, profile_id.
    For all data points, click here.
  • Engagement & Metrics:
    following_count, follower_count, boards_num, saved.
  • Additional Information:
    last_updated, posts_page_url, discovery_input.
This API enables users to find Pinterest profiles related to a specific keyword, offering insights into user statistics, engagement, and profile details.

​
Posts API

​
Collect by URL

This API allows users to collect detailed post data from a specific Pinterest post using the provided post URL. Input Parameters:
​
URL
string
required
The Pinterest post URL.
Output Structure:
Includes comprehensive data points:
  • Post Details:
    url, post_id, title, content, date_posted, post_type.
    For all data points, click here.
  • User Details:
    user_name, user_url, user_id, followers.
  • Post Metrics:
    likes, comments_num, comments, categories.
  • Media & Attachments:
    image_video_url, video_length, attached_files.
  • Hashtags & Discovery:
    hashtags, discovery_input.
This API allows users to retrieve detailed insights into a specific Pinterest post, including user engagement, post content, media, and other related information.

​
Discover by Profile URL

This API allows users to retrieve posts from a specific Pinterest profile based on the provided profile URL. Input Parameters:
​
URL
string
required
The Pinterest profile URL from which to collect posts.
​
num_of_posts
number
The number of posts to collect. If omitted, there is no limit.
​
posts_to_not_include
array
An array of post IDs to exclude from the results.
​
start_date
string
Start date for filtering posts in MM-DD-YYYY format (should be earlier than end_date).
​
end_date
string
End date for filtering posts in MM-DD-YYYY format (should be later than start_date).
Output Structure:
Includes comprehensive data points:
  • Post Details:
    url, post_id, title, content, date_posted, user_name, user_url, user_id, followers, likes, categories, source, attached_files, image_video_url, video_length, hashtags, comments_num, comments, post_type.
    For all data points, click here.
  • Engagement & Metrics:
    followers, likes, comments_num.
  • Media & Attachments:
    image_video_url, video_length, attached_files.
  • Additional Information:
    discovery_input.
This API enables users tso collect posts from a specific Pinterest profile, allowing for filtering by date, exclusion of specific posts, and retrieval of detailed post data including media, comments, and engagement metrics.

​
Discover by Keywords

This API allows users to discover Pinterest posts based on a specific keyword, enabling efficient content discovery. Input Parameters:
​
keyword
string
required
The keyword to search for posts, such as “food” or any other relevant term.
Output Structure:
Includes comprehensive data points:
  • Post Details:
    url, post_id, title, content, date_posted, user_name, user_url, user_id, followers, likes, categories, source, attached_files, image_video_url, video_length, hashtags, comments_num, comments, post_type.
    For all data points, click here.
  • Engagement & Metrics:
    followers, likes, comments_num.
  • Media & Attachments:
    image_video_url, video_length, attached_files.
  • Additional Information:
    discovery_input.
This API enables users to search for Pinterest posts based on a specific keyword, providing detailed insights into the content, engagement, media, and associated metrics for efficient discovery.