# SocialCrawl API — pinterest endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/pinterest

## GET /v1/pinterest/search
Search Pinterest pins
Credit cost: 1 (standard)
Parameters:
- query (required) — Search query
- cursor (optional, string) — Cursor
- trim (optional, boolean) — Set to true for a trimmed down version of the response
curl "https://www.socialcrawl.dev/v1/pinterest/search?query=home decor ideas" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/pinterest/pin
Get Pinterest pin details
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the Pinterest pin
- trim (optional, boolean) — Set to true for a trimmed down version of the response
curl "https://www.socialcrawl.dev/v1/pinterest/pin?url=https://www.pinterest.com/pin/1234567890/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/pinterest/board
Get Pinterest board
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the Pinterest board
- cursor (optional, string) — The cursor to get the next page of results
- trim (optional, boolean) — Set to true for a trimmed down version of the response
curl "https://www.socialcrawl.dev/v1/pinterest/board?url=https://www.pinterest.com/pinterest/official-pinterest-pins/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/pinterest/user/boards
List Pinterest user boards
Credit cost: 1 (standard)
Parameters:
- handle (required) — The username of the user to get boards for. (e.g. broadstbullycom from https://www.pinterest.com/broadstbullycom/)
- trim (optional, boolean) — Set to true for a trimmed down version of the response
curl "https://www.socialcrawl.dev/v1/pinterest/user/boards?handle=pinterest" \
  -H "x-api-key: sc_your_api_key_here"