What it Does: pinterest shopping and conversion api

Part 1: The Pinterest API for Shopping (Formerly Catalogs API)

This is the foundation of your shopping presence on Pinterest. Its main purpose is to get your entire product catalog onto the platform efficiently and keep it updated.

What it Does:

• Automates Product Pin Creation: Instead of manually creating a Pin for every product you sell, you upload a data feed. Pinterest then automatically turns each product in your feed into a shoppable "Product Pin."

• Syncs Product Information: It keeps your Product Pins updated with the latest information from your website, such as:

  • Price

  • Availability (in stock, out of stock)

  • Product Title & Description

  • Product Images

• Organizes Products: Allows you to group your products into "Product Groups," which are essential for running targeted Shopping Ad campaigns.

How it Works:

1. Create a Catalog: You use the API to connect a data source (a product feed) to your Pinterest Business account.

2. Upload a Product Feed: You provide a file (typically XML, CSV, or TSV) that contains all your product data. This feed has specific columns that Pinterest requires, like id, title, link, image_link, price, availability, etc.

3. Processing & Pin Creation: Pinterest ingests your feed, validates the data, and creates a unique Product Pin for each item. These Pins are "rich," meaning they contain real-time shopping information.

4. Regular Updates: You set a schedule for Pinterest to re-fetch your feed (e.g., every 24 hours) to keep prices and stock levels accurate.

Why use the Shopping API?

• Scale: Manage thousands of products with ease.

• Accuracy: Reduces the risk of showing users incorrect prices or out-of-stock items.

• Efficiency: Saves countless hours compared to manual Pinning.

• Enables Shopping Ads: A synced catalog is a prerequisite for running powerful Shopping Ad campaigns.

Part 2: The Pinterest API for Conversions (CAPI)

This is the tracking and measurement side. It's a server-to-server solution that gives you a more reliable way to measure the actions users take on your website after interacting with your Pinterest ads.

The Problem it Solves:

Traditionally, tracking was done using the Pinterest Tag, a piece of JavaScript code on your website (similar to the Facebook Pixel or Google Ads tag). However, this browser-based tracking is becoming less reliable due to:

• Ad Blockers: Blocking the Pinterest Tag from firing.

• Browser Privacy Changes: Apple's ITP (Intelligent Tracking Prevention) and browser restrictions on third-party cookies limit the tag's effectiveness.

• iOS 14+ App Tracking Transparency (ATT): Users can opt-out of tracking across apps.

The Conversion API (CAPI) bypasses these browser-level issues.

How it Works:

Instead of your browser telling Pinterest about a conversion, your website's server tells Pinterest directly.

Typical Flow (with CAPI):

1. User Action: A user clicks your Pinterest Ad and lands on your site. They add a product to their cart.

2. Server Event: Your website's server records this "Add to Cart" event.

3. API Call: Your server sends a secure, direct API call to Pinterest's servers, containing details about the event (e.g., event_name: 'add_to_cart', product_id, value, and hashed user data like email for matching).

4. Attribution: Pinterest receives this reliable, server-side data and attributes the conversion back to the original ad click.

Key Features of the Conversion API:

• Event Tracking: You can send a wide range of standard e-commerce events:

  • page_visit

  • view_category

  • search

  • add_to_cart

  • checkout (for a completed purchase)

  • lead

  • signup

• Deduplication: Pinterest recommends using both the Pinterest Tag (browser) and the CAPI (server) together for maximum coverage. To avoid counting the same conversion twice, you send a unique event_id for each conversion event in both the browser tag and the server API call. Pinterest uses this ID to recognize it's the same event and only counts it once.

• Improved Matching: By sending hashed, first-party customer data (like an email address from the checkout form), you significantly improve Pinterest's ability to match conversions to the users who saw your ads, even across devices.

How They Work Together: The Full E-commerce Loop

1. Upload (Shopping API): You use the Shopping API to upload your "Stylish Blue Sneakers" to your Pinterest catalog. A Product Pin is automatically created.

2. Promote (Ads): You run a Shopping Ad campaign targeting users interested in sneakers, using the Product Group containing your new shoes.

3. Discover & Click (Pinterest User): A user sees your ad on Pinterest, clicks the Product Pin, and is taken to your product page.

   • The Pinterest Tag fires a page_visit event from their browser.

4. Action (Your Website): The user loves the sneakers and adds them to their cart.

   • Your server sends an add_to_cart event to Pinterest via the Conversion API.

5. Purchase (Your Website): The user completes the checkout.

   • Your server sends a checkout event with the order value via the Conversion API.

6. Measure & Optimize (Pinterest Ads Manager): Pinterest receives the reliable CAPI data. It accurately attributes the sale to your ad campaign. You can now see your true Return On Ad Spend (ROAS) and Pinterest's algorithm gets smarter, showing your ads to more people likely to buy.

How to Get Started

1. Partner Integration (Recommended for most): The easiest way is through an official partner integration that has built-in support for both APIs.

   • Shopify: The Pinterest for Shopify app handles both catalog sync and CAPI implementation automatically.

   • WooCommerce: The Pinterest for WooCommerce extension does the same.

   • Google Tag Manager (Server-Side): A more advanced but powerful way to manage the CAPI.

2. Direct API Integration (For Developers): If you have a custom e-commerce platform, your developers can build a direct integration.

   • Get a Pinterest Business Account.

   • Create a Developer App on developers.pinterest.com.

   • Use OAuth 2.0 to get access tokens.

   • Follow the API documentation for the Shopping API and the Conversion API.

In summary, using the Shopping API and Conversion API together is no longer optional—it's essential for any serious e-commerce business looking to succeed on Pinterest. It ensures your products are visible, your data is accurate, and your ad spend is effective.