> ## Documentation Index > Fetch the complete documentation index at: https://docs.bridgly.app/llms.txt > Use this file to discover all available pages before exploring further. # List posts at a location > List posts Instagram associates with a location, including captions, image and video URLs, publish times, engagement counts, tagged users and place details. Results use Instagram’s ranked order and may include nearby places. Continue with nextCursor. Costs 1 credit per result returned, with a minimum of 1 credit per request. ## OpenAPI ````yaml /openapi.json post /instagram/location-posts openapi: 3.1.0 info: title: Bridgly API description: >- Web scraping API for LinkedIn, X (Twitter), Reddit, GitHub, Instagram and TikTok. Authenticated endpoints accept a Bridgly API key (`bgly_…`) via `Authorization: Bearer `. version: 1.0.0 servers: - url: https://api.bridgly.app description: Production security: [] tags: - name: LinkedIn description: Scrape LinkedIn profiles, companies, posts, and search. - name: Reddit description: Scrape Reddit posts, subreddits, users, and search. - name: X (Twitter) description: Scrape tweets and search X. - name: GitHub description: >- Fetch GitHub profiles, pinned repos, contributions, repositories, stars, and projects via GitHub's GraphQL API. - name: Instagram description: Scrape Instagram profiles, posts, followers, and search. - name: TikTok description: Fetch TikTok profiles. paths: /instagram/location-posts: post: tags: - Instagram summary: List posts at a location description: >- List posts Instagram associates with a location, including captions, image and video URLs, publish times, engagement counts, tagged users and place details. Results use Instagram’s ranked order and may include nearby places. Continue with nextCursor. Costs 1 credit per result returned, with a minimum of 1 credit per request. requestBody: required: true content: application/json: schema: type: object properties: locationId: type: string minLength: 1 description: >- Numeric Instagram location ID or an instagram.com/explore/locations// link. count: default: 10 description: Number of results to return (1–10). Defaults to 10. type: integer minimum: 1 maximum: 10 cursor: description: >- The previous response's `nextCursor`, to fetch the next page. Omit it for the first page. type: string required: - locationId responses: '200': description: Default Response content: application/json: schema: type: object properties: timeMs: type: number description: >- Wall-clock time the request took to complete, in milliseconds. creditsCost: type: number description: Number of account credits this request consumed. data: type: object properties: nextCursor: anyOf: - type: string - type: 'null' description: >- Pass as `cursor` to fetch the next page; null when there are no more results. A page can hold fewer results than asked for, so keep paging until it is null. posts: type: array items: type: object properties: id: type: string type: anyOf: - type: string enum: - Image - Video - Carousel - type: 'null' display_url: anyOf: - type: string - type: 'null' video_url: anyOf: - type: string - type: 'null' width: anyOf: - type: number - type: 'null' height: anyOf: - type: number - type: 'null' video_duration: description: Video duration in seconds. anyOf: - type: number - type: 'null' accessibility_caption: anyOf: - type: string - type: 'null' image_versions: anyOf: - type: array items: type: object properties: url: type: string width: anyOf: - type: number - type: 'null' height: anyOf: - type: number - type: 'null' required: - url additionalProperties: false - type: 'null' video_versions: anyOf: - type: array items: type: object properties: url: type: string width: anyOf: - type: number - type: 'null' height: anyOf: - type: number - type: 'null' type: description: Instagram video rendition type. anyOf: - type: number - type: 'null' required: - url additionalProperties: false - type: 'null' has_audio: anyOf: - type: boolean - type: 'null' video_dash_manifest: description: MPEG-DASH playback manifest. anyOf: - type: string - type: 'null' number_of_qualities: anyOf: - type: number - type: 'null' carousel_parent_id: anyOf: - type: string - type: 'null' user_tags: anyOf: - type: array items: type: object properties: user: type: object properties: id: type: string username: anyOf: - type: string - type: 'null' full_name: anyOf: - type: string - type: 'null' profile_pic_url: anyOf: - type: string - type: 'null' is_private: anyOf: - type: boolean - type: 'null' is_verified: anyOf: - type: boolean - type: 'null' profile_pic_id: anyOf: - type: string - type: 'null' latest_reel_media: description: >- Latest story publish time as Unix seconds; zero means no recent story. anyOf: - type: number - type: 'null' is_mentionable: anyOf: - type: boolean - type: 'null' required: - id additionalProperties: false position: description: >- Tag coordinates relative to the image width and height. anyOf: - type: array items: type: number - type: 'null' required: - user additionalProperties: false - type: 'null' shortcode: anyOf: - type: string - type: 'null' url: anyOf: - type: string - type: 'null' caption: anyOf: - type: string - type: 'null' likes: anyOf: - type: number - type: 'null' comments: anyOf: - type: number - type: 'null' timestamp: anyOf: - type: number - type: 'null' is_video: anyOf: - type: boolean - type: 'null' video_view_count: anyOf: - type: number - type: 'null' owner: anyOf: - type: object properties: id: type: string username: anyOf: - type: string - type: 'null' full_name: anyOf: - type: string - type: 'null' profile_pic_url: anyOf: - type: string - type: 'null' is_private: anyOf: - type: boolean - type: 'null' is_verified: anyOf: - type: boolean - type: 'null' profile_pic_id: anyOf: - type: string - type: 'null' latest_reel_media: description: >- Latest story publish time as Unix seconds; zero means no recent story. anyOf: - type: number - type: 'null' is_mentionable: anyOf: - type: boolean - type: 'null' required: - id additionalProperties: false - type: 'null' carousel_media: anyOf: - type: array items: type: object properties: id: type: string type: anyOf: - type: string enum: - Image - Video - Carousel - type: 'null' display_url: anyOf: - type: string - type: 'null' video_url: anyOf: - type: string - type: 'null' width: anyOf: - type: number - type: 'null' height: anyOf: - type: number - type: 'null' video_duration: description: Video duration in seconds. anyOf: - type: number - type: 'null' accessibility_caption: anyOf: - type: string - type: 'null' image_versions: anyOf: - type: array items: type: object properties: url: type: string width: anyOf: - type: number - type: 'null' height: anyOf: - type: number - type: 'null' required: - url additionalProperties: false - type: 'null' video_versions: anyOf: - type: array items: type: object properties: url: type: string width: anyOf: - type: number - type: 'null' height: anyOf: - type: number - type: 'null' type: description: Instagram video rendition type. anyOf: - type: number - type: 'null' required: - url additionalProperties: false - type: 'null' has_audio: anyOf: - type: boolean - type: 'null' video_dash_manifest: description: MPEG-DASH playback manifest. anyOf: - type: string - type: 'null' number_of_qualities: anyOf: - type: number - type: 'null' carousel_parent_id: anyOf: - type: string - type: 'null' user_tags: anyOf: - type: array items: type: object properties: user: type: object properties: id: type: string username: anyOf: - type: string - type: 'null' full_name: anyOf: - type: string - type: 'null' profile_pic_url: anyOf: - type: string - type: 'null' is_private: anyOf: - type: boolean - type: 'null' is_verified: anyOf: - type: boolean - type: 'null' profile_pic_id: anyOf: - type: string - type: 'null' latest_reel_media: description: >- Latest story publish time as Unix seconds; zero means no recent story. anyOf: - type: number - type: 'null' is_mentionable: anyOf: - type: boolean - type: 'null' required: - id additionalProperties: false position: description: >- Tag coordinates relative to the image width and height. anyOf: - type: array items: type: number - type: 'null' required: - user additionalProperties: false - type: 'null' required: - id additionalProperties: false - type: 'null' caption_id: anyOf: - type: string - type: 'null' caption_created_at: description: Caption creation time as Unix seconds. anyOf: - type: number - type: 'null' caption_is_edited: anyOf: - type: boolean - type: 'null' caption_has_translation: anyOf: - type: boolean - type: 'null' product_type: anyOf: - type: string - type: 'null' play_count: anyOf: - type: number - type: 'null' comments_disabled: anyOf: - type: boolean - type: 'null' like_and_view_counts_disabled: anyOf: - type: boolean - type: 'null' is_paid_partnership: anyOf: - type: boolean - type: 'null' coauthors: anyOf: - type: array items: type: object properties: id: type: string username: anyOf: - type: string - type: 'null' full_name: anyOf: - type: string - type: 'null' profile_pic_url: anyOf: - type: string - type: 'null' is_private: anyOf: - type: boolean - type: 'null' is_verified: anyOf: - type: boolean - type: 'null' profile_pic_id: anyOf: - type: string - type: 'null' latest_reel_media: description: >- Latest story publish time as Unix seconds; zero means no recent story. anyOf: - type: number - type: 'null' is_mentionable: anyOf: - type: boolean - type: 'null' required: - id additionalProperties: false - type: 'null' pinned_user_ids: description: Profiles where this post is pinned. anyOf: - type: array items: type: string - type: 'null' carousel_media_count: anyOf: - type: number - type: 'null' location: anyOf: - type: object properties: id: type: string name: anyOf: - type: string - type: 'null' slug: anyOf: - type: string - type: 'null' url: type: string latitude: anyOf: - type: number - type: 'null' longitude: anyOf: - type: number - type: 'null' category: anyOf: - type: string - type: 'null' posts_count: anyOf: - type: number - type: 'null' address: anyOf: - type: string - type: 'null' city: anyOf: - type: string - type: 'null' postal_code: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' price_range: description: >- Instagram’s numeric price range for the place. anyOf: - type: number - type: 'null' hours_status: anyOf: - type: string - type: 'null' required: - id - url additionalProperties: false - type: 'null' required: - id additionalProperties: false required: - nextCursor - posts additionalProperties: false required: - timeMs - creditsCost - data additionalProperties: false '400': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false '401': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false '402': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false '403': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false '422': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false '500': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false security: - bearerAuth: [] x-codeSamples: - lang: typescript label: Bridgly SDK source: |- import { Bridgly } from '@bridgly/sdk'; const client = new Bridgly({ apiKey: process.env.BRIDGLY_API_KEY }); const res = await client.instagram.getLocationPosts({ locationId: "string", count: 10, }); if (res.type === 'success') console.log(res.data); components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- A Bridgly API key (`bgly_…`). Metered endpoints deduct credits from the resolved account. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.