> ## Documentation Index
> Fetch the complete documentation index at: https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Scrape post reactors

> Direct LinkedIn read (bypasses our DB): live pull of who is reacting to ONE post right now, as transient reactor objects with normalized reaction_type (MAYBE → like + WARN), annotated with is_own and is_stored / linkedin_engagement_sid. Target any post by URL or activity URN in post. One wire page per call; page on with cursor.

Contract:
- MCP tool `scrape_linkedin_get_post_reactors`, registry package `mcp.linkedin/linkedin_scraping`, mount `linkedin.scraping`.
- Operation `action`, response envelope `action`.
- Flags: none.



## OpenAPI

````yaml /api-reference/linkedin/openapi.yaml post /api/linkedin-scraping/get-post-reactors
openapi: 3.0.3
info:
  title: 'GTM API public contract: gtm.service.linkedin'
  description: >-
    Connected LinkedIn accounts and everything driven through them: account
    health and smart limits, conversations and messages, the connection graph,
    outbound posting, scraping, profile and company enrichment, and the
    antidetect browsers that execute it all.


    GENERATED. This document is projected from the Zod MCP tool registry in
    `product/mcp/gtm.mcp` (one tool per public endpoint, 1:1). Do not edit it by
    hand; edit the tool definition and regenerate with `pnpm openapi:public`.


    Surface: the public `/api` contract of `gtm.service.linkedin`, 159
    operations. This is the only OpenAPI document the platform publishes.
    Internal (`/internal`) and health endpoints are deliberately absent: they
    are not part of any contract, they can change without notice, and the
    service source is their only description.


    Conventions:

    - Auth is a bearer JWT, optionally narrowed by the `Team-SID` header.

    - Every success body is an MCP envelope: `success: true` plus one typed
    `operation` shape (`search`, `get`, `create`, `update`, `delete`, `metrics`,
    `group_by`, `action`), and a `meta` block with `trace_id` for support.

    - Every failure is the same `McpError` envelope with a code from a fixed
    16-code taxonomy, so a client maps errors once.

    - Lists page with `page_size` (0 to 500, default 50) plus an opaque forward
    `cursor`; `page_size: 0` returns counts only.

    - On `GET` and `DELETE`, object-valued query parameters (`filter`, `sort`)
    travel as JSON text and array-valued ones repeat as `name[]=value`.

    - The MCP-only `_meta` field (usage analytics) never reaches the backend and
    is not part of this contract.
  version: '1.0'
  contact:
    name: GTM API
    url: https://gtm-api.com
    email: support@gtm-api.com
  license:
    name: Proprietary
    url: https://gtm-api.com/license
servers:
  - url: https://app.gtm-api.com/linkedin/v4
    description: Production, through the app.gtm-api.com gateway
security:
  - BearerJwt: []
    TeamSid: []
