> ## Documentation Index
> Fetch the complete documentation index at: https://info.bundle.social/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Linkedin mentionable tags (people & organizations)

> Search for LinkedIn people and organizations that can be @-mentioned, and get the tag IDs needed to insert them into post text. LinkedIn only renders a mention when the display text matches the entity's name exactly (case sensitive), so a vanity slug never works. When a person is resolved from `url` but LinkedIn does not expose their name, the tag comes back with an empty `display` and `needsDisplayName: true` — pass `displayName` to set it. Note that a page can only mention its own followers.



## OpenAPI

````yaml https://api.bundle.social/swagger-json get /api/v1/misc/linkedin/mentions/tags
openapi: 3.0.2
info:
  title: bundle.social API
  description: >-
    REST API for social media management. Perfect for AI assistants, GPTs,
    automation tools, and integrations. Post to 14+ platforms including Twitter,
    Instagram, Facebook, LinkedIn, TikTok, Pinterest, Reddit, Discord, Slack,
    YouTube, Mastodon, Bluesky, Threads, and Google Business. Schedule posts,
    manage content, analyze performance, and automate your social media workflow
    across all platforms.
  version: 1.0.0
  contact:
    email: contact@bundle.social
  termsOfService: https://bundle.social/terms
servers:
  - url: https://api.bundle.social
  - url: http://localhost:3001
security:
  - ApiKeyAuth: []
tags:
  - name: app
  - name: organization
  - name: team
  - name: socialAccount
  - name: upload
  - name: post
  - name: postImport
  - name: analytics
  - name: comment
  - name: misc
  - name: postCSV
paths:
  /api/v1/misc/linkedin/mentions/tags:
    get:
      tags:
        - misc
      summary: Get Linkedin mentionable tags (people & organizations)
      description: >-
        Search for LinkedIn people and organizations that can be @-mentioned,
        and get the tag IDs needed to insert them into post text. LinkedIn only
        renders a mention when the display text matches the entity's name
        exactly (case sensitive), so a vanity slug never works. When a person is
        resolved from `url` but LinkedIn does not expose their name, the tag
        comes back with an empty `display` and `needsDisplayName: true` — pass
        `displayName` to set it. Note that a page can only mention its own
        followers.
      operationId: misc.linkedin.getTags
      parameters:
        - name: teamId
          in: query
          required: true
          schema:
            type: string
        - name: q
          in: query
          schema:
            type: string
            minLength: 1
        - name: url
          in: query
          schema:
            type: string
            minLength: 1
            maxLength: 2048
        - name: displayName
          in: query
          schema:
            type: string
            minLength: 1
            maxLength: 200
        - name: scope
          in: query
          schema:
            default: all
            type: string
            enum:
              - people
              - organizations
              - all
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  people:
                    default: []
                    type: array
                    items:
                      type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - person
                        urn:
                          type: string
                        display:
                          type: string
                          description: >-
                            Text to render the mention with. Empty when LinkedIn
                            did not give us the member's name — see
                            needsDisplayName.
                        headline:
                          type: string
                        photoUrl:
                          type: string
                          format: uri
                        needsDisplayName:
                          type: boolean
                          description: >-
                            True when the member was resolved but their name was
                            not. Supply the name yourself: LinkedIn only renders
                            a mention when the text matches the member's name
                            exactly (case sensitive), so a vanity slug never
                            works.
                      required:
                        - kind
                        - urn
                        - display
                  organizations:
                    default: []
                    type: array
                    items:
                      type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - organization
                        urn:
                          type: string
                        display:
                          type: string
                        vanityName:
                          type: string
                        logoUrl:
                          type: string
                          format: uri
                      required:
                        - kind
                        - urn
                        - display
        '400':
          description: '400'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                  issues:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - invalid_type
                            - invalid_literal
                            - custom
                            - invalid_union
                            - invalid_union_discriminator
                            - invalid_enum_value
                            - unrecognized_keys
                            - invalid_arguments
                            - invalid_return_type
                            - invalid_date
                            - invalid_string
                            - too_small
                            - too_big
                            - invalid_intersection_types
                            - not_multiple_of
                            - not_finite
                          nullable: true
                        message:
                          type: string
                        path:
                          type: array
                          items:
                            oneOf:
                              - type: string
                              - type: number
                          nullable: true
                      required:
                        - message
                    nullable: true
                required:
                  - message
        '401':
          description: '401'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                required:
                  - message
        '403':
          description: '403'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                required:
                  - message
        '404':
          description: '404'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                required:
                  - message
        '429':
          description: '429'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                required:
                  - message
        '500':
          description: '500'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                required:
                  - message
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: x-api-key
      in: header

````