# List location posts

Lists the reproducible first page of public ranked posts embedded in an Instagram location page.

- Platform: [Instagram](https://docs.upscrape.com/docs/platforms/instagram)
- Capability ID: `instagram.location-posts.list`
- 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": {
    "limit": 5,
    "location_id": "213385402"
  },
  "capability": "instagram.location-posts.list"
}'
```

## Input


| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | `integer` | No | Maximum number of results to return. From 1 to 18. Default: `12`. |
| `location_id` | `string` | Yes | Numeric Instagram location ID |

### Example input

```json
{
  "limit": 5,
  "location_id": "213385402"
}
```

## 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
{
  "items": [
    {
      "data": {
        "accessibility_caption": null,
        "caption": {
          "created_at": 1787271483,
          "text": "Yesterday I was in LDN today I’m… Where am I again? 😅"
        },
        "carousel_media": [
          {
            "accessibility_caption": null,
            "id": "3968242297331946253",
            "image_versions2": {
              "candidates": [
                {
                  "height": 1760,
                  "width": 1320
                },
                {
                  "height": 1440,
                  "width": 1080
                },
                {
                  "height": 960,
                  "width": 720
                }
              ]
            },
            "media_type": 1,
            "original_height": 1760,
            "original_width": 1320,
            "pk": "3968242297331946253",
            "user": {
              "username": ""
            }
          },
          {
            "accessibility_caption": null,
            "id": "3968242305594759179",
            "image_versions2": {
              "candidates": [
                {
                  "height": 4096,
                  "width": 3072
                },
                {
                  "height": 1440,
                  "width": 1080
                },
                {
                  "height": 960,
                  "width": 720
                }
              ]
            },
            "media_type": 1,
            "original_height": 4096,
            "original_width": 3072,
            "pk": "3968242305594759179",
            "user": {
              "username": ""
            }
          },
          {
            "accessibility_caption": null,
            "id": "3968242331632814745",
            "image_versions2": {
              "candidates": [
                {
                  "height": 1760,
                  "width": 1320
                },
                {
                  "height": 1440,
                  "width": 1080
                },
                {
                  "height": 960,
                  "width": 720
                }
              ]
            },
            "media_type": 1,
            "original_height": 1760,
            "original_width": 1320,
            "pk": "3968242331632814745",
            "user": {
              "username": ""
            }
          }
        ],
        "carousel_media_count": 11,
        "coauthor_producers": [],
        "code": "DcSCDZgiUNC",
        "comment_count": 126,
        "has_audio": null,
        "id": "3968243251307692866",
        "image_versions2": {
          "candidates": [
            {
              "height": 1760,
              "width": 1320
            },
            {
              "height": 1440,
              "width": 1080
            },
            {
              "height": 960,
              "width": 720
            }
          ]
        },
        "is_paid_partnership": false,
        "like_and_view_counts_disabled": false,
        "like_count": 21693,
        "location": {
          "lat": 51.5141,
          "lng": -0.1094,
          "name": "London, United Kingdom",
          "pk": 106078429431815
        },
        "media_type": 8,
        "original_height": 1760,
        "original_width": 1320,
        "pk": "3968243251307692866",
        "product_type": "carousel_container",
        "taken_at": 1787271480,
        "user": {
          "id": "205238462",
          "is_verified": true,
          "pk": "205238462",
          "username": "taz_skylar"
        },
        "view_count": null
      }
    },
    {
      "data": {
        "accessibility_caption": null,
        "caption": {
          "created_at": 1787288340,
          "text": "🇬🇧💍📚 (se cierra el ciclo 🇦🇹🇬🇧) “Uno debería comenzar a amar para no caer enfermo, y está destinado a enfermar si, a consecuencia de la frustración, no puede amar.” S.Freud"
        },
        "carousel_media": [
          {
            "accessibility_caption": null,
            "id": "3968383902916730096",
            "image_versions2": {
              "candidates": [
                {
                  "height": 4032,
                  "width": 3024
                },
                {
                  "height": 1440,
                  "width": 1080
                },
                {
                  "height": 960,
                  "width": 720
                }
              ]
            },
            "media_type": 1,
            "original_height": 4032,
            "original_width": 3024,
            "pk": "3968383902916730096",
            "user": {
              "username": ""
            }
          },
          {
            "accessibility_caption": null,
            "id": "3968383908369316309",
            "image_versions2": {
              "candidates": [
                {
                  "height": 3458,
                  "width": 2596
                },
                {
                  "height": 1439,
                  "width": 1080
                },
                {
                  "height": 959,
                  "width": 720
                }
              ]
            },
            "media_type": 1,
            "original_height": 3458,
            "original_width": 2596,
            "pk": "3968383908369316309",
            "user": {
              "username": ""
            }
          },
          {
            "accessibility_caption": null,
            "id": "3968383911615710588",
            "image_versions2": {
              "candidates": [
                {
                  "height": 3088,
                  "width": 2316
                },
                {
                  "height": 1440,
                  "width": 1080
                },
                {
                  "height": 960,
                  "width": 720
                }
              ]
            },
            "media_type": 1,
            "original_height": 3088,
            "original_width": 2316,
            "pk": "3968383911615710588",
            "user": {
              "username": ""
            }
          }
        ],
        "carousel_media_count": 9,
        "coauthor_producers": [],
        "code": "DcSiMz-Djja",
        "comment_count": 1,
        "has_audio": null,
        "id": "3968384635683879130",
        "image_versions2": {
          "candidates": [
            {
              "height": 4032,
              "width": 3024
            },
            {
              "height": 1440,
              "width": 1080
            },
            {
              "height": 960,
              "width": 720
            }
          ]
        },
        "is_paid_partnership": false,
        "like_and_view_counts_disabled": false,
        "like_count": 1,
        "location": {
          "lat": 51.54829,
          "lng": -0.17745,
          "name": "Freud Museum London",
          "pk": 1875942
        },
        "media_type": 8,
        "original_height": 4032,
        "original_width": 3024,
        "pk": "3968384635683879130",
        "product_type": "carousel_container",
        "taken_at": 1787288334,
        "user": {
          "id": "1666255774",
          "is_verified": false,
          "pk": "1666255774",
          "username": "vazquez.u"
        },
        "view_count": null
      }
    },
    {
      "data": {
        "accessibility_caption": null,
        "caption": {
          "created_at": 1787283715,
          "text": "SIR ALEXANDER FLEMING\n#ビール #beer #london #ロンドン #pub\n★noteで秘湯宿レポを書いてます！プロフィールのURLより！@skychelsea"
        },
        "carousel_media": [
          {
            "accessibility_caption": null,
            "id": "3968345472720533646",
            "image_versions2": {
              "candidates": [
                {
                  "height": 3961,
                  "width": 3961
                },
                {
                  "height": 1080,
                  "width": 1080
                },
                {
                  "height": 720,
                  "width": 720
                }
              ]
            },
            "media_type": 1,
            "original_height": 3961,
            "original_width": 3961,
            "pk": "3968345472720533646",
            "user": {
              "username": ""
            }
          },
          {
            "accessibility_caption": null,
            "id": "3968345509705988213",
            "image_versions2": {
              "candidates": [
                {
                  "height": 4096,
                  "width": 4096
                },
                {
                  "height": 1080,
                  "width": 1080
                },
                {
                  "height": 720,
                  "width": 720
                }
              ]
            },
            "media_type": 1,
            "original_height": 4096,
            "original_width": 4096,
            "pk": "3968345509705988213",
            "user": {
              "username": ""
            }
          },
          {
            "accessibility_caption": null,
            "id": "3968345526080393597",
            "image_versions2": {
              "candidates": [
                {
                  "height": 4096,
                  "width": 4096
                },
                {
                  "height": 1080,
                  "width": 1080
                },
                {
                  "height": 720,
                  "width": 720
                }
              ]
            },
            "media_type": 1,
            "original_height": 4096,
            "original_width": 4096,
            "pk": "3968345526080393597",
            "user": {
              "username": ""
            }
          }
        ],
        "carousel_media_count": 20,
        "coauthor_producers": [],
        "code": "DcSZYhumDgm",
        "comment_count": 1,
        "has_audio": null,
        "id": "3968345858312255526",
        "image_versions2": {
          "candidates": [
            {
              "height": 3961,
              "width": 3961
            },
            {
              "height": 1080,
              "width": 1080
            },
            {
              "height": 720,
              "width": 720
            }
          ]
        },
        "is_paid_partnership": false,
        "like_and_view_counts_disabled": false,
        "like_count": 1,
        "location": {
          "lat": 51.518522,
          "lng": -0.172768,
          "name": "Paddington Basin",
          "pk": 103359869718421
        },
        "media_type": 8,
        "original_height": 3961,
        "original_width": 3961,
        "pk": "3968345858312255526",
        "product_type": "carousel_container",
        "taken_at": 1787283712,
        "user": {
          "id": "190546016",
          "is_verified": false,
          "pk": "190546016",
          "username": "skychelsea"
        },
        "view_count": null
      }
    }
  ],
  "summary": {
    "available_on_page": 15,
    "continuation_supported": false,
    "emitted": 5,
    "location_id": "213385402",
    "upstream_has_more": true
  }
}
```
### 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` | 3 items |
| `items` | `array` | 3 items |
| `summary` | `object` | 5 fields |
| `summary.available_on_page` | `integer` | 15 |
| `summary.continuation_supported` | `boolean` | false |
| `summary.emitted` | `integer` | 5 |
| `summary.location_id` | `string` | 213385402 |
| `summary.upstream_has_more` | `boolean` | true |

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