# Get section

Collect section pins in resumable chunks of up to 1,000, with reported counts and explicit incomplete outcomes.

- Platform: [Pinterest](https://docs.upscrape.com/docs/platforms/pinterest)
- Capability ID: `pinterest.section.get`
- Cost: 1 credit per request
- Maximum runtime: 60 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 $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "url": "https://www.pinterest.com/ashishbishnoi18/myboard/mysection/"
  },
  "capability": "pinterest.section.get"
}'
```

## Input


| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cursor` | `string` | No | Opaque pagination.next_cursor from the previous response. Keep the same URL and section selection. |
| `max_pins` | `integer` | No | Optional pin bound for this response. Each response returns at most 1,000 pins; follow pagination.next_cursor while has_more is true. Zero uses the default chunk bound. At least 0. |
| `url` | `string` | Yes | Full Pinterest section URL |

### Example input

```json
{
  "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 example shows one response. Values and optional fields vary with the data available.

```json
{
  "outcome": {
    "reason": "page_finished",
    "status": "complete"
  },
  "pagination": {
    "has_more": false,
    "retrieved_total": 6
  },
  "reported_pin_count": 6,
  "section": {
    "id": "5469010104714075890",
    "pin_count": 6,
    "pins": [
      {
        "board": {
          "id": "64950488315410023",
          "is_collaborative": false,
          "pin_count": 0,
          "privacy": "public",
          "section_count": 0,
          "url": "/ashishbishnoi18/myboard/"
        },
        "favorite_count": 0,
        "has_products": false,
        "id": "64950419623552970",
        "images": {
          "170x": {
            "height": 419,
            "url": "https://i.pinimg.com/236x/4a/ba/b4/4abab487c45905abb79fcc5abf3acac3.jpg",
            "width": 236
          },
          "236x": {
            "height": 419,
            "url": "https://i.pinimg.com/236x/4a/ba/b4/4abab487c45905abb79fcc5abf3acac3.jpg",
            "width": 236
          },
          "474x": {
            "height": 842,
            "url": "https://i.pinimg.com/474x/4a/ba/b4/4abab487c45905abb79fcc5abf3acac3.jpg",
            "width": 474
          },
          "736x": {
            "height": 1308,
            "url": "https://i.pinimg.com/736x/4a/ba/b4/4abab487c45905abb79fcc5abf3acac3.jpg",
            "width": 736
          },
          "orig": {
            "height": 1920,
            "url": "https://i.pinimg.com/originals/4a/ba/b4/4abab487c45905abb79fcc5abf3acac3.jpg",
            "width": 1080
          }
        },
        "is_native": false,
        "is_promoted": false,
        "is_repin": true,
        "is_story_pin": true,
        "is_video": true,
        "media_detection": "confirmed",
        "media_type": "video",
        "page_count": 1,
        "repin_count": 0,
        "save_count": 23571,
        "video_url": "https://v1.pinimg.com/videos/iht/720p/ae/bc/d2/aebcd2c0e48476eebf1a663db0dc5b8b.mp4"
      },
      {
        "board": {
          "id": "64950488315410023",
          "is_collaborative": false,
          "pin_count": 0,
          "privacy": "public",
          "section_count": 0,
          "url": "/ashishbishnoi18/myboard/"
        },
        "favorite_count": 0,
        "has_products": false,
        "id": "64950419623552909",
        "images": {
          "170x": {
            "height": 419,
            "url": "https://i.pinimg.com/236x/05/83/d0/0583d04b766b56116e58f6eec3607505.jpg",
            "width": 236
          },
          "236x": {
            "height": 419,
            "url": "https://i.pinimg.com/236x/05/83/d0/0583d04b766b56116e58f6eec3607505.jpg",
            "width": 236
          },
          "474x": {
            "height": 842,
            "url": "https://i.pinimg.com/474x/05/83/d0/0583d04b766b56116e58f6eec3607505.jpg",
            "width": 474
          },
          "736x": {
            "height": 1280,
            "url": "https://i.pinimg.com/736x/05/83/d0/0583d04b766b56116e58f6eec3607505.jpg",
            "width": 720
          },
          "orig": {
            "height": 1280,
            "url": "https://i.pinimg.com/originals/05/83/d0/0583d04b766b56116e58f6eec3607505.jpg",
            "width": 720
          }
        },
        "is_native": false,
        "is_promoted": false,
        "is_repin": true,
        "is_story_pin": true,
        "is_video": false,
        "media_detection": "unverified",
        "media_type": "unknown",
        "page_count": 1,
        "repin_count": 0,
        "save_count": 2
      },
      {
        "board": {
          "id": "64950488315410023",
          "is_collaborative": false,
          "pin_count": 0,
          "privacy": "public",
          "section_count": 0,
          "url": "/ashishbishnoi18/myboard/"
        },
        "favorite_count": 0,
        "has_products": false,
        "id": "64950419623552908",
        "images": {
          "170x": {
            "height": 419,
            "url": "https://i.pinimg.com/236x/14/31/7a/14317ae457ac9f50234dde0efa352404.jpg",
            "width": 236
          },
          "236x": {
            "height": 419,
            "url": "https://i.pinimg.com/236x/14/31/7a/14317ae457ac9f50234dde0efa352404.jpg",
            "width": 236
          },
          "474x": {
            "height": 842,
            "url": "https://i.pinimg.com/474x/14/31/7a/14317ae457ac9f50234dde0efa352404.jpg",
            "width": 474
          },
          "736x": {
            "height": 1308,
            "url": "https://i.pinimg.com/736x/14/31/7a/14317ae457ac9f50234dde0efa352404.jpg",
            "width": 736
          },
          "orig": {
            "height": 1920,
            "url": "https://i.pinimg.com/originals/14/31/7a/14317ae457ac9f50234dde0efa352404.jpg",
            "width": 1080
          }
        },
        "is_native": false,
        "is_promoted": false,
        "is_repin": true,
        "is_story_pin": false,
        "is_video": false,
        "media_detection": "unverified",
        "media_type": "unknown",
        "repin_count": 0,
        "save_count": 4
      }
    ]
  }
}
```
### Illustrative output fields

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

| Path | Observed type | Example |
| --- | --- | --- |
| `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 |
| `reported_pin_count` | `integer` | 6 |
| `section` | `object` | 3 fields |
| `section.id` | `string` | 5469010104714075890 |
| `section.pin_count` | `integer` | 6 |
| `section.pins` | `array` | 3 items |

## 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)