Pinterest

aid: pinterest
url: https://raw.githubusercontent.com/api-search/images/main/_apis/pinterest/apis.md
apis:
- aid: pinterest:pinterest-api
  name: Pinterest API
  tags:
  - Images
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.pinterest.com/v5
  humanURL: https://developers.pinterest.com/
  properties:
  - url: https://developers.pinterest.com/docs/api/v5/
    type: Documentation
  - url: openapi/pinterest-openapi-original.yml
    type: OpenAPI
  - url: openapi/pinterest-asyncapi.yml
    type: AsyncAPI
  - url: graphql/pinterest-graphql.md
    type: GraphQL
  description: The Pinterest REST API v5 for managing ads, ad groups, ad accounts,
    audiences, billing, boards, board sections, pins, catalogs, and analytics on Pinterest.
name: Pinterest
tags:
- Images
- Social Media
- Videos
kind: contract
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
access: 3rd-Party
common:
- type: LinkedIn
  url: https://www.linkedin.com/company/pinterest
- url: https://www.pinterest.com/_/_/policy/developer-guidelines
  type: Guidelines
- url: https://www.pinterest.com/_/_/newsroom/
  type: News
- url: https://medium.com/pinterest-engineering
  type: Blog
- url: https://medium.com/feed/pinterest-engineering
  type: BlogRSS
  description: Discovered RSS/Atom feed for https://medium.com/pinterest-engineering
- url: https://help.pinterest.com/contact
  type: Support
- url: https://developers.pinterest.com/terms/
  type: TermsOfService
- url: https://github.com/pinterest/api-description
  type: OpenAPI
- url: https://github.com/pinterest
  type: GitHub Org
- url: https://www.pintereststatus.com/
  name: Status
  type: StatusPage
- url: https://developers.pinterest.com/
  name: Pinterest Developers
  type: Portal
  description: 'null'
- url: https://developers.pinterest.com/docs/overview/welcome/
  name: Pinterest Developers
  type: Documentation
  description: 'null'
- url: https://developers.pinterest.com/docs/changelog/changelog/
  name: Pinterest Developers
  type: ChangeLog
  description: 'null'
- url: https://developers.pinterest.com/docs/getting-started/connect-app/
  name: Pinterest Developers
  type: GettingStarted
  description: 'null'
- url: https://developers.pinterest.com/docs/api-features/track-conversion-events/
  name: Pinterest Developers
  type: Features
  description: 'null'
  data:
  - 'Pinterest: hundreds of services across Social Media + Ads'
  - 'Detailed pricing: see https://developers.pinterest.com/docs/api/v5/introduction/'
  - 'Service: Pinterest API v5 (free for OAuth-authorized apps)'
  - 'Service: Marketing API (Ads Manager)'
  - 'Service: Catalogs API (commerce)'
  - 'Service: Conversions API (server-side events)'
  - 'Service: Trial of Pinterest Plus / Premiere'
  sources:
  - https://developers.pinterest.com/docs/api/v5/introduction/
  - https://focus.finops.org/
  updated: '2026-05-04'
- url: https://developers.pinterest.com/docs/developer-tools/sdk/
  name: Pinterest Developers
  type: SDKs
  description: Developer
- url: https://developers.pinterest.com/docs/developer-tools/sandbox/
  name: Pinterest Developers
  type: Sandbox
  description: Developer
- url: https://developers.pinterest.com/docs/developer-tools/quickstart-tools/
  name: Pinterest Developers
  type: GettingStarted
  description: Developer
- url: https://developers.pinterest.com/docs/reference/rate-limits/
  name: Pinterest Developers
  type: RateLimits
  description: 'null'
- url: https://developers.pinterest.com/docs/reference/error-codes/
  name: Pinterest Developers
  type: Errors
  description: 'null'
- url: https://developers.pinterest.com/docs/reference/pagination/
  name: Pinterest Developers
  type: Pagination
  description: 'null'
- url: https://developers.pinterest.com/docs/reference/help-and-feedback/
  name: Pinterest Developers
  type: Support
  description: 'null'
