# BlogToPin

> BlogToPin is a Pinterest automation platform: AI-generated pin images and pin texts, smart scheduling, and multi-site management for blogs, Shopify, Etsy, YouTube, Amazon, Medium, and more.

## Docs

- [BlogToPin](https://blogtopin.com): Product site and dashboard. Sign in to connect websites and create API keys (Settings → API).
- [Public API v1 reference](https://github.com/BlogToPin/blogtopin/blob/main/docs/API_V1.md): Full endpoint documentation for the REST API.

## API

REST API v1 served under `/api/v1`, authenticated with `Authorization: Bearer btp_<key>` API keys created in the dashboard.

- Websites: list connected websites (`GET /api/v1/websites`)
- Pins: list, update, and delete scheduled pins (`GET /api/v1/websites/:id/pins`, `PATCH /api/v1/pins/:id`, `DELETE /api/v1/pins/:id`)
- Boards: list Pinterest boards per website (`GET /api/v1/websites/:id/boards`)
- Pin generation: enqueue AI pin generation for a website (`POST /api/v1/websites/:id/generate`)
- AI text generation: generate pin titles and descriptions (`POST /api/v1/ai/pin-texts`)
- Credits: check AI credit balances (`GET /api/v1/credits`, `GET /api/v1/me`)
- OpenRouter BYOK settings: set or clear your own OpenRouter key and model (`PUT /api/v1/settings/openrouter`, `DELETE /api/v1/settings/openrouter`)

## Tools for AI agents

- [blogtopin-cli](https://www.npmjs.com/package/blogtopin-cli): Command-line client for the BlogToPin API — manage websites, pins, boards, credits, and BYOK settings from a terminal or scripts.
- [Hosted MCP](https://api.blogtopin.com/mcp): Streamable HTTP MCP server. Authenticate every request with `Authorization: Bearer YOUR_API_KEY`. Exposes tools including list_websites, list_pins, generate_ai_pins, schedule_ai_pins, get_analytics, generate_pin_texts, and Pinterest keyword research. No npm install required.
- [blogtopin-mcp](https://www.npmjs.com/package/blogtopin-mcp): Optional local stdio client for the same tools.

## Bring your own model

Users can attach their own OpenRouter API key and pick any OpenRouter model. When configured, all pin text generation (bulk generation, regeneration, board selection, and the pin-texts endpoint) runs on the user's key and model; vision, alt-text, and AI image generation stay on platform models.

## Optional

- [Blog](https://www.blogtopin.com/blog): Tips, tutorials, and product updates.
- [Free Pinterest tools](https://www.blogtopin.com/free-tools/pinterest-title-description-generator): Hashtag, title/description, bio, and keyword generators.
- [Terms](https://www.blogtopin.com/terms-and-conditions) and [Privacy Policy](https://www.blogtopin.com/privacy-policy).