tags:
  - name: antidetect_browser_logs
    description: >-
      Registry package `mcp.linkedin/antidetect_browser_logs`, served on MCP
      mount `linkedin.browsers`.
  - name: antidetect_browser_proxies
    description: >-
      Registry package `mcp.linkedin/antidetect_browser_proxies`, served on MCP
      mount `linkedin.browsers`.
  - name: antidetect_browsers
    description: >-
      Registry package `mcp.linkedin/antidetect_browsers`, served on MCP mount
      `linkedin.browsers`.
  - name: cloud_browser_sessions
    description: >-
      Registry package `mcp.linkedin/cloud_browser_sessions`, served on MCP
      mount `linkedin.browsers`.
  - name: cloud_browsers
    description: >-
      Registry package `mcp.linkedin/cloud_browsers`, served on MCP mount
      `linkedin.browsers`.
  - name: data_requests
    description: >-
      Registry package `mcp.linkedin/data_requests`, served on MCP mount
      `linkedin.data`.
  - name: linkedin_account_activity_log
    description: >-
      Registry package `mcp.linkedin/linkedin_account_activity_log`, served on
      MCP mount `linkedin.account-monitor`.
  - name: linkedin_account_block_log
    description: >-
      Registry package `mcp.linkedin/linkedin_account_block_log`, served on MCP
      mount `linkedin.account-monitor`.
  - name: linkedin_account_quota_hits
    description: >-
      Registry package `mcp.linkedin/linkedin_account_quota_hits`, served on MCP
      mount `linkedin.account-monitor`.
  - name: linkedin_account_smart_limits
    description: >-
      Registry package `mcp.linkedin/linkedin_account_smart_limits`, served on
      MCP mount `linkedin.accounts`.
  - name: linkedin_account_snapshots
    description: >-
      Registry package `mcp.linkedin/linkedin_account_snapshots`, served on MCP
      mount `linkedin.account-monitor`.
  - name: linkedin_account_sync_runs
    description: >-
      Registry package `mcp.linkedin/linkedin_account_sync_runs`, served on MCP
      mount `linkedin.account-monitor`.
  - name: linkedin_accounts
    description: >-
      Registry package `mcp.linkedin/linkedin_accounts`, served on MCP mount
      `linkedin.accounts`.
  - name: linkedin_auto_scrape_results
    description: >-
      Registry package `mcp.linkedin/linkedin_auto_scrape_results`, served on
      MCP mount `linkedin.auto-scrapes`.
  - name: linkedin_auto_scrape_runs
    description: >-
      Registry package `mcp.linkedin/linkedin_auto_scrape_runs`, served on MCP
      mount `linkedin.auto-scrapes`.
  - name: linkedin_auto_scrapes
    description: >-
      Registry package `mcp.linkedin/linkedin_auto_scrapes`, served on MCP mount
      `linkedin.auto-scrapes`.
  - name: linkedin_benchmarks
    description: >-
      Registry package `mcp.linkedin/linkedin_benchmarks`, served on MCP mount
      `linkedin.account-monitor`.
  - name: linkedin_connection_invitations
    description: >-
      Registry package `mcp.linkedin/linkedin_connection_invitations`, served on
      MCP mount `linkedin.network`.
  - name: linkedin_connection_requests
    description: >-
      Registry package `mcp.linkedin/linkedin_connection_requests`, served on
      MCP mount `linkedin.network`.
  - name: linkedin_connections
    description: >-
      Registry package `mcp.linkedin/linkedin_connections`, served on MCP mount
      `linkedin.network`.
  - name: linkedin_conversations
    description: >-
      Registry package `mcp.linkedin/linkedin_conversations`, served on MCP
      mount `linkedin.messaging`.
  - name: linkedin_custom_requests
    description: >-
      Registry package `mcp.linkedin/linkedin_custom_requests`, served on MCP
      mount `linkedin.platform`.
  - name: linkedin_enrichment
    description: >-
      Registry package `mcp.linkedin/linkedin_enrichment`, served on MCP mount
      `linkedin.enrichment`.
  - name: linkedin_followers
    description: >-
      Registry package `mcp.linkedin/linkedin_followers`, served on MCP mount
      `linkedin.network`.
  - name: linkedin_messages
    description: >-
      Registry package `mcp.linkedin/linkedin_messages`, served on MCP mount
      `linkedin.messaging`.
  - name: linkedin_posting
    description: >-
      Registry package `mcp.linkedin/linkedin_posting`, served on MCP mount
      `linkedin.content`.
  - name: linkedin_scraping
    description: >-
      Registry package `mcp.linkedin/linkedin_scraping`, served on MCP mount
      `linkedin.scraping`.
paths:
  /api/linkedin-scraping/get-post-reactors:
    post:
      tags:
        - linkedin_scraping
      summary: Scrape post reactors
      description: >-
        Direct LinkedIn read (bypasses our DB): live pull of who is reacting to
        ONE post right now, as transient reactor objects with normalized
        reaction_type (MAYBE → like + WARN), annotated with is_own and is_stored
        / linkedin_engagement_sid. Target any post by URL or activity URN in
        post. One wire page per call; page on with cursor.


        Contract:

        - MCP tool `scrape_linkedin_get_post_reactors`, registry package
        `mcp.linkedin/linkedin_scraping`, mount `linkedin.scraping`.

        - Operation `action`, response envelope `action`.

        - Flags: none.
      operationId: scrape_linkedin_get_post_reactors
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ScrapeLinkedinGetPostReactorsRequest'
      responses:
        '200':
          description: '`action` success envelope.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScrapeLinkedinGetPostReactorsResponse'
        4XX:
          $ref: '#/components/responses/McpClientError'
        5XX:
          $ref: '#/components/responses/McpServerError'
