# SocialFetch Pinterest Board Pins Lister

> SocialFetch Pinterest Board Pins Lister is a paid API for AI agents from api.socialfetch.dev, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-13).

Fetches a paginated list of public pins from a Pinterest board given its URL.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/pinterest/boards/pins
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/socialfetch-pinterest-board-pins-lister-f2797df7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y1lj6EZ_JjZBACdeAXsCh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability socialfetch-pinterest-board-pins-lister-f2797df7
```

Example prompt: Can you fetch all the public pins from this Pinterest board for me? Here's the URL: https://www.pinterest.com/exampleuser/my-travel-board/

## When to prefer this

Use this endpoint when you need to programmatically list or scrape the public pins of a Pinterest board given its URL, especially when building social media monitoring tools, content aggregators, or research pipelines targeting Pinterest data. Prefer this over manual scraping or Pinterest's own API when you need a simple pay-per-call REST interface without OAuth setup.

## Known failure modes

- Invalid or private Pinterest board URL returns an error or empty result
- Board does not exist or has been deleted — returns not found error
- Pagination cursor is invalid or expired — returns cursor error
- Rate limiting or payment failure results in 402 or 429 response
- Network timeout if Pinterest is slow to respond

## How this service works

List public pins on a Pinterest board by URL.

## Output

A list of public pins from the specified Pinterest board, each with pin metadata (image, title, description, link, etc.), plus an opaque pagination cursor for retrieving the next page of results. If trim=true, a smaller response with fewer fields per pin is returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 4096,
       "minLength": 1,
       "description": "Link to the Pinterest board."
      },
      "trim": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "boolean"
        }
       ],
       "description": "When true, returns a smaller response with fewer fields."
      },
      "cursor": {
       "type": "string",
       "minLength": 1,
       "description": "Opaque pagination cursor returned by a previous response."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/socialfetch-pinterest-board-pins-lister-f2797df7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.socialfetch.dev](https://www.zero.xyz/host/api.socialfetch.dev/llms.txt)