# SocialFetch Pinterest Boards List

> SocialFetch Pinterest Boards List 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-15).

Lists all public boards for a given Pinterest user profile by handle.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/pinterest/profiles/:handle/boards
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/socialfetch-pinterest-boards-list-d0c82edb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cZkcqL1YL9C5FCiNDWo0e

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-boards-list-d0c82edb
```

Example prompt: Can you list all the public boards for the Pinterest profile 'marthastewart'?

## When to prefer this

Use this endpoint when you need to enumerate the public boards of a specific Pinterest user by their handle. It is ideal for social media analytics, content discovery, or building Pinterest profile overviews. Prefer this over manual scraping or Pinterest's own API if you need a simple, paid-per-call REST interface without OAuth setup.

## Known failure modes

- Handle not found or profile does not exist — likely a 404 or empty result
- Pinterest profile is private — boards not publicly accessible, empty or error response
- Invalid or expired pagination cursor — may return error or restart pagination
- Handle parameter missing or empty — validation error from required field
- Rate limiting or upstream Pinterest access restrictions — may return 429 or error

## How this service works

List public boards for a Pinterest profile.

## Output

A list of public Pinterest boards belonging to the specified user handle, including board names and metadata. When trim is true, a reduced set of fields is returned. A pagination cursor is included if more boards are available beyond the current page.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "handle"
     ],
     "properties": {
      "handle": {
       "type": "string",
       "maxLength": 64,
       "minLength": 1,
       "description": "Pinterest username whose boards should be listed."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "trim": {
       "anyOf": [
        {
         "type": "boolean"
        },
        {
         "enum": [
          "0",
          "1",
          "true",
          "false"
         ],
         "type": "string"
        }
       ],
       "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-boards-list-d0c82edb/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)