The Pinterest API for pins and boards

# 1. List the account's boards to pick a target
curl https://api.social-api.ai/v1/accounts/<pinterest-account-id>/boards \
  -H "Authorization: Bearer <your-api-key>" | jq

# 2. Create the pin on one of them
curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Weeknight roast chicken",
    "text": "One pan, forty minutes, no marinade.",
    "targets": [{
      "account_id": "<pinterest-account-id>",
      "board_id": "<board-id>",
      "media": [{ "source_type": "url", "source": "https://example.com/chicken.jpg", "type": "image" }]
    }]
  }' | jq

import requests

AUTH = {"Authorization": "Bearer <your-api-key>"}

# Boards are fetched live from Pinterest, so list them when you need one.
boards = requests.get(
    "https://api.social-api.ai/v1/accounts/<pinterest-account-id>/boards",
    headers=AUTH,
).json()["data"]

resp = requests.post(
    "https://api.social-api.ai/v1/posts",
    headers=AUTH,
    json={
        "title": "Weeknight roast chicken",
        "text": "One pan, forty minutes, no marinade.",
        "targets": [{
            "account_id": "<pinterest-account-id>",
            "board_id": boards[0]["id"],
            "media": [{
                "source_type": "url",
                "source": "https://example.com/chicken.jpg",
                "type": "image",
            }],
        }],
    },
)
print(resp.json())  # { "id": "...", "status": "published", ... }

const auth = { Authorization: "Bearer <your-api-key>" };

const boardsRes = await fetch(
  "https://api.social-api.ai/v1/accounts/<pinterest-account-id>/boards",
  { headers: auth },
);
const { data: boards } = await boardsRes.json();

const res = await fetch("https://api.social-api.ai/v1/posts", {
  method: "POST",
  headers: { ...auth, "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "Weeknight roast chicken",
    text: "One pan, forty minutes, no marinade.",
    targets: [{
      account_id: "<pinterest-account-id>",
      board_id: boards[0].id,
      media: [{ source_type: "url", source: "https://example.com/chicken.jpg", type: "image" }],
    }],
  }),
});
console.log(await res.json());