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

# LinkedIn profile reactions

> A bounded window of up to 20 public member reactions. Canonical post wrappers retain reaction activity separately. Date bounds filter post publication within this window; unknown dates remain included. The source is not date-sorted and does not expose continuation or exhaustive totals. Optional urn validates the returned member but does not reduce source calls. Invalid inputs and all failures cost zero; a filtered empty window costs zero. An empty upstream dataset cannot establish a valid empty profile and fails uncharged. Finite trial capacity is bounded by a shared ten-run limit; sustained production funding is not configured.

Pass a canonical public profile URL, for example `https://www.linkedin.com/in/satyanadella/`. The response contains at most **20 source-ranked activities**, not the member's full history. The source does not expose continuation, an exhaustive total or guaranteed date ordering; `complete` is false and `next_cursor` / `total` are null.

Each item has a canonical `post`, null AI `computed` fields and a separate `activity` with the reacting member and reaction date. `since` and `until` filter **post publication**, not reaction time. Bounds apply only to this limited window; unknown dates are retained. An empty filtered result is free.

Post activity IDs can differ from the public UGC URL ID. The adapter checks the source relationship and preserves both identifiers under `post.ext`. Hidden or missing counters remain null. A source identity mismatch rejects the entire response.

An optional `urn` accepts an opaque `ACo...` member identifier or the `urn:li:fsd_profile:` / `urn:li:fs_miniProfile:` prefix. It must match the returned member. It does not skip a source lookup or reduce provider cost. Other filters, pages, universal cursors and AI enrichments are unsupported and return an uncharged error.

Nonempty uncached responses cost **5 credits**. Cache, replay and all failures are free. An empty upstream dataset is not proof that a member has no activities and is rejected uncharged. Use a 60-second client timeout and `X-Max-Credits: 5`.

<Note>These pinned Apify Actors run with limited permissions and a \$0.04 maximum each. They share a non-resetting ten-run verification ceiling within the existing free allowance. No subscription or top-up is enabled, and sustained funded availability remains unconfigured.</Note>


## OpenAPI

````yaml GET /linkedin/profile/reactions
openapi: 3.1.0
info:
  title: SocialQuery API
  version: '2026-10-09'
  description: >-
    Documented requests for public-source records. Inspect accepted inputs and
    credit amounts, then verify the selected operation before integrating
    preview coverage.
servers:
  - url: https://socialquery.dev/v1
security:
  - apiKey: []
