Get Pinterest Board

GET /public/addon/pinterest/board

Lists the boards of a connected Pinterest account. A pin always goes to a board, so pass the chosen item as additionalInfo.channel in Create Schedule, one schedule per board. Its id also works as channelId in Get Content to list only that board's pins.

Endpoint Details

• Authentication: Basic Auth (Authorization: Basic Base64(AccessKey:SecretKey))
• Access Tier: Premium+

Parameters

Parameter	Type	Required	Description
accountId	string	Yes	The unique ID of a connected Pinterest account.

Example Request

cURL

curl -X GET "https://api.repliz.com/public/addon/pinterest/board?accountId=680affa5ce12f2f72916f67e" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)"

Axios

import axios from 'axios';

const response = await axios.get('https://api.repliz.com/public/addon/pinterest/board', {
  params: {
    accountId: '680affa5ce12f2f72916f67e'
  },
  auth: {
    username: 'YOUR_ACCESS_KEY',
    password: 'YOUR_SECRET_KEY'
  }
});

console.log(response.data);

Fetch

const credentials = btoa('YOUR_ACCESS_KEY:YOUR_SECRET_KEY');

const response = await fetch('https://api.repliz.com/public/addon/pinterest/board?accountId=680affa5ce12f2f72916f67e', {
  headers: {
    'Authorization': `Basic ${credentials}`
  }
});

const data = await response.json();
console.log(data);

Response

200

{
  "docs": [
    {
      "id": "1006921296753698211",
      "name": "Social Media Tips",
      "picture": "https://i.pinimg.com/400x300/fd/cd/d5/fdcdd5a6d8a80824add0d054125cd957.jpg",
      "type": "board"
    }
  ]
}

400

// Not a Pinterest Account
{
  "code": 400,
  "message": "invalid account type"
}

404

// Account Not Found
{
  "code": 404,
  "message": "account not found"
}

401

{
  "code": 401,
  "message": "unauthorized"
}

Field	Description
id	Pinterest ID of the board, for example 1006921296753698211.
name	Name of the board.
picture	Cover image of the board, or its first pin's thumbnail. Empty when the board has none.
type	Always board.

The list has the boards the account can pin to, up to 2,500. A 401 from Pinterest, shown as an error message, means Repliz lost access to the account: reconnect it and try again.