> ## 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 across all LinkedIn verticals



## OpenAPI

````yaml /openapi.json post /linkedin/search/all
openapi: 3.1.0
info:
  title: Bridgly API
  description: >-
    Web scraping API for LinkedIn, X (Twitter) and Reddit. Authenticated
    endpoints accept a Bridgly API key (`bgly_…`) via `Authorization: Bearer
    <token>`.
  version: 1.0.0
servers:
  - url: https://api.bridgly.app
    description: Production
  - url: http://localhost:4000
    description: Local
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.
paths:
  /linkedin/search/all:
    post:
      tags:
        - LinkedIn
      summary: Search across all LinkedIn verticals
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                keyword:
                  type: string
                  description: >-
                    Keyword(s) to search LinkedIn for, e.g. "openai", "software
                    engineer", "fintech".
                start:
                  description: Pagination offset into the result list. Defaults to 0.
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                count:
                  description: Number of results to return. Defaults to 10.
                  type: integer
                  minimum: 1
                  maximum: 9007199254740991
              required:
                - keyword
      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:
                      results:
                        type: array
                        items:
                          oneOf:
                            - type: object
                              properties:
                                profileUrn:
                                  type: string
                                  description: >-
                                    Stable profile identifier (always present),
                                    e.g. urn:li:fsd_profile:<opaqueId>.
                                publicIdentifier:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Public vanity handle from the /in/<id> URL;
                                    null for private members.
                                profileUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Canonical profile URL
                                    (https://www.linkedin.com/in/<handle>); null
                                    when the member is private / out-of-network
                                    and renders as an anonymous "LinkedIn
                                    Member".
                                memberUrn:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    urn:li:member:<numericId>; null for private
                                    "LinkedIn Member" results.
                                name:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Display name; "LinkedIn Member" when the
                                    profile is private/out-of-network.
                                headline:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Occupation / headline line.
                                location:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Location line, e.g. "Bengaluru", "Odisha,
                                    India".
                                summary:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Keyword-match snippet, when LinkedIn
                                    surfaces one.
                                profilePictureUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Largest available profile photo URL.
                                networkDistance:
                                  anyOf:
                                    - type: string
                                      enum:
                                        - self
                                        - 1st
                                        - 2nd
                                        - 3rd
                                        - out_of_network
                                      description: >-
                                        Connection degree relative to the
                                        searching account: self,
                                        1st/2nd/3rd-degree connection, or
                                        out_of_network (beyond 3rd, rendered
                                        "3rd+").
                                    - type: 'null'
                                  description: >-
                                    Connection degree relative to the searching
                                    account.
                                degreeBadge:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Human-facing degree label next to the name,
                                    e.g. "2nd", "3rd+".
                                verified:
                                  type: boolean
                                  description: >-
                                    Whether LinkedIn shows the blue verification
                                    badge.
                                insight:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Social-proof line, e.g. "1 mutual
                                    connection", "28K followers".
                                type:
                                  type: string
                                  enum:
                                    - person
                              required:
                                - profileUrn
                                - publicIdentifier
                                - profileUrl
                                - memberUrn
                                - name
                                - headline
                                - location
                                - summary
                                - profilePictureUrl
                                - networkDistance
                                - degreeBadge
                                - verified
                                - insight
                                - type
                              additionalProperties: false
                            - type: object
                              properties:
                                companyUrn:
                                  type: string
                                  description: >-
                                    Stable company identifier (always present),
                                    e.g. urn:li:fsd_company:<id>.
                                companyId:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Numeric company id parsed from the company
                                    URN, e.g. "24468".
                                universalName:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Vanity slug from the /company/<slug>/ URL,
                                    e.g. "ai4".
                                companyUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Canonical company page URL
                                    (https://www.linkedin.com/company/<slug>/).
                                name:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Company display name.
                                industry:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Industry, e.g. "IT Services and IT
                                    Consulting".
                                location:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Headquarters location line, e.g. "Brooklyn,
                                    New York".
                                followersLabel:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Follower count label as rendered by
                                    LinkedIn, e.g. "31K followers".
                                followersCount:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                  description: >-
                                    Approximate follower count parsed from the
                                    label (K/M suffixes expanded), e.g. 31000.
                                description:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Tagline / short description snippet.
                                logoUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Largest available company logo URL.
                                type:
                                  type: string
                                  enum:
                                    - company
                              required:
                                - companyUrn
                                - companyId
                                - universalName
                                - companyUrl
                                - name
                                - industry
                                - location
                                - followersLabel
                                - followersCount
                                - description
                                - logoUrl
                                - type
                              additionalProperties: false
                            - type: object
                              properties:
                                jobUrn:
                                  type: string
                                  description: >-
                                    Stable job identifier (always present), e.g.
                                    urn:li:fsd_jobPosting:<id>.
                                jobId:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Numeric job id parsed from the job URN, e.g.
                                    "4417164255".
                                jobUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Canonical job posting URL
                                    (https://www.linkedin.com/jobs/view/<id>/),
                                    tracking params stripped.
                                title:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Job title.
                                companyName:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Hiring company name.
                                companyUrn:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Hiring company URN resolved from the posting
                                    logo, e.g. urn:li:fsd_company:<id>.
                                companyId:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Numeric hiring-company id parsed from the
                                    company URN.
                                location:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Job location line, e.g. "India (Remote)".
                                listedAt:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Listing date in ISO-8601 (UTC), parsed from
                                    the posting's LISTED_DATE timestamp.
                                listedAtEpochMs:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                  description: >-
                                    Listing date as a Unix epoch in
                                    milliseconds, e.g. 1781870351000.
                                imageUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Hiring company logo URL.
                                type:
                                  type: string
                                  enum:
                                    - job
                              required:
                                - jobUrn
                                - jobId
                                - jobUrl
                                - title
                                - companyName
                                - companyUrn
                                - companyId
                                - location
                                - listedAt
                                - listedAtEpochMs
                                - imageUrl
                                - type
                              additionalProperties: false
                            - type: object
                              properties:
                                groupUrn:
                                  type: string
                                  description: >-
                                    Stable group identifier (always present),
                                    e.g. urn:li:fsd_group:<id>.
                                groupId:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Numeric group id parsed from the group URN,
                                    e.g. "62352".
                                groupUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Canonical group URL
                                    (https://www.linkedin.com/groups/<id>).
                                name:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Group name.
                                membersLabel:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Member count label as rendered by LinkedIn,
                                    e.g. "3M members", "629K members".
                                membersCount:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                  description: >-
                                    Approximate member count parsed from the
                                    label (K/M suffixes expanded).
                                description:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Group description / about text.
                                logoUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Largest available group logo URL.
                                type:
                                  type: string
                                  enum:
                                    - group
                              required:
                                - groupUrn
                                - groupId
                                - groupUrl
                                - name
                                - membersLabel
                                - membersCount
                                - description
                                - logoUrl
                                - type
                              additionalProperties: false
                            - type: object
                              properties:
                                productUrn:
                                  type: string
                                  description: >-
                                    Stable product identifier (always present),
                                    e.g. urn:li:organizationalPage:<id>.
                                productId:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Numeric product id parsed from the product
                                    URN, e.g. "87256149".
                                universalName:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Vanity slug from the /products/<slug>/ URL.
                                productUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Canonical product page URL
                                    (https://www.linkedin.com/products/<slug>/).
                                name:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Product name.
                                category:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Product category, e.g. "Customer
                                    Relationship Management (CRM) Software".
                                maker:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    The company that makes the product (the "by
                                    <maker>" segment).
                                description:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Product description / tagline.
                                topFeatures:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Comma-separated top features as surfaced by
                                    LinkedIn (raw human-readable text).
                                integrations:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Comma-separated notable integrations (raw
                                    human-readable text).
                                usedBy:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      companyUrn:
                                        type: string
                                        description: >-
                                          urn:li:fsd_company:<id> of a company
                                          that uses the product.
                                      companyId:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                        description: >-
                                          Numeric company id parsed from the
                                          company URN.
                                      name:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                        description: Company display name.
                                      companyUrl:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                        description: >-
                                          Canonical company page URL
                                          (https://www.linkedin.com/company/<slug>/).
                                    required:
                                      - companyUrn
                                      - companyId
                                      - name
                                      - companyUrl
                                    additionalProperties: false
                                  description: >-
                                    Named companies that use the product,
                                    resolved from the "Used by …" social-proof
                                    line.
                                usedByOthersCount:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                  description: >-
                                    Count of additional unnamed users beyond
                                    those listed in `usedBy` (the "and N others"
                                    remainder).
                                logoUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Largest available product logo URL.
                                type:
                                  type: string
                                  enum:
                                    - product
                              required:
                                - productUrn
                                - productId
                                - universalName
                                - productUrl
                                - name
                                - category
                                - maker
                                - description
                                - topFeatures
                                - integrations
                                - usedBy
                                - usedByOthersCount
                                - logoUrl
                                - type
                              additionalProperties: false
                            - type: object
                              properties:
                                courseUrn:
                                  type: string
                                  description: >-
                                    Stable course identifier (always present),
                                    e.g. urn:li:lyndaCourse:<id>.
                                courseId:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Numeric course id parsed from the course
                                    URN, e.g. "4571000".
                                universalName:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Vanity slug from the /learning/<slug> URL.
                                courseUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Canonical course URL (tracking/courseClaim
                                    query params stripped).
                                name:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Course title.
                                format:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Content format, e.g. "Course".
                                duration:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: >-
                                    Duration label as rendered by LinkedIn, e.g.
                                    "3h 43m".
                                durationMinutes:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                  description: >-
                                    Total course length in minutes, parsed from
                                    the duration label (e.g. "3h 43m" -> 223).
                                author:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Instructor / author name.
                                releasedDate:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Release date label, e.g. "Jan 9, 2025".
                                releasedYear:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                  description: >-
                                    Release year parsed from the release date
                                    label, e.g. 2025.
                                releasedMonth:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                  description: >-
                                    Release month (1-12) parsed from the release
                                    date label, e.g. 1 for January.
                                releasedDay:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                  description: >-
                                    Release day of month parsed from the release
                                    date label, e.g. 9.
                                thumbnailUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                  description: Largest available course thumbnail URL.
                                type:
                                  type: string
                                  enum:
                                    - course
                              required:
                                - courseUrn
                                - courseId
                                - universalName
                                - courseUrl
                                - name
                                - format
                                - duration
                                - durationMinutes
                                - author
                                - releasedDate
                                - releasedYear
                                - releasedMonth
                                - releasedDay
                                - thumbnailUrl
                                - type
                              additionalProperties: false
                        description: Ranked, interleaved results across every entity type.
                      keyword:
                        type: string
                        description: The keyword(s) that were searched on LinkedIn.
                      totalResultCount:
                        anyOf:
                          - type: number
                          - type: 'null'
                        description: >-
                          Total number of matching results reported by LinkedIn
                          (not the number returned in this page).
                    required:
                      - results
                      - keyword
                      - totalResultCount
                    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
        '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
        '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: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        A Bridgly API key (`bgly_…`). Metered endpoints deduct credits from the
        resolved account.

````