Pinterest Analytics

Pinterest analytics endpoints provide insights for your connected Pinterest accounts.

1. GET /api/pinterest/overview

Returns account-level metrics with current vs. previous period comparison.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/pinterest/overview?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "metrics": [
      {
        "key": "posts",
        "name": "Posts",
        "value_current_period": 25,
        "value_last_period": 20,
        "percentage_change": "+25.0%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "impressions",
        "name": "Impressions",
        "value_current_period": 75000,
        "value_last_period": 60000,
        "percentage_change": "+25.0%",
        "description": "Total number of times your pins were shown"
      },
      {
        "key": "saves",
        "name": "Saves",
        "value_current_period": 450,
        "value_last_period": 380,
        "percentage_change": "+18.4%",
        "description": "The number of times your pins were saved"
      },
      {
        "key": "comments",
        "name": "Comments",
        "value_current_period": 30,
        "value_last_period": 25,
        "percentage_change": "+20.0%",
        "description": "The number of comments on your pins"
      },
      {
        "key": "repins",
        "name": "Repins",
        "value_current_period": 180,
        "value_last_period": 150,
        "percentage_change": "+20.0%",
        "description": "The number of times your pins were repinned"
      },
      {
        "key": "clicks",
        "name": "Clicks",
        "value_current_period": 320,
        "value_last_period": 260,
        "percentage_change": "+23.1%",
        "description": "The number of clicks on your pins"
      }
    ],
    "total_followers": 3200,
    "post_performance": {
      "most_engaging": [],
      "least_engaging": [],
      "most_views": [],
      "least_views": [],
      "most_repinned": [],
      "least_repinned": []
    }
  }
}

Metrics

Key	Name	Description
posts	Posts	Total posts published
impressions	Impressions	Total number of times your pins were shown
saves	Saves	The number of times your pins were saved
comments	Comments	The number of comments on your pins
repins	Repins	The number of times your pins were repinned
clicks	Clicks	The number of clicks on your pins

---

2. GET /api/pinterest/posts

Returns analytics for individual posts.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/pinterest/posts?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "stats": [
      {
        "key": "posts",
        "name": "Posts",
        "value_current_period": 25,
        "value_last_period": 20,
        "percentage_change": "+25.0%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "impressions",
        "name": "Impressions",
        "value_current_period": 75000,
        "value_last_period": 60000,
        "percentage_change": "+25.0%",
        "description": "Total number of times your pins were shown"
      },
      {
        "key": "saves",
        "name": "Saves",
        "value_current_period": 450,
        "value_last_period": 380,
        "percentage_change": "+18.4%",
        "description": "The number of times your pins were saved"
      },
      {
        "key": "comments",
        "name": "Comments",
        "value_current_period": 30,
        "value_last_period": 25,
        "percentage_change": "+20.0%",
        "description": "The number of comments on your pins"
      },
      {
        "key": "repins",
        "name": "Repins",
        "value_current_period": 180,
        "value_last_period": 150,
        "percentage_change": "+20.0%",
        "description": "The number of times your pins were repinned"
      },
      {
        "key": "clicks",
        "name": "Clicks",
        "value_current_period": 320,
        "value_last_period": 260,
        "percentage_change": "+23.1%",
        "description": "The number of clicks on your pins"
      }
    ],
    "posts": [
      {
        "id": "pin_123456",
        "page_id": "pinterest_account_123",
        "format": "image",
        "text": "Amazing DIY idea",
        "permalink": "https://pinterest.com/pin/123456",
        "media_type": "IMAGE",
        "media_url": "https://example.com/pin.jpg",
        "stats": {
          "impressions": 3000,
          "saves": 18,
          "comments": 1,
          "repins": 7,
          "clicks": 13
        },
        "timestamp": "2025-05-01 09:00:00"
      }
    ]
  }
}

Post Stats

Field	Description
impressions	Number of impressions
saves	Number of saves
comments	Number of comments
repins	Number of repins
clicks	Number of clicks

✅ Result: You have successfully retrieved Pinterest analytics data!