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

# Get replies to a LinkedIn comment

> Call post_replies through the Plyne API or MCP. Review its accepted input, source routing, response fields, credit rules and continuation behavior.

Read replies to one LinkedIn comment; supply the comment identity rather than only its parent post.

## Usage

* Responses automatically retain reviewed fields outside the common record schema under additional\_fields.\<provider>. Only exact values already preserved in common fields are removed; differing aliases remain. Billing, account, operational and unknown fields are excluded.

## API

Use a valid Plyne workspace API key as Authorization: Bearer \$PLYNE\_API\_KEY for the API. Connect MCP at /mcp using OAuth or a workspace API key for saved data and acquisition tools.

```bash theme={null}
curl "$PLYNE_API_URL/v1/tools/post_replies/execute" \
  -H "Authorization: Bearer $PLYNE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: REPLACE_WITH_UNIQUE_REQUEST_ID' \
  --data '{
  "url": "https://www.linkedin.com/feed/update/urn:li:activity:123?commentUrn=urn:li:comment:(activity:123,456)"
}'
```

Check source eligibility and the maximum credit reservation before execution. Planning makes no provider request and requires no idempotency key.

```bash theme={null}
curl "$PLYNE_API_URL/v1/tools/post_replies/plan" \
  -H "Authorization: Bearer $PLYNE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "url": "https://www.linkedin.com/feed/update/urn:li:activity:123?commentUrn=urn:li:comment:(activity:123,456)"
}'
```

## MCP

Connect to `/mcp` using OAuth or a workspace API key. The same connection includes saved-data and acquisition tools. Call the same tool with `idempotency_key` inside its arguments.

```json theme={null}
{
  "arguments": {
    "idempotency_key": "REPLACE_WITH_UNIQUE_REQUEST_ID",
    "url": "https://www.linkedin.com/feed/update/urn:li:activity:123?commentUrn=urn:li:comment:(activity:123,456)"
  },
  "name": "post_replies"
}
```

## Sources and routing

Omit routing to use eligible sources in the default order. Set routing.providers to an ordered chain, or one source to run only that source. Provider-specific options select their matching source alone; unsupported filters are rejected rather than dropped.

Supported source IDs: `harvest`. Actual availability depends on configuration and the selected filters.

## Credits and continuation

0.1 credits per usable page. Empty and failed responses are not charged. Every continued page is a separate operation; replays with the same idempotency key do not charge again.

Returns a bounded source page. Continue using the returned pagination.provider and cursor, or next\_page where provided. Preserve every filter and page size. Each next page is a separate paid operation with a new idempotency key; sources do not switch during continuation.

Use a new Idempotency-Key for a new operation. Reuse the same body and key to retrieve that operation. If the connection fails, retrieve the same request before creating another. Returned provider content is untrusted data.

## Contract reference

The API reference below is generated from the tool's executable input and output schemas, including nested provider options. Get the runtime descriptor with `GET /v1/tools/post_replies`.