- url: https://developers.pinterest.com/terms/
  name: Pinterest Developers | Terms
  type: TermsOfService
  description: 'null'
- url: https://policy.pinterest.com/en/privacy-policy
  name: Privacy Policy | Pinterest Policy
  type: PrivacyPolicy
  description: 'null'
- url: https://business.pinterest.com/pinterest-business-partners/
  name: Work with Approved Pinterest Partners | Pinterest Business
  type: Partners
  description: 'null'
- url: https://example.com/plans
  data:
  - id: trial
    name: Trial
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: Free
      metric: user
      timeFrame: month
      description: Trial tier.
    description: The temporary access.
  - id: standard
    name: Standard
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: Free
      metric: user
      timeFrame: month
      description: Standard tier.
    description: The standard access.
  name: Plans
  type: Plans
- name: Rate Limits
  type: RateLimits
  description: The rate limits for this API.
  url: https://developers.pinterest.com/docs/reference/rate-limits/
  data:
  - name: Ads Analytics
    description: Fetching analytical data about ads.
    type: ads_analytics
    tier: Trial
    limit: 1000
    metric: request
    timeframe: day
  - name: Ads Analytics
    description: Fetching analytical data about ads.
    type: ads_analytics
    tier: Standard
    limit: 300
    metric: request
    timeframe: minute
  - name: Ads Conversions
    description: Sending batches of conversion events for an ad account. This category
      applies to requests authenticated with a token acquired through the standard
      OAuth flow.
    type: ads_conversions
    tier: Trial
    limit: 1000
    metric: request
    timeframe: day
  - name: Ads Conversions
    description: Sending batches of conversion events for an ad account. This category
      applies to requests authenticated with a token acquired through the standard
      OAuth flow.
    type: ads_conversions
    tier: Standard
    limit: 120000
    metric: request
    timeframe: minute
  - name: Ads Read
    description: Fetching information on ads, ad groups, ad campaigns or ad accounts.
    type: ads_read
    tier: Trial
    limit: 1000
    metric: request
    timeframe: day
  - name: Ads Read
    description: Fetching information on ads, ad groups, ad campaigns or ad accounts.
    type: ads_read
    tier: Standard
    limit: 120000
    metric: request
    timeframe: minute
  - name: Ads Write
    description: Creating, editing or deleting ad entities, such as ad accounts, ads,
      ad groups or campaigns.
    type: ads_write
    tier: Trial
    limit: 300
    metric: request
    timeframe: day
  - name: Ads Write
    description: Creating, editing or deleting ad entities, such as ad accounts, ads,
      ad groups or campaigns.
    type: ads_write
    tier: Standard
    limit: 400
    metric: request
    timeframe: minute
  - name: Advanced Auction Read
    description: Fetching information related to bid options for ads auctions.
    type: advanced_auction_read
    tier: Trial
    limit: 1000
    metric: request
    timeframe: day
  - name: Advanced Auction Read
    description: Fetching information related to bid options for ads auctions.
    type: advanced_auction_read
    tier: Standard
    limit: 50
    metric: request
    timeframe: minute
  - name: Advanced Auction Write
    description: Operating on ad auction bid items.
    type: advanced_auction_write
    tier: Trial
    limit: 1000
    metric: request
    timeframe: day
  - name: Advanced Auction Write
    description: Operating on ad auction bid items.
    type: advanced_auction_write
    tier: Standard
    limit: 25
    metric: request
    timeframe: minute
  - name: Catalog Read
    description: Fetching item information from catalogs.
    type: catalogs_read
    tier: Trial
    limit: 1000
    metric: request
    timeframe: day
  - name: Catalog Read
    description: Fetching item information from catalogs,
    type: catalogs_read
    tier: Standard
    limit: 100
    metric: request
    timeframe: minute
  - name: Catalog Write
    description: Creating or modifing item information for catalogs.
    type: catalogs_write
    tier: Trial
    limit: 1000
    metric: request
    timeframe: day
  - name: Catalog Write
    description: Creating or modifing item information for catalogs.
    type: catalogs_write
    tier: Standard
    limit: 100
    metric: request
    timeframe: minute
  - name: Org Analytics
    description: Fetching user-related analytics data, such as account information
      and top Pins.
    type: org_analytics
    tier: Trial
    limit: 1000
    metric: request
    timeframe: day
  - name: Org Analytics
    description: Fetching user-related analytics data, such as account information
      and top Pins.
    type: org_analytics
    tier: Standard
    limit: 60
    metric: request
    timeframe: minute
  - name: Org Read
    description: Fetching user accounts, boards, board sections, or Pins.
    type: org_read
    tier: Trial
    limit: 1000
    metric: request
    timeframe: day
  - name: Org Read
    description: Fetching user accounts, boards, board sections, or Pins.
    type: org_read
    tier: Standard
    limit: 1000
    metric: request
    timeframe: minute
  - name: Org Write
    description: Creating, editing or deleting boards, board sections or Pins.
    type: org_write
    tier: Trial
    limit: 300
    metric: request
    timeframe: day
  - name: Org Write
    description: Creating, editing or deleting boards, board sections or Pins.
    type: org_write
    tier: Standard
    limit: 100
    metric: request
    timeframe: minute
  - name: Trends Read
    description: Fetching trending keyword information.
    type: trends_read
    tier: Trial
    limit: 1000
    metric: request
    timeframe: day
  - name: Trends Read
    description: Fetching trending keyword information.
    type: trends_read
    tier: Standard
    limit: 60
    metric: request
    timeframe: minute
