Pinterest Media API

Что умеет

Endpoint обрабатывает пины Pinterest: статичные изображения, анимированные GIF и видео. Поддерживаются короткие ссылки pin.it и полные URL pinterest.com/pin/…. В массиве media перечислены все доступные форматы с указанием качества; для видео может присутствовать download_url — прокси-ссылка для скачивания.

• Видео и изображения
• Несколько разрешений
• Быстрый ответ (~2 с)
• pin.it короткие ссылки

Как пользоваться

1. Ссылка pin.it или pinterest.com/pin/…
2. GET /api/v1/pinterest?url=…
3. Ответ: media[] с URL изображений и видео.

Параметры

urlstringобязательный

Публичная ссылка на пин: pin.it/… или pinterest.com/pin/…

Пример запроса

curl -G "https://api.interapi.dev/api/v1/pinterest" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "url=https://pin.it/b8ifFh79b"

import requests

resp = requests.get(
    "https://api.interapi.dev/api/v1/pinterest",
    params={"url": "https://pin.it/b8ifFh79b"},
    headers={"X-API-Key": "YOUR_API_KEY"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())

const params = new URLSearchParams({ url: "https://pin.it/b8ifFh79b" });
const resp = await fetch(`https://api.interapi.dev/api/v1/pinterest?${params}`, {
  headers: { "X-API-Key": "YOUR_API_KEY" },
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$query = http_build_query(["url" => "https://pin.it/b8ifFh79b"]);
$ch = curl_init("https://api.interapi.dev/api/v1/pinterest?" . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: YOUR_API_KEY"],
    CURLOPT_TIMEOUT => 60,
]);
$data = json_decode(curl_exec($ch), true);
print_r($data);

Пример ответа

{
  "status": "success",
  "platform": "InterAPI",
  "title": "",
  "description": "",
  "media": [
    {
      "type": "video",
      "url": "https://v1.pinimg.com/…/da6d14c39a57db3db3844930",
      "quality": "720p"
    },
    {
      "type": "photo",
      "url": "https://i.pinimg.com/…/d53b014d86a6b6761bf649a0",
      "quality": "image"
    }
  ],
  "video_url": "https://v1.pinimg.com/…/da6d14c39a57db3db3844930",
  "video_hd_url": "https://v1.pinimg.com/…/da6d14c39a57db3db3844930",
  "music_url": null,
  "thumbnail": "https://i.pinimg.com/…/d53b014d86a6b6761bf649a0",
  "duration_sec": 0,
  "author": "",
  "channel_url": null,
  "duration_ms": 986
}

duration_ms — время обработки на сервере. Ссылки в примере сокращены.

Смотрите также

• Instagram Media API/api/v1/instagram
• TikTok Video API/api/v1/tiktok
• YouTube Video API/api/v1/youtube
• X (Twitter) Media API/api/v1/x
• Facebook Video API/api/v1/facebook