> ## 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. # Search posts by keyword or hashtag > Search public Instagram posts and Reels by keyword or hashtag. Returns media links, captions, publish times, engagement counts and owner details, with nextCursor for more results. Search results reflect Instagram’s ranking and available content. Costs 1 credit per result returned, with a minimum of 1 credit per request. ## OpenAPI ````yaml /openapi.json post /instagram/search 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/search: post: tags: - Instagram summary: Search posts by keyword or hashtag description: >- Search public Instagram posts and Reels by keyword or hashtag. Returns media links, captions, publish times, engagement counts and owner details, with nextCursor for more results. Search results reflect Instagram’s ranking and available content. Costs 1 credit per result returned, with a minimum of 1 credit per request. requestBody: required: true content: application/json: schema: type: object properties: query: type: string minLength: 1 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: - query 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.searchPosts({ query: "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.