components:
  schemas:
    ScrapeLinkedinGetPostReactorsRequest:
      type: object
      description: Request body of `scrape_linkedin_get_post_reactors`.
      properties:
        linkedin_account_sid:
          type: string
          nullable: true
          minLength: 18
          maxLength: 18
          pattern: ^ln_ac_
          description: >-
            Executor account (ln_ac_...). OPTIONAL everywhere on this surface.
            Given: the call runs on that account ONLY; a saturated or held
            scraping bucket refuses 429 bucket_saturated (with retry_after).
            Omitted: the service auto-picks one of your connected accounts with
            remaining capacity (SN verbs pick only Sales-Navigator seats; 422
            no_connected_accounts when none is ready, 429 when all are at
            capacity).
        idempotency_key:
          type: string
          nullable: true
          maxLength: 128
          description: >-
            Ledger replay guard: a repeat call with the same (team, key) returns
            the stored outcome; no re-execution. Recommended on every search
            run. The KEY ALONE decides: the probe does not compare arguments, so
            reusing one key after changing the arguments hands back the FIRST
            result. On the twelve search verbs that matters twice over, because
            switching a call from filters to url (or back) under one key replays
            instead of running the new search. New search, new key.
        post:
          type: string
          maxLength: 512
          description: >-
            A post URL or an activity URN. Accepted verbatim:
            `urn:li:activity:<id>`, the feed permalink
            (`/feed/update/urn:li:activity:<id>/`) and the share link the
            copy-link button produces (`/posts/<slug>-activity-<id>-<hash>`):
            all three are parsed locally, at no extra cost. A link with no id in
            it (a shortlink, a bare slug URL) is resolved by opening the page
            through get_activity_urn_by_url, which adds one extra page load to
            this call and is cached 7 days. The post does NOT need to be tracked
            or owned by you.
        page_size:
          type: integer
          minimum: 1
          maximum: 100
          description: Default 50.
        cursor:
          type: string
          nullable: true
          description: Opaque resume token; null = first page.
      required:
        - post
    ScrapeLinkedinGetPostReactorsResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        operation:
          type: string
          enum:
            - action
        action:
          type: string
          description: kebab-case verb; matches the route segment.
        item: {}
        result:
          type: object
          properties:
            rows:
              type: array
              items:
                type: object
                properties:
                  reactor_ln_member_id:
                    type: string
                  reactor_ln_id:
                    type: string
                    nullable: true
                  reactor_nickname:
                    type: string
                    nullable: true
                  reactor_full_name:
                    type: string
                    nullable: true
                  reactor_headline:
                    type: string
                    nullable: true
                  reactor_picture_url:
                    type: string
                    nullable: true
                  reaction_type:
                    type: string
                    enum:
                      - like
                      - celebrate
                      - support
                      - love
                      - insightful
                      - funny
                    description: >-
                      Normalized reaction type (MAYBE → like + WARN, as on
                      sync), per LinkedinEngagementReactionTypeEnum.
                  reacted_at:
                    type: string
                    nullable: true
                  is_own:
                    type: boolean
                required:
                  - reactor_ln_member_id
                  - reactor_ln_id
                  - reactor_nickname
                  - reactor_full_name
                  - reactor_headline
                  - reactor_picture_url
                  - reaction_type
                  - reacted_at
                  - is_own
              description: >-
                The transient result list, in LinkedIn’s order; NOTHING
                persisted.
            paging:
              type: object
              properties:
                page_size:
                  type: integer
                next_cursor:
                  type: string
                  nullable: true
                has_more:
                  type: boolean
                total:
                  type: integer
                  nullable: true
              required:
                - page_size
                - next_cursor
                - has_more
                - total
              description: >-
                Cursor paging: feed next_cursor back verbatim; null = terminal
                page.
            data_request:
              type: object
              properties: {}
              description: >-
                The kind="scrape" DataRequest journal row for this call
                (terminal completed), embedded as result.data_request;
                served_from_cache always false. Full DataRequestDomain shape
                owned by ./data_requests.md, so it is left passthrough here.
            post:
              type: object
              properties:
                post_ln_id:
                  type: string
                is_tracked:
                  type: boolean
                linkedin_tracked_post_sid:
                  type: string
                  nullable: true
              required:
                - post_ln_id
                - is_tracked
                - linkedin_tracked_post_sid
              description: The resolved post target the getter ran against.
            skipped_null_actors:
              type: integer
              description: Banned/suspended reactor slots skipped (KNOWLEDGE §7a).
          required:
            - rows
            - paging
            - data_request
            - post
            - skipped_null_actors
        meta:
          type: object
          properties:
            trace_id:
              type: string
              description: UUID v7; same 128-bit value as the X-Trace-Id header.
            span_id:
              type: string
              pattern: ^[0-9a-f]{16}$
              description: 16 hex chars, root span of this request.
            timestamp:
              type: string
              description: ISO 8601 UTC (Y-m-dTH:i:sZ), response time.
            duration_ms:
              type: integer
              minimum: 0
              description: Server-side wall clock.
            debug_url:
              type: string
              description: Deep link to the post-call analysis UI.
          required:
            - trace_id
            - span_id
            - timestamp
            - duration_ms
            - debug_url
      required:
        - success
        - operation
        - action
        - item
        - result
        - meta
    McpError:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_failed
                - nothing_to_update
                - not_found
                - relation_not_found
                - invalid_transition
                - limit_exceeded
                - payment_required
                - duplicate_rejected
                - conflict
                - delete_blocked
                - unauthorized
                - forbidden
                - rate_limited
                - internal_error
                - service_unavailable
                - not_implemented
            message:
              type: string
            recoverable:
              type: boolean
            suggestion:
              type: string
            field_errors:
              type: object
              additionalProperties:
                type: array
                items:
                  anyOf:
                    - type: string
                    - type: object
                      properties:
                        rule:
                          type: string
                        message:
                          type: string
                      required:
                        - rule
                        - message
            blockers:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                    description: >-
                      Machine-readable blocker type (active_flow, pending_tasks,
                      …).
                  severity:
                    type: string
                    enum:
                      - hard
                      - soft
                    description: >-
                      hard = external action required; soft = acknowledge is
                      enough.
                  description:
                    type: string
                  entity_sid:
                    type: string
                    nullable: true
                  count:
                    type: integer
                  resolution:
                    type: string
                    description: 'Hard: tool name to call. Soft: code for acknowledge[].'
                  resolution_hint:
                    type: string
                required:
                  - type
                  - severity
                  - description
                  - entity_sid
                  - resolution
                  - resolution_hint
            context:
              type: object
              additionalProperties: {}
          required:
            - code
            - message
            - recoverable
        meta:
          type: object
          properties:
            trace_id:
              type: string
              description: UUID v7; same 128-bit value as the X-Trace-Id header.
            span_id:
              type: string
              pattern: ^[0-9a-f]{16}$
              description: 16 hex chars, root span of this request.
            timestamp:
              type: string
              description: ISO 8601 UTC (Y-m-dTH:i:sZ), response time.
            duration_ms:
              type: integer
              minimum: 0
              description: Server-side wall clock.
            debug_url:
              type: string
              description: Deep link to the post-call analysis UI.
          required:
            - trace_id
            - span_id
            - timestamp
            - duration_ms
            - debug_url
      required:
        - success
        - error
  responses:
    McpClientError:
      description: >-
        MCP error envelope. `error.code` is one of validation_failed,
        nothing_to_update, not_found, relation_not_found, invalid_transition,
        limit_exceeded, payment_required, duplicate_rejected, conflict,
        delete_blocked, unauthorized, forbidden, rate_limited, not_implemented.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/McpError'
    McpServerError:
      description: >-
        MCP error envelope with `error.code` internal_error or
        service_unavailable.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/McpError'
  securitySchemes:
    BearerJwt:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Access token issued by gtm.service.id. Its `access_identity` claim
        carries `team_sid`, `actor_sid` and `actor_type`, and that team scope is
        authoritative.
    TeamSid:
      type: apiKey
      in: header
      name: Team-SID
      description: >-
        Team scope for tokens that do not carry one. Ignored when the token
        already names a team.

````