# List Section Pins

Returns one bounded page of public section pins plus pagination.next_cursor. Keep requesting with cursor until pagination.has_more is false. Designed for large-section backups and resumable collection. Pin media includes video_url when recovered plus explicit media_type and media_detection evidence.

- Platform: [Pinterest](https://docs.upscrape.com/docs/platforms/pinterest)
- Capability ID: `pinterest.section-pins.list`
- Cost: 1 credit per request
- Maximum runtime: 45 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "limit": 25,
    "url": "https://www.pinterest.com/ashishbishnoi18/myboard/mysection/"
  },
  "capability": "pinterest.section-pins.list"
}'
```

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cursor` | `string` | No | Opaque continuation cursor returned by the previous page |
| `limit` | `integer` | No | Maximum pins returned in this page |
| `url` | `string` | Yes | Full public Pinterest section URL |

### Example input

```json
{
  "limit": 25,
  "url": "https://www.pinterest.com/ashishbishnoi18/myboard/mysection/"
}
```

## Response

Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This redacted fixture is an example, not a fixed response schema.

```json
{
  "items": [
    {
      "board": {
        "id": "64950488315410023",
        "is_collaborative": false,
        "name": "myboard",
        "pin_count": 0,
        "privacy": "public",
        "url": "/ashishbishnoi18/myboard/"
      },
      "description": " ",
      "domain": "Uploaded by user",
      "dominant_color": "#746c57",
      "favorite_count": 0,
      "has_products": false,
      "id": "64950419623552970",
      "images": {
        "236x": {
          "height": 419,
          "url": "https://i.pinimg.com/236x/4a/ba/b4/4abab487c45905abb79fcc5abf3acac3.jpg",
          "width": 236
        },
        "orig": {
          "height": 1920,
          "url": "https://i.pinimg.com/originals/4a/ba/b4/4abab487c45905abb79fcc5abf3acac3.jpg",
          "width": 1080
        }
      },
      "is_native": true,
      "is_promoted": false,
      "is_repin": true,
      "is_story_pin": true,
      "is_video": true,
      "media_detection": "confirmed",
      "media_type": "video",
      "native_creator": {
        "full_name": "[redacted]",
        "username": "[redacted]",
        "verified_identity": {
          "verified": false
        }
      },
      "pinner": {
        "full_name": "[redacted]",
        "username": "ashishbishnoi18",
        "verified_identity": {
          "verified": false
        }
      },
      "repin_count": 0,
      "save_count": 23436,
      "video_url": "https://v1.pinimg.com/videos/iht/720p/ae/bc/d2/aebcd2c0e48476eebf1a663db0dc5b8b.mp4"
    }
  ],
  "outcome": {
    "reason": "page_finished",
    "status": "complete"
  },
  "pagination": {
    "has_more": false,
    "retrieved_total": 6
  },
  "section": {
    "board_id": "64950488315410023",
    "id": "5469010104714075890",
    "pin_count": 6,
    "slug": "mysection",
    "title": "mysection"
  }
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `items` | `array` | 1 items |
| `items` | `array` | 1 items |
| `outcome` | `object` | 2 fields |
| `outcome.reason` | `string` | page_finished |
| `outcome.status` | `string` | complete |
| `pagination` | `object` | 2 fields |
| `pagination.has_more` | `boolean` | false |
| `pagination.retrieved_total` | `integer` | 6 |
| `section` | `object` | 5 fields |
| `section.board_id` | `string` | 64950488315410023 |
| `section.id` | `string` | 5469010104714075890 |
| `section.pin_count` | `integer` | 6 |
| `section.slug` | `string` | mysection |
| `section.title` | `string` | mysection |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)