# Pinterest API

> Pinterest's developer platform for building integrations with the Pinterest API.
> Use this documentation to learn about authentication, managing organic content,
> running ads, working with catalogs, tracking conversions, and accessing analytics.

## API Specification

- [Pinterest API v5 OpenAPI Specification](https://raw.githubusercontent.com/pinterest/api-description/main/v5/openapi.yaml): Raw OpenAPI specification for the Pinterest API v5

## API Reference

- [API v5 Interactive Reference](https://developers.pinterest.com/docs/api/v5/): Browse all API v5 endpoints with request/response examples

## Documentation

### Overview
- [Overview](https://developers.pinterest.com/docs/overview/welcome/)

### Getting started
- [1. Connect app](https://developers.pinterest.com/docs/getting-started/connect-app/)
- [2. Set up authentication and authorization](https://developers.pinterest.com/docs/getting-started/set-up-authentication-and-authorization/)
- [3. Make an API call](https://developers.pinterest.com/docs/getting-started/make-an-api-call/)

### Key concepts
- [Access tiers](https://developers.pinterest.com/docs/key-concepts/access-tiers/)
- [Pinterest entities](https://developers.pinterest.com/docs/key-concepts/pinterest-entities/)
- [Best practices](https://developers.pinterest.com/docs/key-concepts/best-practices/)
- [Using beta and restricted features](https://developers.pinterest.com/docs/key-concepts/using-beta-and-restricted-features/)

### Work with organic content and users
- [Create boards and pins](https://developers.pinterest.com/docs/work-with-organic-content-and-users/create-boards-and-pins/)
- [Manage user accounts](https://developers.pinterest.com/docs/work-with-organic-content-and-users/manage-user-accounts/)

### Work with ads
- [Ads overview](https://developers.pinterest.com/docs/work-with-ads/ads-overview/)
- [Share business access](https://developers.pinterest.com/docs/work-with-ads/share-business-access/)

#### Manage campaigns and ad groups
- [Create campaigns and ad groups](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/)
- [Try out campaign objective type simplification](https://developers.pinterest.com/docs/work-with-ads/try-out-campaign-objective-type-simplification/)
- [Create promotions](https://developers.pinterest.com/docs/work-with-ads/promotions/)
- [Enable Pinterest Performance+ in campaigns](https://developers.pinterest.com/docs/work-with-ads/pinterest-performance-plus-setup/)
- [Use Pinterest Performance+ Creative](https://developers.pinterest.com/docs/work-with-ads/pinterest-performance-plus-creative/)
- [Use Media Planner with the Pinterest API](https://developers.pinterest.com/docs/work-with-ads/use-media-planner-in-the-api/)

- [Managing ads](https://developers.pinterest.com/docs/work-with-ads/managing-ads/)
- [Lead ads](https://developers.pinterest.com/docs/work-with-ads/lead-ads/)
- [Generate shareable ad previews](https://developers.pinterest.com/docs/work-with-ads/generate-shareable-ad-previews/)
- [Integrate MikMak shopper where-to-buy links](https://developers.pinterest.com/docs/work-with-ads/where-to-buy-links/)
- [Bulk actions](https://developers.pinterest.com/docs/work-with-ads/bulk-actions/)

### Work with analytics and reports
- [Analytics overview](https://developers.pinterest.com/docs/analytics-and-reports/analytics-overview/)
- [Ads reporting](https://developers.pinterest.com/docs/analytics-and-reports/ads-reporting/)
- [Organic reporting](https://developers.pinterest.com/docs/analytics-and-reports/organic-reporting/)
- [Audience insights](https://developers.pinterest.com/docs/analytics-and-reports/audience-insights/)
- [Trends](https://developers.pinterest.com/docs/analytics-and-reports/trends/)
- [Metrics glossary](https://developers.pinterest.com/docs/analytics-and-reports/metrics-glossary/)

### Work with catalogs
- [Work with catalogs and product groups](https://developers.pinterest.com/docs/work-with-catalogs/shopping-overview/)
- [Best practices](https://developers.pinterest.com/docs/work-with-catalogs/shopping-best-practices/)
- [Manage with a feed](https://developers.pinterest.com/docs/work-with-catalogs/manage-with-a-feed/)
- [Use multi-image templates in product ads](https://developers.pinterest.com/docs/work-with-catalogs/use-multi-image-templates-in-product-ads/)
- [Modify items in batch](https://developers.pinterest.com/docs/work-with-catalogs/modify-items-in-batch/)
- [Manage local store inventory](https://developers.pinterest.com/docs/work-with-catalogs/manage-local-store-inventory/)
- [Manage product groups](https://developers.pinterest.com/docs/work-with-catalogs/manage-product-groups/)
- [Diagnostics](https://developers.pinterest.com/docs/work-with-catalogs/diagnostics/)

### Work with targets and audiences
- [Set up targets for your ads](https://developers.pinterest.com/docs/work-with-targets-and-audiences/set-up-targets-for-your-ads/)
- [Create audiences](https://developers.pinterest.com/docs/work-with-targets-and-audiences/create-audiences/)
- [Use asynchronous upload jobs for large customer lists](https://developers.pinterest.com/docs/work-with-targets-and-audiences/use-asynchronous-upload-jobs-for-large-customer-lists/)
- [Share audiences](https://developers.pinterest.com/docs/work-with-targets-and-audiences/share-audiences/)

### Track conversions
- [Track conversions in the API](https://developers.pinterest.com/docs/track-conversions/track-conversions-in-the-api/)
- [Remove users from events](https://developers.pinterest.com/docs/track-conversions/remove-users-from-events/)
- [Get Event Quality Score for conversions](https://developers.pinterest.com/docs/track-conversions/get-event-quality-score/)

#### Use Pinterest Tag and Tag Helper
- [Track conversions with Pinterest Tag](https://developers.pinterest.com/docs/track-conversions/pinterest-tag/)
- [Use Pinterest Tag Helper](https://developers.pinterest.com/docs/track-conversions/use-pinterest-tag-helper/)

- [Integrate third-party tracking tools](https://developers.pinterest.com/docs/track-conversions/integrate-third-party-tracking-tools/)
- [Use Limited Data Processing flag](https://developers.pinterest.com/docs/track-conversions/use-limited-data-processing-flag/)

### Developer tools
- [SDK](https://developers.pinterest.com/docs/developer-tools/sdk/)
- [Sandbox](https://developers.pinterest.com/docs/developer-tools/sandbox/)
- [Quickstart tools](https://developers.pinterest.com/docs/developer-tools/quickstart-tools/)
- [Token Debugger](https://developers.pinterest.com/docs/developer-tools/token-debugger/)

### Reference
- [Rate limits](https://developers.pinterest.com/docs/reference/rate-limits/)
- [Schema standardization of optional nullable fields](https://developers.pinterest.com/docs/reference/schema-standardization-of-optional-nullable-fields/)
- [Error codes](https://developers.pinterest.com/docs/reference/error-codes/)
- [Pagination](https://developers.pinterest.com/docs/reference/pagination/)
- [Image proxy requests to your website](https://developers.pinterest.com/docs/reference/image-proxy-requests-to-your-website/)
- [Help & feedback](https://developers.pinterest.com/docs/reference/help-and-feedback/)
- [Manage notifications](https://developers.pinterest.com/docs/reference/manage-notifications/)
- [Control Pinterestbot access to your site](https://developers.pinterest.com/docs/reference/control-pinterestbot-access-to-your-site/)

## Optional

### Changelog
- [Changelog](https://developers.pinterest.com/docs/changelog/changelog/)

### FAQs
- [FAQs](https://developers.pinterest.com/docs/faqs/faqs/)

### Web features

#### Add ons
- [Add ons overview](https://developers.pinterest.com/docs/web-features/add-ons-overview/)
- [Buttons](https://developers.pinterest.com/docs/web-features/buttons/)
- [Widgets](https://developers.pinterest.com/docs/web-features/widgets/)


#### Rich pins
- [Rich pins overview](https://developers.pinterest.com/docs/web-features/rich-pins-overview/)
- [Article Rich Pins](https://developers.pinterest.com/docs/web-features/article-rich-pins/)
- [Product Rich Pins](https://developers.pinterest.com/docs/web-features/product-rich-pins/)
- [Recipe Rich Pins](https://developers.pinterest.com/docs/web-features/recipe-rich-pins/)