---
id: pinterest-generated-client
version: "0.1.11"
license: MIT
license_treatment: permissive
maintenance: active
---

# Pinterest-Generated-Client — Pinterest REST API

License: permissive · Maintenance: active · Downloads: 317.2K/mo

## What it is and what it does

This is an OpenAPI-generated Python client library for Pinterest's REST API. It provides typed bindings to Pinterest's ad account, analytics, and campaign management endpoints, allowing developers to query ad performance metrics, manage ad accounts, and retrieve conversion data programmatically. The package wraps HTTP calls and handles request/response serialization using urllib3 and python-dateutil.

The package is explicitly positioned as a low-level, auto-generated artifact rather than a user-facing SDK. Its own documentation directs users toward an alternative SDK for production use. The generated code exposes a large API surface covering ad accounts, analytics, MMM reports, targeting, and conversion attribution, but comes with typical code-generation trade-offs: minimal documentation beyond endpoint signatures and limited customization.

Use it for:

- Retrieve ad account analytics and performance metrics for a specific date range and granularity level.
- Query conversion attribution data with configurable click, engagement, and view attribution windows.
- Programmatically access ad account details and create new ad accounts.
- Build internal tools or dashboards that consume Pinterest advertising data without writing raw HTTP requests.
- Integrate Pinterest campaign metrics into a larger analytics or reporting pipeline.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides auto-generated Python bindings for Pinterest's REST API, enabling programmatic access to ad accounts, analytics, and campaign management endpoints.

Yes, with conditions. Install if you need direct, low-level access to Pinterest's REST API and are comfortable with an auto-generated client. However, the package's own documentation recommends an alternative SDK instead; evaluate that first. The package is actively maintained, has no known vulnerabilities, and carries permissive licensing. Low install friction and reasonable download volume suggest it is stable enough for production use, but treat it as a generated artifact rather than a polished, hand-maintained library.

## Install

pip install pinterest-generated-client
uv add pinterest-generated-client
poetry add pinterest-generated-client

## Installing Pinterest-Generated-Client

Before you install: Low install friction with only two lightweight runtime dependencies (urllib3, python-dateutil). Active maintenance with recent commits; however, the package documentation explicitly recommends using the official Pinterest Python SDK instead of this generated client directly.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install pinterest-generated-client

import urllib3
import python-dateutil

# Configure API client with OAuth2 token
configuration = Configuration(host="https://api.pinterest.com/v5")
configuration.access_token = 'YOUR_ACCESS_TOKEN'

# Make API calls through the generated client

Requires a valid Pinterest OAuth2 access token to authenticate API requests.

Verify before relying:

- Whether this generated client is kept in sync with Pinterest API schema changes or if drift occurs over time.
- Stability guarantees for the auto-generated API surface across minor version updates.
- Whether the recommendation to use an alternative SDK indicates planned deprecation or ongoing maintenance limitations.
- Actual Python version support, as requires_python is unspecified in the fact sheet.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 317.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pinterest api client, pinterest rest api python, pinterest ads api, pinterest analytics api, openapi generated client, pinterest ad account management, pinterest campaign api, api-client, pinterest, openapi-generated

[View on SkillFed](https://skillfed.io/packages/pinterest-generated-client) · [View on PyPI](https://pypi.org/project/pinterest-generated-client/)