Pinterest

api.pinterest.com

Community

Pinterest is a visual discovery and bookmarking platform where users save and organize ideas as pins on boards. The API allows agents to create and manage pins and boards, retrieve user account data, and access analytics for content performance.

Auth

oauth2

Pricing

free

Spec version

1.0

Base URL

https://api.pinterest.com

Last verified

2026-03-01 11:54:25

Health

Loading health data...

Capabilities

create_board

Create a new board for the authenticated user with a name, description, and privacy setting.

Detail: https://api.pinterest.com/capabilities/create_board

create_pin

Create a new pin on a specified board with an image URL, title, description, and optional destination link.

Detail: https://api.pinterest.com/capabilities/create_pin

get_pin

Retrieve detailed information about a specific pin including its image, description, board, and engagement metrics.

Detail: https://api.pinterest.com/capabilities/get_pin

get_user_account

Retrieve the authenticated user's Pinterest profile including username, bio, follower count, and website URL.

Detail: https://api.pinterest.com/capabilities/get_user_account

list_board_pins

Retrieve a paginated list of all pins saved to a specific board.

Detail: https://api.pinterest.com/capabilities/list_board_pins

list_boards

Fetch a paginated list of boards owned by the authenticated user, including board name, description, and pin count.

Detail: https://api.pinterest.com/capabilities/list_boards

search_pins

Search for pins matching a query string, with optional filters for media type and sorting.

Detail: https://api.pinterest.com/capabilities/search_pins

Agent Preview

This is what an AI agent sees when it discovers this service via the Gateway:

Service: Pinterest
Description: Pinterest is a visual discovery and bookmarking platform where users save and organize ideas as pins on boards. The API allows agents to create and manage pins and boards, retrieve user account data, and access analytics for content performance.
Auth: oauth2
Capabilities:
  - create_board: Create a new board for the authenticated user with a name, description, and privacy setting.
  - create_pin: Create a new pin on a specified board with an image URL, title, description, and optional destination link.
  - get_pin: Retrieve detailed information about a specific pin including its image, description, board, and engagement metrics.
  - get_user_account: Retrieve the authenticated user's Pinterest profile including username, bio, follower count, and website URL.
  - list_board_pins: Retrieve a paginated list of all pins saved to a specific board.
  - list_boards: Fetch a paginated list of boards owned by the authenticated user, including board name, description, and pin count.
  - search_pins: Search for pins matching a query string, with optional filters for media type and sorting.