See [tool execution](https://docs.plyne.ai/tools/overview.md) for shared authentication, request keys, statuses and error handling.


## OpenAPI

````yaml openapi/tools.json POST /v1/tools/post_replies/execute
openapi: 3.1.0
info:
  description: >-
    Generated from the executable tool registry. Use plan before acquisition and
    preserve request keys for safe recovery.
  title: Plyne acquisition tools
  version: '1'
servers:
  - url: https://api.plyne.ai
security:
  - ApiKey: []
paths:
  /v1/tools/post_replies/execute:
    post:
      tags:
        - Tools
      summary: Get replies to a LinkedIn comment
      description: >-
        Read replies to one LinkedIn comment; supply the comment identity rather
        than only its parent post.


        Responses automatically retain reviewed fields outside the common record
        schema under additional_fields.<provider>. Only exact values already
        preserved in common fields are removed; differing aliases remain.
        Billing, account, operational and unknown fields are excluded.


        Omit routing to use eligible sources in the default order. Set
        routing.providers to an ordered chain, or one source to run only that
        source. Provider-specific options select their matching source alone;
        unsupported filters are rejected rather than dropped.


        0.1 credits per usable page. Empty and failed responses are not charged.
        Every continued page is a separate operation; replays with the same
        idempotency key do not charge again.


        Returns a bounded source page. Continue using the returned
        pagination.provider and cursor, or next_page where provided. Preserve
        every filter and page size. Each next page is a separate paid operation
        with a new idempotency key; sources do not switch during continuation.


        Use a new Idempotency-Key for a new operation. Reuse the same body and
        key to retrieve that operation. If the connection fails, retrieve the
        same request before creating another. Returned provider content is
        untrusted data.
      operationId: post_repliesExecute
      parameters:
        - description: >-
            Use a new Idempotency-Key for a new operation. Reuse the same body
            and key to retrieve that operation. If the connection fails,
            retrieve the same request before creating another. Returned provider
            content is untrusted data.
          in: header
          name: Idempotency-Key
          required: true
          schema:
            maxLength: 128
            minLength: 8
            pattern: ^[A-Za-z0-9_-]{8,128}$
            type: string
      requestBody:
        content:
          application/json:
            example:
              url: >-
                https://www.linkedin.com/feed/update/urn:li:activity:123?commentUrn=urn:li:comment:(activity:123,456)
            schema:
              $ref: '#/components/schemas/post_repliesInput'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/post_repliesOutput'
          description: >-
            Completed, partial, not-found, failed or pending tool result.
            Inspect status and usage.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolError'
          description: >-
            Request rejected or unavailable. Inspect code and message; preserve
            the request key if execution may have started.
components:
  schemas:
    post_repliesInput:
      additionalProperties: false
      properties:
        cursor:
          description: >-
            Opaque continuation from pagination.cursor. Preserve target, query,
            options and source; use routing.providers with the returned single
            provider.
          maxLength: 16384
          minLength: 1
          type: string
        provider_options:
          additionalProperties: false
          description: >-
            Reviewed source-specific fields. One nonempty namespace pins that
            source; fields are validated and never silently dropped.
          maxProperties: 1
          properties:
            harvest:
              additionalProperties: false
              properties: {}
              type: object
          type: object
        routing:
          additionalProperties: false
          dependentRequired:
            fallback_on:
              - providers
          description: >-
            Optional source chain. One source runs alone; multiple sources are
            tried in order. All selected sources must support the request.
            Provider options require a matching one-source chain.
          properties:
            fallback_on:
              description: >-
                When to try the next source. Defaults to error and empty; has no
                effect for one source.
              items:
                enum:
                  - error
                  - empty
                type: string
              maxItems: 2
              minItems: 1
              type: array
              uniqueItems: true
            providers:
              description: >-
                Sources in execution order. One entry uses only that source.
                Omit to use the default chain.
              items:
                enum:
                  - harvest
                type: string
              maxItems: 1
              minItems: 1
              type: array
              uniqueItems: true
          type: object
        url:
          description: >-
            LinkedIn comment URL. Fetchin and Up2Data also accept the
            corresponding LinkedIn URN.
          maxLength: 2048
          minLength: 1
          type: string
      required:
        - url
      type: object
    post_repliesOutput:
      additionalProperties: false
      properties:
        data:
          items:
            additionalProperties: false
            properties:
              additional_fields:
                additionalProperties: false
                properties:
                  harvest:
                    additionalProperties: false
                    properties:
                      actor:
                        additionalProperties: false
                        properties:
                          author:
                            description: >-
                              Indicates if the actor is the original author of
                              the parent post.
                            type: boolean
                          id:
                            description: >-
                              The unique identifier for the actor who made the
                              comment.
                            type: string
                          linkedinUrl:
                            description: The LinkedIn profile URL of the actor.
                            type: string
                          name:
                            description: The name of the actor.
                            type: string
                          picture:
                            additionalProperties: false
                            properties:
                              expiresAt:
                                description: >-
                                  The expiration timestamp of the picture URL in
                                  milliseconds since epoch.
                                type: integer
                              height:
                                description: The height of the picture in pixels.
                                type: integer
                              url:
                                description: The URL of the picture.
                                type: string
                              width:
                                description: The width of the picture in pixels.
                                type: integer
                            type: object
                          pictureUrl:
                            description: The URL of the actor's profile picture.
                            type: string
                          position:
                            description: The current position or headline of the actor.
                            type: string
                        type: object
                      commentary:
                        description: The text content of the comment.
                        type: string
                      contributed:
                        description: >-
                          Indicates if the actor is a contributor to the content
                          (e.g., a group admin or page role).
                        type: boolean
                      createdAt:
                        description: >-
                          The ISO 8601 timestamp of when the comment was
                          created.
                        type: string
                      createdAtTimestamp:
                        description: >-
                          The timestamp of when the comment was created, in
                          milliseconds since epoch.
                        type: integer
                      edited:
                        description: Indicates if the comment has been edited.
                        type: boolean
                      id:
                        description: The unique identifier for the comment.
                        type: string
                      linkedinUrl:
                        description: The direct URL to the comment on LinkedIn.
                        type: string
                      numComments:
                        description: The number of replies to this comment.
                        type: integer
                      numImpressions:
                        description: >-
                          The number of impressions for this comment (often
                          null).
                        type:
                          - integer
                          - 'null'
                      numShares:
                        description: >-
                          The number of times this comment has been shared
                          (often null for comments).
                        type:
                          - integer
                          - 'null'
                      pinned:
                        description: Indicates if the comment is pinned.
                        type: boolean
                      postId:
                        description: The ID of the post to which this comment belongs.
                        type: string
                      reactionTypeCounts:
                        description: >-
                          A list of reaction types and their counts for this
                          comment.
                        items:
                          additionalProperties: false
                          properties:
                            count:
                              description: The number of this type of reaction.
                              type: integer
                            type:
                              description: The type of reaction.
                              enum:
                                - LIKE
                                - EMPATHY
                                - PRAISE
                                - INTEREST
                                - MAYBE
                              type: string
                          type: object
                        type: array
                    type: object
                type: object
              author:
                additionalProperties: false
                properties:
                  headline:
                    type: string
                  name:
                    type: string
                  url:
                    type: string
                type: object
              counts:
                additionalProperties: false
                properties:
                  comments:
                    minimum: 0
                    type: number
                  reactions:
                    minimum: 0
                    type: number
                  reposts:
                    minimum: 0
                    type: number
                type: object
              id:
                type: string
              included:
                additionalProperties: false
                properties:
                  comments:
                    additionalProperties: false
                    properties:
                      cursor:
                        type: string
                      has_more:
                        type: boolean
                      items:
                        items:
                          additionalProperties: false
                          properties:
                            additional_fields:
                              additionalProperties: false
                              properties:
                                harvest:
                                  additionalProperties: false
                                  properties:
                                    actor:
                                      additionalProperties: false
                                      properties:
                                        author:
                                          description: >-
                                            Indicates if the actor is the original
                                            author of the parent post.
                                          type: boolean
                                        id:
                                          description: >-
                                            The unique identifier for the actor who
                                            made the comment.
                                          type: string
                                        linkedinUrl:
                                          description: The LinkedIn profile URL of the actor.
                                          type: string
                                        name:
                                          description: The name of the actor.
                                          type: string
                                        picture:
                                          additionalProperties: false
                                          properties:
                                            expiresAt:
                                              description: >-
                                                The expiration timestamp of the picture
                                                URL in milliseconds since epoch.
                                              type: integer
                                            height:
                                              description: The height of the picture in pixels.
                                              type: integer
                                            url:
                                              description: The URL of the picture.
                                              type: string
                                            width:
                                              description: The width of the picture in pixels.
                                              type: integer
                                          type: object
                                        pictureUrl:
                                          description: The URL of the actor's profile picture.
                                          type: string
                                        position:
                                          description: >-
                                            The current position or headline of the
                                            actor.
                                          type: string
                                      type: object
                                    commentary:
                                      description: The text content of the comment.
                                      type: string
                                    contributed:
                                      description: >-
                                        Indicates if the actor is a contributor
                                        to the content (e.g., a group admin or
                                        page role).
                                      type: boolean
                                    createdAt:
                                      description: >-
                                        The ISO 8601 timestamp of when the
                                        comment was created.
                                      type: string
                                    createdAtTimestamp:
                                      description: >-
                                        The timestamp of when the comment was
                                        created, in milliseconds since epoch.
                                      type: integer
                                    edited:
                                      description: >-
                                        Indicates if the comment has been
                                        edited.
                                      type: boolean
                                    id:
                                      description: The unique identifier for the comment.
                                      type: string
                                    linkedinUrl:
                                      description: >-
                                        The direct URL to the comment on
                                        LinkedIn.
                                      type: string
                                    numComments:
                                      description: The number of replies to this comment.
                                      type: integer
                                    numImpressions:
                                      description: >-
                                        The number of impressions for this
                                        comment (often null).
                                      type:
                                        - integer
                                        - 'null'
                                    numShares:
                                      description: >-
                                        The number of times this comment has
                                        been shared (often null for comments).
                                      type:
                                        - integer
                                        - 'null'
                                    pinned:
                                      description: Indicates if the comment is pinned.
                                      type: boolean
                                    postId:
                                      description: >-
                                        The ID of the post to which this comment
                                        belongs.
                                      type: string
                                    reactionTypeCounts:
                                      description: >-
                                        A list of reaction types and their
                                        counts for this comment.
                                      items:
                                        additionalProperties: false
                                        properties:
                                          count:
                                            description: The number of this type of reaction.
                                            type: integer
                                          type:
                                            description: The type of reaction.
                                            enum:
                                              - LIKE
                                              - EMPATHY
                                              - PRAISE
                                              - INTEREST
                                              - MAYBE
                                            type: string
                                        type: object
                                      type: array
                                  type: object
                              type: object
                            author:
                              additionalProperties: false
                              properties:
                                headline:
                                  type: string
                                name:
                                  type: string
                                url:
                                  type: string
                              type: object
                            counts:
                              additionalProperties: false
                              properties:
                                comments:
                                  minimum: 0
                                  type: number
                                reactions:
                                  minimum: 0
                                  type: number
                                reposts:
                                  minimum: 0
                                  type: number
                              type: object
                            id:
                              type: string
                            kind:
                              type: string
                            published_at:
                              type: string
                            reaction_type:
                              type: string
                            target_post:
                              additionalProperties: false
                              properties:
                                text:
                                  type: string
                                url:
                                  type: string
                              type: object
                            text:
                              type: string
                            url:
                              type: string
                          type: object
                        maxItems: 100
                        type: array
                    type: object
                  reactions:
                    additionalProperties: false
                    properties:
                      cursor:
                        type: string
                      has_more:
                        type: boolean
                      items:
                        items:
                          additionalProperties: false
                          properties:
                            additional_fields:
                              additionalProperties: false
                              properties:
                                harvest:
                                  additionalProperties: false
                                  properties:
                                    actor:
                                      additionalProperties: false
                                      properties:
                                        author:
                                          description: >-
                                            Indicates if the actor is the original
                                            author of the parent post.
                                          type: boolean
                                        id:
                                          description: >-
                                            The unique identifier for the actor who
                                            made the comment.
                                          type: string
                                        linkedinUrl:
                                          description: The LinkedIn profile URL of the actor.
                                          type: string
                                        name:
                                          description: The name of the actor.
                                          type: string
                                        picture:
                                          additionalProperties: false
                                          properties:
                                            expiresAt:
                                              description: >-
                                                The expiration timestamp of the picture
                                                URL in milliseconds since epoch.
                                              type: integer
                                            height:
                                              description: The height of the picture in pixels.
                                              type: integer
                                            url:
                                              description: The URL of the picture.
                                              type: string
                                            width:
                                              description: The width of the picture in pixels.
                                              type: integer
                                          type: object
                                        pictureUrl:
                                          description: The URL of the actor's profile picture.
                                          type: string
                                        position:
                                          description: >-
                                            The current position or headline of the
                                            actor.
                                          type: string
                                      type: object
                                    commentary:
                                      description: The text content of the comment.
                                      type: string
                                    contributed:
                                      description: >-
                                        Indicates if the actor is a contributor
                                        to the content (e.g., a group admin or
                                        page role).
                                      type: boolean
                                    createdAt:
                                      description: >-
                                        The ISO 8601 timestamp of when the
                                        comment was created.
                                      type: string
                                    createdAtTimestamp:
                                      description: >-
                                        The timestamp of when the comment was
                                        created, in milliseconds since epoch.
                                      type: integer
                                    edited:
                                      description: >-
                                        Indicates if the comment has been
                                        edited.
                                      type: boolean
                                    id:
                                      description: The unique identifier for the comment.
                                      type: string
                                    linkedinUrl:
                                      description: >-
                                        The direct URL to the comment on
                                        LinkedIn.
                                      type: string
                                    numComments:
                                      description: The number of replies to this comment.
                                      type: integer
                                    numImpressions:
                                      description: >-
                                        The number of impressions for this
                                        comment (often null).
                                      type:
                                        - integer
                                        - 'null'
                                    numShares:
                                      description: >-
                                        The number of times this comment has
                                        been shared (often null for comments).
                                      type:
                                        - integer
                                        - 'null'
                                    pinned:
                                      description: Indicates if the comment is pinned.
                                      type: boolean
                                    postId:
                                      description: >-
                                        The ID of the post to which this comment
                                        belongs.
                                      type: string
                                    reactionTypeCounts:
                                      description: >-
                                        A list of reaction types and their
                                        counts for this comment.
                                      items:
                                        additionalProperties: false
                                        properties:
                                          count:
                                            description: The number of this type of reaction.
                                            type: integer
                                          type:
                                            description: The type of reaction.
                                            enum:
                                              - LIKE
                                              - EMPATHY
                                              - PRAISE
                                              - INTEREST
                                              - MAYBE
                                            type: string
                                        type: object
                                      type: array
                                  type: object
                              type: object
                            author:
                              additionalProperties: false
                              properties:
                                headline:
                                  type: string
                                name:
                                  type: string
                                url:
                                  type: string
                              type: object
                            counts:
                              additionalProperties: false
                              properties:
                                comments:
                                  minimum: 0
                                  type: number
                                reactions:
                                  minimum: 0
                                  type: number
                                reposts:
                                  minimum: 0
                                  type: number
                              type: object
                            id:
                              type: string
                            kind:
                              type: string
                            published_at:
                              type: string
                            reaction_type:
                              type: string
                            target_post:
                              additionalProperties: false
                              properties:
                                text:
                                  type: string
                                url:
                                  type: string
                              type: object
                            text:
                              type: string
                            url:
                              type: string
                          type: object
                        maxItems: 100
                        type: array
                    type: object
                  reposts:
                    additionalProperties: false
                    properties:
                      cursor:
                        type: string
                      has_more:
                        type: boolean
                      items:
                        items:
                          additionalProperties: false
                          properties:
                            additional_fields:
                              additionalProperties: false
                              properties:
                                harvest:
                                  additionalProperties: false
                                  properties:
                                    actor:
                                      additionalProperties: false
                                      properties:
                                        author:
                                          description: >-
                                            Indicates if the actor is the original
                                            author of the parent post.
                                          type: boolean
                                        id:
                                          description: >-
                                            The unique identifier for the actor who
                                            made the comment.
                                          type: string
                                        linkedinUrl:
                                          description: The LinkedIn profile URL of the actor.
                                          type: string
                                        name:
                                          description: The name of the actor.
                                          type: string
                                        picture:
                                          additionalProperties: false
                                          properties:
                                            expiresAt:
                                              description: >-
                                                The expiration timestamp of the picture
                                                URL in milliseconds since epoch.
                                              type: integer
                                            height:
                                              description: The height of the picture in pixels.
                                              type: integer
                                            url:
                                              description: The URL of the picture.
                                              type: string
                                            width:
                                              description: The width of the picture in pixels.
                                              type: integer
                                          type: object
                                        pictureUrl:
                                          description: The URL of the actor's profile picture.
                                          type: string
                                        position:
                                          description: >-
                                            The current position or headline of the
                                            actor.
                                          type: string
                                      type: object
                                    commentary:
                                      description: The text content of the comment.
                                      type: string
                                    contributed:
                                      description: >-
                                        Indicates if the actor is a contributor
                                        to the content (e.g., a group admin or
                                        page role).
                                      type: boolean
                                    createdAt:
                                      description: >-
                                        The ISO 8601 timestamp of when the
                                        comment was created.
                                      type: string
                                    createdAtTimestamp:
                                      description: >-
                                        The timestamp of when the comment was
                                        created, in milliseconds since epoch.
                                      type: integer
                                    edited:
                                      description: >-
                                        Indicates if the comment has been
                                        edited.
                                      type: boolean
                                    id:
                                      description: The unique identifier for the comment.
                                      type: string
                                    linkedinUrl:
                                      description: >-
                                        The direct URL to the comment on
                                        LinkedIn.
                                      type: string
                                    numComments:
                                      description: The number of replies to this comment.
                                      type: integer
                                    numImpressions:
                                      description: >-
                                        The number of impressions for this
                                        comment (often null).
                                      type:
                                        - integer
                                        - 'null'
                                    numShares:
                                      description: >-
                                        The number of times this comment has
                                        been shared (often null for comments).
                                      type:
                                        - integer
                                        - 'null'
                                    pinned:
                                      description: Indicates if the comment is pinned.
                                      type: boolean
                                    postId:
                                      description: >-
                                        The ID of the post to which this comment
                                        belongs.
                                      type: string
                                    reactionTypeCounts:
                                      description: >-
                                        A list of reaction types and their
                                        counts for this comment.
                                      items:
                                        additionalProperties: false
                                        properties:
                                          count:
                                            description: The number of this type of reaction.
                                            type: integer
                                          type:
                                            description: The type of reaction.
                                            enum:
                                              - LIKE
                                              - EMPATHY
                                              - PRAISE
                                              - INTEREST
                                              - MAYBE
                                            type: string
                                        type: object
                                      type: array
                                  type: object
                              type: object
                            author:
                              additionalProperties: false
                              properties:
                                headline:
                                  type: string
                                name:
                                  type: string
                                url:
                                  type: string
                              type: object
                            counts:
                              additionalProperties: false
                              properties:
                                comments:
                                  minimum: 0
                                  type: number
                                reactions:
                                  minimum: 0
                                  type: number
                                reposts:
                                  minimum: 0
                                  type: number
                              type: object
                            id:
                              type: string
                            kind:
                              type: string
                            published_at:
                              type: string
                            reaction_type:
                              type: string
                            target_post:
                              additionalProperties: false
                              properties:
                                text:
                                  type: string
                                url:
                                  type: string
                              type: object
                            text:
                              type: string
                            url:
                              type: string
                          type: object
                        maxItems: 100
                        type: array
                    type: object
                type: object
              kind:
                type: string
              published_at:
                type: string
              reaction_type:
                type: string
              target_post:
                additionalProperties: false
                properties:
                  text:
                    type: string
                  url:
                    type: string
                type: object
              text:
                type: string
              url:
                type: string
            type: object
          maxItems: 100
          type:
            - array
            - 'null'
        error:
          additionalProperties: false
          properties:
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
          required:
            - code
            - message
            - retryable
          type:
            - object
            - 'null'
        fulfillment:
          properties:
            field_sources:
              additionalProperties:
                items:
                  properties:
                    observation_id:
                      type: string
                    observed_at:
                      properties: {}
                      type: object
                    provider:
                      type: string
                    url:
                      type: string
                  type: object
                type: array
              type: object
            missing_fields:
              items:
                type: string
              type: array
            satisfied:
              type: boolean
          type: object
        id:
          type: string
        pagination:
          additionalProperties: false
          properties:
            cursor:
              type: string
            has_more:
              type:
                - boolean
                - 'null'
            limit:
              maximum: 100
              minimum: 1
              type: integer
            next_page:
              minimum: 0
              type:
                - integer
                - 'null'
            page:
              minimum: 0
              type: integer
            provider:
              enum:
                - harvest
              type: string
            returned:
              maximum: 100
              minimum: 0
              type: integer
            total:
              minimum: 0
              type:
                - integer
                - 'null'
          required:
            - page
            - limit
            - returned
            - total
            - has_more
            - next_page
          type: object
        routing:
          additionalProperties: false
          properties:
            attempts:
              items:
                additionalProperties: false
                properties:
                  outcome:
                    enum:
                      - success
                      - partial
                      - pending
                      - error
                      - empty
                    type: string
                  provider:
                    type: string
                  requests:
                    minimum: 0
                    type: integer
                required:
                  - provider
                  - outcome
                  - requests
                type: object
              type: array
            mode:
              enum:
                - auto
                - single
                - fallback
              type: string
            selected_provider:
              type: string
          required:
            - mode
          type: object
        sources:
          items:
            additionalProperties: false
            properties:
              observation_id:
                type: string
              observed_at:
                format: date-time
                type: string
              provider:
                type: string
              url:
                type: string
            required:
              - provider
            type: object
          type: array
        status:
          enum:
            - completed
            - partial
            - not_found
            - failed
            - pending
          type: string
        tool:
          const: post_replies
          type: string
        usage:
          additionalProperties: false
          properties:
            credit_units:
              minimum: 0
              type: integer
            credits:
              type: string
            unit:
              const: page
              type: string
          required:
            - credit_units
            - credits
            - unit
          type:
            - object
            - 'null'
        version:
          const: '1'
          type: string
        warnings:
          items:
            additionalProperties: false
            properties:
              code:
                type: string
              message:
                type: string
            required:
              - code
              - message
            type: object
          type: array
      required:
        - id
        - tool
        - version
        - status
        - data
        - sources
        - usage
        - error
      type: object
    ToolError:
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
      type: object
  securitySchemes:
    ApiKey:
      scheme: bearer
      type: http

````

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