# Social Fetch API - Pinterest endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

4 documented Pinterest operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/pinterest/search
Search Pinterest pins
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/pinterest/search/get.mdx
SDK: client.pinterest.searchPins({ query })
Parameters:
- query (required, string) - Search query text for Pinterest pins.
- cursor (optional, string) - Opaque pagination cursor returned by a previous response.
- trim (optional) - When true, returns a smaller response with fewer fields.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/pinterest/search?query=Italian Pot Roast" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/pinterest/pins
Get Pinterest pin
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/pinterest/pins/get.mdx
SDK: client.pinterest.getPin({ url })
Parameters:
- url (required, string) - Link to the Pinterest pin.
- trim (optional) - When true, returns a smaller response with fewer fields.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/pinterest/pins?url=https://www.pinterest.com/pin/1124351863225567517/" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/pinterest/profiles/{handle}/boards
List Pinterest profile boards
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/pinterest/profiles/handle/boards/get.mdx
SDK: client.pinterest.listProfileBoards({ handle })
Parameters:
- handle (required, string) - Pinterest username whose boards should be listed.
- cursor (optional, string) - Opaque pagination cursor returned by a previous response.
- trim (optional) - When true, returns a smaller response with fewer fields.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/pinterest/profiles/broadstbullycom/boards" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/pinterest/boards/pins
List Pinterest board pins
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/pinterest/boards/pins/get.mdx
SDK: client.pinterest.listBoardPins({ url })
Parameters:
- url (required, string) - Link to the Pinterest board.
- cursor (optional, string) - Opaque pagination cursor returned by a previous response.
- trim (optional) - When true, returns a smaller response with fewer fields.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/pinterest/boards/pins?url=https://www.pinterest.com/lizmrodgers/moms-night/" \
  -H "x-api-key: YOUR_API_KEY"