paths:
  /linkedin/profile/reactions:
    get:
      tags:
        - LinkedIn
      summary: LinkedIn Profile Reactions
      description: >-
        A bounded window of up to 20 public member reactions. Canonical post
        wrappers retain reaction activity separately. Date bounds filter post
        publication within this window; unknown dates remain included. The
        source is not date-sorted and does not expose continuation or exhaustive
        totals. Optional urn validates the returned member but does not reduce
        source calls. Invalid inputs and all failures cost zero; a filtered
        empty window costs zero. An empty upstream dataset cannot establish a
        valid empty profile and fails uncharged. Finite trial capacity is
        bounded by a shared ten-run limit; sustained production funding is not
        configured.
      operationId: get_linkedin_profile_reactions
      parameters:
        - name: url
          in: query
          required: true
          example: https://www.linkedin.com/in/williamhgates/
          schema:
            type: string
          description: >-
            Canonical HTTPS LinkedIn /in/ profile URL without query parameters
            or fragment.
        - name: urn
          in: query
          required: false
          schema:
            type: string
          description: >-
            Optional opaque ACo member identifier, optionally prefixed
            urn:li:fsd_profile: or urn:li:fs_miniProfile:. Verified against each
            returned activity member; not a lookup optimization.
        - name: since
          in: query
          required: false
          schema:
            type: string
          description: >-
            Inclusive since bound on post publication within at most twenty
            source-ranked activities. YYYY-MM-DD or ISO 8601 with timezone;
            until includes the whole UTC day. Unknown dates are kept. No date
            aliases or deeper cursor are supported.
        - name: until
          in: query
          required: false
          schema:
            type: string
          description: >-
            Inclusive until bound on post publication within at most twenty
            source-ranked activities. YYYY-MM-DD or ISO 8601 with timezone;
            until includes the whole UTC day. Unknown dates are kept. No date
            aliases or deeper cursor are supported.
        - name: Cache-Control
          in: header
          required: false
          example: no-cache
          schema:
            type: string
        - name: Idempotency-Key
          in: header
          required: false
          example: 7a5e1b4c-2d8f-4a3b-9c1e-6e8b4d2a1f3c
          schema:
            type: string
        - name: X-Max-Credits
          in: header
          required: false
          description: >-
            Optional nonnegative integer cap on the maximum request hold. A live
            request whose hold exceeds this cap returns 422
            CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the
            requested limit; cache hits and successful idempotent replays cost
            zero.
          schema:
            type: integer
            minimum: 0
      responses:
        '200':
          description: >-
            A bounded window of up to 20 public member reactions. Canonical post
            wrappers retain reaction activity separately. Date bounds filter
            post publication within this window; unknown dates remain included.
            The source is not date-sorted and does not expose continuation or
            exhaustive totals. Optional urn validates the returned member but
            does not reduce source calls. Invalid inputs and all failures cost
            zero; a filtered empty window costs zero. An empty upstream dataset
            cannot establish a valid empty profile and fails uncharged. Finite
            trial capacity is bounded by a shared ten-run limit; sustained
            production funding is not configured.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SocialQueryResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          items:
                            type: array
                            maxItems: 20
                            items:
                              type: object
                              properties:
                                post:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    url:
                                      type: string
                                    content:
                                      type: object
                                      properties:
                                        text:
                                          type:
                                            - string
                                            - 'null'
                                        media_urls:
                                          type:
                                            - array
                                            - 'null'
                                          items:
                                            type: string
                                        thumbnail_url:
                                          type:
                                            - string
                                            - 'null'
                                        duration_seconds:
                                          type: 'null'
                                      required:
                                        - text
                                        - media_urls
                                        - thumbnail_url
                                        - duration_seconds
                                      additionalProperties: false
                                    author:
                                      type: object
                                      properties:
                                        id:
                                          type:
                                            - string
                                            - 'null'
                                        username:
                                          type:
                                            - string
                                            - 'null'
                                        display_name:
                                          type:
                                            - string
                                            - 'null'
                                        avatar_url:
                                          type:
                                            - string
                                            - 'null'
                                        verified:
                                          type: 'null'
                                        url:
                                          type:
                                            - string
                                            - 'null'
                                        bio:
                                          type:
                                            - string
                                            - 'null'
                                        ext:
                                          type: object
                                          properties:
                                            urn:
                                              type:
                                                - string
                                                - 'null'
                                          required:
                                            - urn
                                          additionalProperties: false
                                      required:
                                        - id
                                        - username
                                        - display_name
                                        - avatar_url
                                        - verified
                                        - url
                                        - bio
                                        - ext
                                      additionalProperties: false
                                    engagement:
                                      type: object
                                      properties:
                                        views:
                                          type: 'null'
                                        likes:
                                          type:
                                            - integer
                                            - 'null'
                                          minimum: 0
                                        comments:
                                          type:
                                            - integer
                                            - 'null'
                                          minimum: 0
                                        shares:
                                          type:
                                            - integer
                                            - 'null'
                                          minimum: 0
                                        saves:
                                          type: 'null'
                                      required:
                                        - views
                                        - likes
                                        - comments
                                        - shares
                                        - saves
                                      additionalProperties: false
                                    flags:
                                      type: object
                                      properties:
                                        nsfw:
                                          type: 'null'
                                        spoiler:
                                          type: 'null'
                                        pinned:
                                          type: 'null'
                                        deleted:
                                          type: 'null'
                                      required:
                                        - nsfw
                                        - spoiler
                                        - pinned
                                        - deleted
                                      additionalProperties: false
                                    published_at:
                                      type:
                                        - string
                                        - 'null'
                                    ext:
                                      type: object
                                      properties:
                                        url_id:
                                          type: string
                                        url_kind:
                                          enum:
                                            - activity
                                            - ugcPost
                                        article:
                                          anyOf:
                                            - type: 'null'
                                            - type: object
                                              properties:
                                                title:
                                                  type:
                                                    - string
                                                    - 'null'
                                                url:
                                                  type:
                                                    - string
                                                    - 'null'
                                              required:
                                                - title
                                                - url
                                              additionalProperties: false
                                        document:
                                          anyOf:
                                            - type: 'null'
                                            - type: object
                                              properties:
                                                title:
                                                  type:
                                                    - string
                                                    - 'null'
                                              required:
                                                - title
                                              additionalProperties: false
                                        source:
                                          const: apify
                                        source_activity_id:
                                          type:
                                            - string
                                            - 'null'
                                      required:
                                        - url_id
                                        - url_kind
                                        - article
                                        - document
                                        - source
                                        - source_activity_id
                                      additionalProperties: false
                                  required:
                                    - id
                                    - url
                                    - content
                                    - author
                                    - engagement
                                    - flags
                                    - published_at
                                    - ext
                                  additionalProperties: false
                                computed:
                                  type: object
                                  properties:
                                    engagement_rate:
                                      type: 'null'
                                    language:
                                      type: 'null'
                                    content_category:
                                      type: 'null'
                                    estimated_reach:
                                      type: 'null'
                                  required:
                                    - engagement_rate
                                    - language
                                    - content_category
                                    - estimated_reach
                                  additionalProperties: false
                                activity:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    member:
                                      type: object
                                      properties:
                                        id:
                                          type:
                                            - string
                                            - 'null'
                                        username:
                                          type:
                                            - string
                                            - 'null'
                                        display_name:
                                          type:
                                            - string
                                            - 'null'
                                        avatar_url:
                                          type:
                                            - string
                                            - 'null'
                                        verified:
                                          type: 'null'
                                        url:
                                          type:
                                            - string
                                            - 'null'
                                        bio:
                                          type:
                                            - string
                                            - 'null'
                                        ext:
                                          type: object
                                          properties:
                                            urn:
                                              type:
                                                - string
                                                - 'null'
                                          required:
                                            - urn
                                          additionalProperties: false
                                      required:
                                        - id
                                        - username
                                        - display_name
                                        - avatar_url
                                        - verified
                                        - url
                                        - bio
                                        - ext
                                      additionalProperties: false
                                    created_at:
                                      type:
                                        - string
                                        - 'null'
                                    action:
                                      type:
                                        - string
                                        - 'null'
                                    type:
                                      const: reaction
                                  required:
                                    - id
                                    - member
                                    - created_at
                                    - action
                                    - type
                                  additionalProperties: false
                              required:
                                - post
                                - computed
                                - activity
                              additionalProperties: false
                          returned_count:
                            type: integer
                            minimum: 0
                          total:
                            type: 'null'
                          next_cursor:
                            type: 'null'
                          complete:
                            const: false
                          source_count:
                            type: integer
                            minimum: 1
                            maximum: 20
                          window_limit:
                            const: 20
                          deduplicated:
                            type: integer
                            minimum: 0
                          dropped:
                            type: integer
                            minimum: 0
                          profile_url:
                            type: string
                          source_actor:
                            type: string
                          coverage_note:
                            type: string
                        required:
                          - items
                          - returned_count
                          - total
                          - next_cursor
                          - complete
                          - source_count
                          - window_limit
                          - deduplicated
                          - dropped
                          - profile_url
                          - source_actor
                          - coverage_note
                        additionalProperties: false
                    required:
                      - data
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '402':
          $ref: '#/components/responses/Error402'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '405':
          $ref: '#/components/responses/Error405'
        '409':
          $ref: '#/components/responses/Error409'
        '422':
          $ref: '#/components/responses/Error422'
        '429':
          $ref: '#/components/responses/Error429'
        '500':
          $ref: '#/components/responses/Error500'
        '502':
          $ref: '#/components/responses/Error502'
        '503':
          $ref: '#/components/responses/Error503'
        '504':
          $ref: '#/components/responses/Error504'
components:
  schemas:
    SocialQueryResponse:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - data
      properties:
        success:
          type: boolean
          const: true
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        data:
          type: object
          additionalProperties: true
          description: >-
            The selected operation determines the resource fields in this
            object. Source data can omit a metric or report it as null.
    SocialQueryError:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - error
      properties:
        success:
          type: boolean
          const: false
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        error:
          type: object
          required:
            - code
            - type
            - message
            - status
            - doc_url
          properties:
            code:
              type: string
            type:
              type: string
            message:
              type: string
            status:
              type: integer
            doc_url:
              type: string
              format: uri
  responses:
    Error400:
      description: Upstream rejected the request.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error401:
      description: Missing, expired, invalid, or revoked API key.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error402:
      description: Insufficient SocialQuery credits.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error403:
      description: Key scope or provider policy denied access.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error404:
      description: Endpoint or upstream resource not found.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error405:
      description: HTTP method is not supported.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error409:
      description: Idempotency conflict or request in progress.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error422:
      description: Invalid parameters.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error429:
      description: Request limit reached.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error500:
      description: Request processing failed.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error502:
      description: Upstream service failed.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error503:
      description: Provider or required service is unavailable.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error504:
      description: Upstream service timed out.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.