pinterest-api

Automate Pinterest API v5 authentication and pin and board management.

40|7|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/rawveg/skillsforge-marketplace --skill pinterest-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pinterest-api
Source: https://github.com/rawveg/skillsforge-marketplace/tree/main/pinterest-api
Command: npx skills add https://github.com/rawveg/skillsforge-marketplace --skill pinterest-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you build integrations with Pinterest API v5, including OAuth authentication, pin/board management, analytics, and ad account usage.

Core Features & Use Cases

  • OAuth 2.0 Authentication: Obtain and manage access tokens for Pinterest API.
  • Pin & Board Management: Create, read, update, and delete pins and boards.
  • Analytics & Ads: Retrieve analytics and manage ad accounts integration.

Quick Start

Authenticate with OAuth, then create a pin on a board using a REST call example.

Frequently Asked Questions about pinterest-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authenticate with Pinterest API v5 using OAuth 2.0?

Pinterest API v5 OAuth 2.0 authentication requires obtaining an access token by redirecting users to Pinterest's authorization endpoint, then exchanging the authorization code for a Bearer token. Include this token in the Authorization header for all subsequent API requests to pins, boards, and analytics endpoints.

Can I create and manage pins and boards programmatically with Pinterest API?

Yes, Pinterest API v5 supports creating, reading, updating, and deleting pins and boards via REST endpoints. Send JSON payloads with pin details (image URL, description, board ID) or board metadata, and the API returns the created resource with its ID for further management.

How do I retrieve Pinterest analytics and ad account data through the API?

Pinterest API v5 provides analytics endpoints to retrieve pin performance metrics and ad account usage data. Query these endpoints with appropriate parameters and Bearer token authentication to receive aggregated analytics in JSON format for reporting and optimization.

What headers and request formats does Pinterest API v5 require?

Pinterest API v5 requires the Authorization header with Bearer token, Content-Type application/json for POST/PUT requests, and JSON payloads for resource creation and updates. The API returns JSON responses with consistent error handling for rate limits and validation failures.

Does Pinterest API v5 work with web and mobile application development?

Yes, Pinterest API v5 supports both web and mobile application integrations through OAuth 2.0 flows and REST endpoints. Mobile apps can authenticate users and manage pins/boards using the same API with Bearer token authentication and rate-limiting awareness across platforms.

What rate limits and error handling should I implement for Pinterest API calls?

Pinterest API v5 enforces rate limits on requests; implement retry logic and monitor response headers for rate-limit indicators. Handle error responses with appropriate HTTP status codes and JSON error messages to ensure robust SDK and client development.