v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
search

Search user's Pins

Search for pins for the "operation user_account".

  • By default, the "operation user_account" is the token user_account.

If using Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account". See Understanding Business Access for more information.

get/search/pins

Query parameters

ad_account_idstring

Unique identifier of an ad account.

querystring required

Search query. Can contain pin description keywords or comma-separated pin IDs.

bookmarkstring

Cursor used to fetch the next page of items

Response

The request has succeeded.

bookmarkstring nullable

Example response

{
  "items": [
    {
      "media": {
        "images": {
          "150x150": {
            "width": 150,
            "height": 150,
            "url": "https://i.pinimg.com/150x150/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
          },
          "400x300": {
            "width": 400,
            "height": 300,
            "url": "https://i.pinimg.com/400x300/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
          },
          "600x": {
            "width": 600,
            "height": 600,
            "url": "https://i.pinimg.com/600x/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
          },
          "1200x": {
            "width": 1200,
            "height": 1200,
            "url": "https://i.pinimg.com/1200x/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
          }
        }
      },
      "pin_metrics": {
        "90d": {
          "pin_click": 7,
          "impression": 2,
          "clickthrough": 3
        },
        "lifetime_metrics": {
          "pin_click": 7,
          "impression": 2,
          "clickthrough": 3,
          "reaction": 10,
          "comment": 2
        }
      }
    }
  ]
}