pinterest-api-sdk
Pinterest API SDK
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is permissively licensed. Install it if you need to automate Pinterest campaign management or integrate Pinterest ads into a Python application. The main gotcha is that you must register an app and obtain credentials from Pinterest's developer platform before use.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.7+, a registered Pinterest app on developers.pinterest.com, and either an access token or refresh token set via environment variables or config.json.
- Low install friction with a pure Python wheel distribution.
- Actively maintained with recent commits and no known vulnerabilities.
License · maintenance · safety
Apache License 2.0 (permissive) — Licensed under Apache License 2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions—suitable for most projects.
last release 2025-09-04 (344 days) · last repo commit 2026-04-13 · 82 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 316,184 downloads/mo, #7,680 on PyPI
Alternatives
Verify before relying
pip install pinterest-api-sdk
from pinterest.client import PinterestSDKClient
from pinterest.ads.campaigns import Campaign
# Client auto-instantiates from environment variables or config.json
campaign = Campaign(ad_account_id="123456789", campaign_id="987654321")
campaign.activate()- Whether the SDK supports organic Pins, shopping, and analytics features mentioned as 'coming over time' in the description.
- Current scope of supported API endpoints beyond campaign management.
- Whether the package is suitable for production use given the 'no guaranteed SLA' note for issue resolution.
- Access token validity period and refresh token validity period for production deployments.
What it is and what it does
The Pinterest SDK for Python is an official client library that wraps the Pinterest API to simplify campaign management, authentication, and error handling. It handles OAuth token refresh automatically when configured with a refresh token, reducing boilerplate code for common Pinterest advertising tasks like creating ads, managing ad groups, and adjusting campaign budgets. The library depends on urllib3 for HTTP requests, python-dateutil for timestamp handling, python-dotenv for environment configuration, and six for Python 2/3 compatibility.
The SDK is designed for developers building Pinterest advertising automation tools or integrations. It provides object-oriented access to campaigns, ad groups, and ads through classes like Campaign, AdGroup, and Ad, with methods for creation, activation, and budget management. Configuration is flexible—you can use environment variables or a config.json file—and the client auto-instantiates when properly configured. The library is actively maintained, has no known security vulnerabilities, and is permissively licensed under Apache License 2.0.
Use it for
- Automate campaign creation and management for Pinterest advertising platforms or agencies.
- Build tools that programmatically activate, pause, or adjust budgets on existing Pinterest campaigns.
- Integrate Pinterest ad account management into larger marketing automation workflows.
- Refresh access tokens automatically without manual intervention in long-running applications.
- Manage multiple ad accounts or campaigns in bulk using the SDK's object-oriented API.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has low install friction, carries no known vulnerabilities, and is permissively licensed. Install it if you need to automate Pinterest campaign management or integrate Pinterest ads into a Python application. The main gotcha is that you must register an app and obtain credentials from Pinterest's developer platform before use.
Install
pinterest-api-sdk on PyPI
Before you install
Low install friction with a pure Python wheel distribution. Actively maintained with recent commits and no known vulnerabilities. Five runtime dependencies are all standard utilities (urllib3, python-dateutil, python-dotenv, six, Pinterest-Generated-Client).
Requires Python 3.7+, a registered Pinterest app on developers.pinterest.com, and either an access token or refresh token set via environment variables or config.json.
License in practice
Licensed under Apache License 2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions—suitable for most projects.
Quickstart
pip install pinterest-api-sdk
from pinterest.client import PinterestSDKClient
from pinterest.ads.campaigns import Campaign
# Client auto-instantiates from environment variables or config.json
campaign = Campaign(ad_account_id="123456789", campaign_id="987654321")
campaign.activate()Verify before relying
- Whether the SDK supports organic Pins, shopping, and analytics features mentioned as 'coming over time' in the description.
- Current scope of supported API endpoints beyond campaign management.
- Whether the package is suitable for production use given the 'no guaranteed SLA' note for issue resolution.
- Access token validity period and refresh token validity period for production deployments.
Package facts
| License | Apache License 2.0 permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesurllib3python-dateutilpython-dotenvsixPinterest-Generated-Client |
| Maintenance | Actively maintained 344 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 316,184 / month, #7,680 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: pinterest_api_sdk-0.2.6-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “campaign management sdk”
- pinterest-api-sdkPython client library for the Pinterest API that handles campaign…
- sib-api-v3-sdkPython SDK for the SendinBlue REST API, enabling programmatic…
- bingadsBing Ads Python SDK provides proxy classes and authentication…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also Pinterest-Generated-Client · facebook-business · twitter-ads · googleads · bingads · tiktok-business-api-sdk-official · klaviyo-api · google-ads-admanager · marketorestpython · egnyte