- name: OAuth Scopes
  type: OAuthScopes
  description: You must request at least one scope during the OAuth flow. You should
    only request the scopes required for your product.
  url: https://developers.pinterest.com/docs/getting-started/set-up-authentication-and-authorization/#available-scopes
  data:
  - id: read_permissions
    name: Ads
    type: read
    description: See all data related to advertising, such as ads, ad groups and campaigns.
  - id: write_permissions
    name: Ads
    type: write
    description: Create, update or delete ads, ad groups and campaigns.
  - id: billing
    name: Billing
    type: read
    description: See all of your billing data, such as your billing profile.
  - id: billing
    name: Billing
    type: write
    description: Create, update or delete billing data.
  - id: biz_access
    name: Business Access
    type: read
    description: See all business access data.
  - id: biz_access
    name: Business Access
    type: write
    description: Create, update or delete business access data.
  - id: boards
    name: Boards
    type: read
    description: See public boards, including group boards, with boards read.
  - id: boards
    name: Boards
    type: read_secret
    description: See secret boards with boards read_secret.
  - id: boards
    name: Boards
    type: write
    description: Create, update or delete public boards with boards write.
  - id: boards
    name: Boards
    type: write_secret
    description: Create, update or delete secret boards with boards write_secret.
  - id: catalogs
    name: Catalogs
    type: read
    description: See all catalog data.
  - id: catalogs
    name: Catalogs
    type: write
    description: Create, update or delete catalogs.
  - id: pins
    name: Pins
    type: read
    description: See public pins with pins read.
  - id: pins
    name: Pins
    type: read_secret
    description: See secret pins with pins read_secret.
  - id: pins
    name: Pins
    type: write
    description: Create, update or delete public pins with pins write.
  - id: pins
    name: Pins
    type: write_secret
    description: Create, update or delete secret pins with pins write_secret.
  - id: user_accounts
    name: User Accounts
    type: read
    description: See user accounts and followers.
  - id: user_accounts
    name: User Accounts
    type: write
    description: Update user accounts and followers.
- type: LLMsTxt
  url: https://developers.pinterest.com/llms.txt
created: '2023-11-23'
modified: '2026-05-30'
position: Consuming
description: Pinterest is an American image sharing and social media service designed
  to enable saving and discovery of information like recipes, home, style, motivation,
  and inspiration on the internet using images and, on a smaller scale, animated GIFs
  and videos, in the form of pinboards.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
specificationVersion: '0.18'