# 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/url-stats
Get Pinterest save counts for external URLs
Credit cost: 1 (standard)
Parameters:
- urls (required) — Comma-separated list of 1–10 absolute http(s):// URLs, passed to Pinterest verbatim. Variants (https vs http, with/without trailing slash, with/without query string) are counted as different URLs.
curl "https://www.socialcrawl.dev/v1/pinterest/url-stats?urls=https://www.allrecipes.com/recipe/10813/best-chocolate-chip-cookies/" \
  -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
- 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/lizmrodgers/moms-night/" \
  -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"