pinconnector.
ВойтиНачать бесплатно

Pin Connector API

Публикуйте пины
из своей системы.

Один API для кабинета, автоматизаций и AI-агентов. Получите список досок, передайте изображение и поставьте пин в очередь — с понятным статусом доставки.

Получить API ключOpenAPI JSON

Быстрый старт

От ключа до первого пина

01Создайте ключВ кабинете Pin Connector
02Найдите boardIdЗапросом к accounts
03Создайте пинЧерновик или расписание

Авторизация

Все запросы требуют заголовок Authorization: Bearer <ключ>. Базовый URL: https://pinconnector.online

Для AI-агентов

MCP работает с той же очередью

Для Codex, Cursor, Claude Code и совместимых клиентов используйте endpoint https://pinconnector.online/api/mcp и тот же Bearer API‑ключ. Инструменты позволяют прочитать аккаунты, проверить очередь и создать пин.

GET/api/v1/accounts

Список подключённых Pinterest-аккаунтов и их досок. Используется, чтобы узнать boardId для создания постов.

Запрос

curl -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  https://pinconnector.online/api/v1/accounts

Ответ

{
  "accounts": [
    {
      "id": "uuid",
      "platform": "pinterest",
      "displayName": "Мой аккаунт",
      "username": "myname",
      "status": "active",
      "boardsCount": 5,
      "boards": [{ "id": "54975...", "name": "Идеи", "pinCount": 120 }]
    }
  ],
  "total": 1
}
GET/api/v1/posts

Список постов постранично. По умолчанию возвращается 50 записей, максимум - 100. Параметр status фильтрует по техническому статусу, а nextCursor из ответа передаётся в cursor для следующей страницы.

Запрос

curl -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  "https://pinconnector.online/api/v1/posts?status=scheduled&limit=50"

Ответ

{
  "posts": [ { "id": "uuid", "status": "scheduled", "title": "...", "scheduledAt": "..." } ],
  "total": 1,
  "hasMore": false,
  "nextCursor": null
}
POST/api/v1/posts

Создать пост. Если указать scheduledAt — он будет опубликован автоматически в это время. Если нет — сохранится как черновик.

Запрос

curl -X POST https://pinconnector.online/api/v1/posts \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "boardId": "54975...",
    "imageUrl": "https://pinconnector.online/uploads/abc.jpg",
    "title": "Новый пин",
    "description": "Описание",
    "link": "https://example.com",
    "scheduledAt": "2026-07-20T12:00:00Z"
  }'

Ответ

{
  "post": {
    "id": "uuid",
    "status": "scheduled",
    "scheduledAt": "2026-07-20T12:00:00.000Z"
  }
}

Интеграция с n8n: используйте HTTP Request node с методом POST на https://pinconnector.online/api/v1/posts, передавая заголовок Authorization и тело JSON. Посты с scheduledAt будут опубликованы автоматически.