openapi: 3.2.0
info:
  title: Monocrawl LinkedIn API
  version: 0.1.0
  description: One key, one envelope, one credit meter across social, search, commerce and web data.
  contact:
    name: Monocrawl support
    url: https://www.monocrawl.com/contact
  termsOfService: https://www.monocrawl.com/legal/terms-and-conditions
servers:
- url: https://www.monocrawl.com
security:
- ApiKeyHeader: []
tags:
- name: Linked In
paths:
  /v1/linkedin/comment-replies:
    get:
      operationId: linkedin_comment_replies
      tags:
      - Linked In
      summary: LinkedIn comment replies
      description: 'Available replies to a LinkedIn comment, with text, likes and author. Completeness is not guaranteed: sources can return fewer replies than a parent count reports. Inspect partial, completeness, total and has_more; null means unknown, not zero or complete. Continue only with a returned cursor and the same target. Source coverage differs by post identifier; some sources can only find parents among their first thirty listed comments. Costs 31 credits per successful live response.'
      parameters:
      - name: post_id
        in: query
        required: true
        schema:
          type: string
        example: '7356711184831574036'
        description: The post activity ID or supported LinkedIn post URL. Canonical https://www.linkedin.com/feed/update/urn:li:ugcPost:<id> URLs and typed urn:li:ugcPost:<id> identifiers are also supported for reply recovery. Activity identifiers require a verified mapping to the underlying post; conflicting identities are rejected.
      - name: comment_id
        in: query
        required: true
        schema:
          type: string
        example: '7356889832989626368'
        description: The comment id from linkedin/post-comments
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Page token from the previous answer
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/comment-replies.json
                      title: linkedin/comment-replies data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        comment:
                          description: Optional comment supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            author:
                              description: Public author information supplied with this record.
                              type:
                              - string
                              - 'null'
                            created_at:
                              description: Source creation time, not the API retrieval time.
                              type:
                              - string
                              - 'null'
                            text:
                              description: Source text when supplied.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                        comment_id:
                          description: Optional comment id supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        dropped:
                          description: Optional dropped supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              author:
                                description: Public author information supplied with this record.
                                type:
                                - object
                                - 'null'
                                properties:
                                  avatar:
                                    description: Optional avatar supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  handle:
                                    description: Optional handle supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              created_at:
                                description: Source creation time, not the API retrieval time.
                                type:
                                - string
                                - 'null'
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              likes:
                                description: Optional likes supplied by this operation. Null means unknown.
                                type:
                                - number
                                - 'null'
                              text:
                                description: Source text when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - author
                                properties:
                                  author:
                                    description: Public author information supplied with this record.
                                    type:
                                    - object
                                    properties:
                                      avatar:
                                        description: Optional avatar supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      handle:
                                        description: Optional handle supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      headline:
                                        description: Optional headline supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - created_at
                                properties:
                                  created_at:
                                    description: Source creation time, not the API retrieval time.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - likes
                                properties:
                                  likes:
                                    description: Optional likes supplied by this operation. Null means unknown.
                                    type:
                                    - number
                              - required:
                                - text
                                properties:
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    minLength: 1
                        post_id:
                          description: Optional post id supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        total:
                          description: Source-reported total; null is unknown.
                          type:
                          - number
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - comment:
                          author: example
                          created_at: '2026-09-01T12:00:00Z'
                          text: example
                        comment_id: example
                        count: 0
                        dropped: 0
                        has_more: false
                        items:
                        - author:
                            avatar: https://example.com/example
                            handle: example
                            headline: example
                            name: example
                            url: https://example.com/example
                          created_at: '2026-09-01T12:00:00Z'
                          id: example
                          likes: 0
                          text: example
                        post_id: example
                        total: 0
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 31
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/company:
    get:
      operationId: linkedin_company
      tags:
      - Linked In
      summary: Company page
      description: 'A company''s public LinkedIn page: industry, size, headquarters, follower and employee counts. Costs 5 credits per successful live response.'
      parameters:
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/company/nasa/
        description: Company LinkedIn URL. Supply either this or domain; do not combine them.
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: domain
        in: query
        required: false
        schema:
          type: string
        example: microsoft.com
        description: 'Alternative to a company URL: discover a bounded set of indexed LinkedIn company pages, then verify an exact returned website hostname. Existing price and limits apply. Ambiguous, missing or unverified matches abstain; this is not exhaustive company search or proof of domain ownership.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/company.json
                      title: linkedin/company data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        id:
                          type:
                          - string
                          - 'null'
                          description: Source identifier. Preserve its exact string value; do not convert large IDs to numbers.
                        name:
                          type:
                          - string
                          - 'null'
                          description: Company name.
                        handle:
                          type:
                          - string
                          - 'null'
                          description: Public company identifier.
                        url:
                          type:
                          - string
                          - 'null'
                          description: Original source URL when supplied.
                        description:
                          type:
                          - string
                          - 'null'
                          description: Company description.
                        website:
                          type:
                          - string
                          - 'null'
                          description: Original source URL when supplied.
                        industry:
                          type:
                          - string
                          - 'null'
                          description: Primary reported industry.
                        size:
                          type:
                          - string
                          - 'null'
                          description: Source employee range, not an exact count.
                        founded:
                          type:
                          - number
                          - 'null'
                          description: Founding year.
                        followers:
                          type:
                          - number
                          - 'null'
                          description: Followers reported by the source; null or absent is unknown, not zero.
                        employees_count:
                          type:
                          - number
                          - 'null'
                          description: Reported employees reported by the source; null or absent is unknown, not zero.
                        headquarters:
                          type:
                          - string
                          - 'null'
                          description: Readable headquarters location.
                        domain_lookup:
                          type: object
                          properties:
                            domain:
                              type:
                              - string
                              - 'null'
                              description: Requested website hostname.
                            status:
                              type:
                              - string
                              - 'null'
                              description: verified on success; unverified on failure.
                            match:
                              type:
                              - string
                              - 'null'
                              description: exact_website_domain means the returned company website matched; not domain ownership.
                            candidates_found:
                              type:
                              - number
                              - 'null'
                              description: Indexed candidate URLs reported by the source; null or absent is unknown, not zero.
                            candidates_checked:
                              type:
                              - number
                              - 'null'
                              description: Checked URLs, at most three reported by the source; null or absent is unknown, not zero.
                            candidates_omitted:
                              type:
                              - number
                              - 'null'
                              description: Indexed URLs not checked reported by the source; null or absent is unknown, not zero.
                            exact_matches:
                              type:
                              - number
                              - 'null'
                              description: Distinct source company IDs with a verified website match reported by the source; null or absent is unknown, not zero.
                            exact_match_pages:
                              type:
                              - number
                              - 'null'
                              description: Verified matching URLs before native-ID grouping reported by the source; null or absent is unknown, not zero.
                            verified_candidates:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type:
                                    - string
                                    - 'null'
                                    description: Source identifier. Preserve its exact string value; do not convert large IDs to numbers.
                                  name:
                                    type:
                                    - string
                                    - 'null'
                                    description: Source company name, capped at 300 characters.
                                  url:
                                    type:
                                    - string
                                    - 'null'
                                    description: Original source URL when supplied.
                                  website:
                                    type:
                                    - string
                                    - 'null'
                                    description: Original source URL when supplied.
                                  matched_urls:
                                    type: array
                                    items:
                                      type: string
                                    maxItems: 3
                                    description: Checked aliases joined only by an identical native company ID.
                                additionalProperties: true
                              maxItems: 3
                          additionalProperties: true
                        _warnings:
                          type: array
                          items:
                            type: string
                          description: Collection limitations or component warnings. Read before interpreting coverage.
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - id
                          properties:
                            id:
                              type:
                              - string
                              description: Source identifier. Preserve its exact string value; do not convert large IDs to numbers.
                              minLength: 1
                        - required:
                          - name
                          properties:
                            name:
                              type:
                              - string
                              description: Company name.
                              minLength: 1
                        - required:
                          - handle
                          properties:
                            handle:
                              type:
                              - string
                              description: Public company identifier.
                              minLength: 1
                        - required:
                          - url
                          properties:
                            url:
                              type:
                              - string
                              description: Original source URL when supplied.
                              minLength: 1
                        - required:
                          - description
                          properties:
                            description:
                              type:
                              - string
                              description: Company description.
                              minLength: 1
                        - required:
                          - website
                          properties:
                            website:
                              type:
                              - string
                              description: Original source URL when supplied.
                              minLength: 1
                        - required:
                          - industry
                          properties:
                            industry:
                              type:
                              - string
                              description: Primary reported industry.
                              minLength: 1
                        - required:
                          - size
                          properties:
                            size:
                              type:
                              - string
                              description: Source employee range, not an exact count.
                              minLength: 1
                        - required:
                          - founded
                          properties:
                            founded:
                              type:
                              - number
                              description: Founding year.
                        - required:
                          - followers
                          properties:
                            followers:
                              type:
                              - number
                              description: Followers reported by the source; null or absent is unknown, not zero.
                        - required:
                          - employees_count
                          properties:
                            employees_count:
                              type:
                              - number
                              description: Reported employees reported by the source; null or absent is unknown, not zero.
                        - required:
                          - headquarters
                          properties:
                            headquarters:
                              type:
                              - string
                              description: Readable headquarters location.
                              minLength: 1
                        - required:
                          - domain_lookup
                          properties:
                            domain_lookup:
                              type: object
                              properties:
                                domain:
                                  type:
                                  - string
                                  - 'null'
                                  description: Requested website hostname.
                                status:
                                  type:
                                  - string
                                  - 'null'
                                  description: verified on success; unverified on failure.
                                match:
                                  type:
                                  - string
                                  - 'null'
                                  description: exact_website_domain means the returned company website matched; not domain ownership.
                                candidates_found:
                                  type:
                                  - number
                                  - 'null'
                                  description: Indexed candidate URLs reported by the source; null or absent is unknown, not zero.
                                candidates_checked:
                                  type:
                                  - number
                                  - 'null'
                                  description: Checked URLs, at most three reported by the source; null or absent is unknown, not zero.
                                candidates_omitted:
                                  type:
                                  - number
                                  - 'null'
                                  description: Indexed URLs not checked reported by the source; null or absent is unknown, not zero.
                                exact_matches:
                                  type:
                                  - number
                                  - 'null'
                                  description: Distinct source company IDs with a verified website match reported by the source; null or absent is unknown, not zero.
                                exact_match_pages:
                                  type:
                                  - number
                                  - 'null'
                                  description: Verified matching URLs before native-ID grouping reported by the source; null or absent is unknown, not zero.
                                verified_candidates:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      id:
                                        type:
                                        - string
                                        - 'null'
                                        description: Source identifier. Preserve its exact string value; do not convert large IDs to numbers.
                                      name:
                                        type:
                                        - string
                                        - 'null'
                                        description: Source company name, capped at 300 characters.
                                      url:
                                        type:
                                        - string
                                        - 'null'
                                        description: Original source URL when supplied.
                                      website:
                                        type:
                                        - string
                                        - 'null'
                                        description: Original source URL when supplied.
                                      matched_urls:
                                        type: array
                                        items:
                                          type: string
                                        maxItems: 3
                                        description: Checked aliases joined only by an identical native company ID.
                                    additionalProperties: true
                                  maxItems: 3
                              additionalProperties: true
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - id: '12345'
                        name: Example Company
                        handle: example-company
                        size: 11-50
                        followers: 1200
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 5
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/company-affiliated-pages:
    get:
      operationId: linkedin_company_affiliated_pages
      tags:
      - Linked In
      summary: LinkedIn company affiliated pages
      description: 'A company''s affiliated and showcase pages: id, name, handle, URL, type, speciality, follower count and logo. Not paged upstream. Costs 3 credits per successful live response.'
      parameters:
      - name: company_id
        in: query
        required: true
        schema:
          type: string
        example: '1441'
        description: The numeric LinkedIn company id (as linkedin/company answers it) or a company URL carrying it
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/company-affiliated-pages.json
                      title: linkedin/company-affiliated-pages data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        company_id:
                          description: Optional company id supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              followers:
                                description: Optional followers supplied by this operation. Null means unknown.
                                type:
                                - number
                                - 'null'
                              handle:
                                description: Optional handle supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              logo:
                                description: Optional logo supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              name:
                                description: Optional name supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              speciality:
                                description: Optional speciality supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              type:
                                description: Optional type supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - followers
                                properties:
                                  followers:
                                    description: Optional followers supplied by this operation. Null means unknown.
                                    type:
                                    - number
                              - required:
                                - handle
                                properties:
                                  handle:
                                    description: Optional handle supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - logo
                                properties:
                                  logo:
                                    description: Optional logo supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - name
                                properties:
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - speciality
                                properties:
                                  speciality:
                                    description: Optional speciality supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    minLength: 1
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - company_id: example
                        count: 0
                        has_more: false
                        items:
                        - followers: 0
                          handle: example
                          id: example
                          logo: example
                          name: example
                          speciality: example
                          type: example
                          url: https://example.com/example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 3
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/company-job-count:
    get:
      operationId: linkedin_company_job_count
      tags:
      - Linked In
      summary: LinkedIn company open jobs
      description: The number of open jobs a company lists. Costs 3 credits per successful live response.
      parameters:
      - name: company_id
        in: query
        required: true
        schema:
          type: string
        example: '783611'
        description: The numeric LinkedIn company id (as linkedin/company answers it) or a company URL carrying it
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/company-job-count.json
                      title: linkedin/company-job-count data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        company_id:
                          type:
                          - string
                          - 'null'
                          description: Exact source identifier; preserve it as a string.
                        open_jobs:
                          type:
                          - number
                          - 'null'
                          description: Source-reported current openings.
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - company_id
                          properties:
                            company_id:
                              type:
                              - string
                              description: Exact source identifier; preserve it as a string.
                              minLength: 1
                        - required:
                          - open_jobs
                          properties:
                            open_jobs:
                              type:
                              - number
                              description: Source-reported current openings.
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - company_id: '123'
                        open_jobs: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 3
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/company-jobs:
    get:
      operationId: linkedin_company_jobs
      tags:
      - Linked In
      summary: LinkedIn company jobs
      description: 'Open roles at a company, one page at a time: title, location, posting time, employment type, seniority, remote flag, salary where stated and applicant count. Costs 3 credits per successful live response.'
      parameters:
      - name: organization_id
        in: query
        required: true
        schema:
          type: string
        example: '1441'
        description: LinkedIn organisation id (from jobs/linkedin/organizations)
      - name: query
        in: query
        required: false
        schema:
          type: string
        example: engineer
        description: Keywords to narrow the roles
      - name: location
        in: query
        required: false
        schema:
          type: string
        example: London
        description: Country or city
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Cursor from the previous page
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/company-jobs.json
                      title: linkedin/company-jobs data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        cursor:
                          description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                          type:
                          - string
                          - 'null'
                        dropped:
                          description: Optional dropped supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              benefits:
                                description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                type:
                                - array
                                - 'null'
                                items: {}
                              board:
                                description: Optional board supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              company:
                                description: Optional company supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  addresses:
                                    description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                    type:
                                    - array
                                    - 'null'
                                    items: {}
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              date_posted:
                                description: Optional date posted supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              industries:
                                description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                type:
                                - array
                                - 'null'
                                items: {}
                              location:
                                description: Optional location supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              platform:
                                description: Optional platform supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              posted:
                                description: Optional posted supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              skills:
                                description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                type:
                                - array
                                - 'null'
                                items: {}
                              title:
                                description: Source title when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - benefits
                                properties:
                                  benefits:
                                    description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                    type:
                                    - array
                                    items: {}
                              - required:
                                - board
                                properties:
                                  board:
                                    description: Optional board supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - company
                                properties:
                                  company:
                                    description: Optional company supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      addresses:
                                        description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                        type:
                                        - array
                                        - 'null'
                                        items: {}
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - date_posted
                                properties:
                                  date_posted:
                                    description: Optional date posted supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - industries
                                properties:
                                  industries:
                                    description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                    type:
                                    - array
                                    items: {}
                              - required:
                                - location
                                properties:
                                  location:
                                    description: Optional location supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - posted
                                properties:
                                  posted:
                                    description: Optional posted supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - skills
                                properties:
                                  skills:
                                    description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                    type:
                                    - array
                                    items: {}
                              - required:
                                - title
                                properties:
                                  title:
                                    description: Source title when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    minLength: 1
                        total:
                          description: Source-reported total; null is unknown.
                          type:
                          - number
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        cursor: null
                        dropped: 0
                        has_more: false
                        items:
                        - benefits: []
                          board: example
                          company:
                            addresses: []
                            name: example
                          date_posted: '2026-09-01T12:00:00Z'
                          id: example
                          industries: []
                          location: example
                          platform: example
                          posted: example
                          skills: []
                          title: example
                          url: https://example.com/example
                        total: 0
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 3
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/company-people:
    get:
      operationId: linkedin_company_people
      tags:
      - Linked In
      summary: LinkedIn company employees
      description: 'People who list the company as their employer, twelve a page with the total: name, headline and profile. Costs 8 credits per successful live response.'
      parameters:
      - name: handle
        in: query
        required: false
        schema:
          type: string
        example: microsoft
        description: The company's LinkedIn handle or page URL (or pass organization_id)
      - name: organization_id
        in: query
        required: false
        schema:
          type: string
        example: '1035'
        description: Numeric LinkedIn company id — alternative to handle
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: '2'
        description: Continue with the complete cursor from the previous response and the original target. Do not edit it. Source coverage varies; a fallback continuation is bound to its source and account and expires after one hour.
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/company-people.json
                      title: linkedin/company-people data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        company_id:
                          description: Optional company id supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        cursor:
                          description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                          type:
                          - string
                          - 'null'
                        dropped:
                          description: Optional dropped supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              avatar:
                                description: Optional avatar supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              handle:
                                description: Optional handle supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              headline:
                                description: Optional headline supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              name:
                                description: Optional name supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              platform:
                                description: Optional platform supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - avatar
                                properties:
                                  avatar:
                                    description: Optional avatar supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - handle
                                properties:
                                  handle:
                                    description: Optional handle supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - headline
                                properties:
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - name
                                properties:
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    minLength: 1
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        total:
                          description: Source-reported total; null is unknown.
                          type:
                          - number
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - company_id: example
                        count: 0
                        cursor: null
                        dropped: 0
                        has_more: false
                        items:
                        - avatar: https://example.com/example
                          handle: example
                          headline: example
                          name: example
                          platform: example
                          url: https://example.com/example
                        page: 0
                        total: 0
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 8
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/company-posts:
    get:
      operationId: linkedin_company_posts
      tags:
      - Linked In
      summary: Company posts
      description: Recent posts from a company's LinkedIn page, one numbered page at a time. Costs 4 credits per successful live response.
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        example: https://www.linkedin.com/company/nasa/
        description: LinkedIn company URL.
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number, 1 to 7 (the supplier documents up to seven pages); omitted = the first page
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: '2'
        description: 'Continuation: the cursor from the previous answer (the next page number). Use it instead of page.'
      - name: pages
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: 'Optional bounded collection of 1–3 source pages at the normal price, within one shared spending limit and total deadline. Default 1. Inspect pages_fetched, partial and window_stop_reason: fewer pages may fit. Continue using the returned cursor with the same pages and filters. Source order is preserved; this is not an exhaustive result set.'
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/company-posts.json
                      title: linkedin/company-posts data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type:
                                - string
                                - 'null'
                                description: Source identifier. Preserve its exact string value; do not convert large IDs to numbers.
                              url:
                                type:
                                - string
                                - 'null'
                                description: Original source URL when supplied.
                              text:
                                type:
                                - string
                                - 'null'
                                description: Post text.
                              created_at:
                                type:
                                - string
                                - 'null'
                                description: Source publication time, normalized to an ISO date-time when available.
                              stats:
                                type: object
                                properties:
                                  likes:
                                    type:
                                    - number
                                    - 'null'
                                    description: likes reported by the source; null or absent is unknown, not zero.
                                  comments:
                                    type:
                                    - number
                                    - 'null'
                                    description: comments reported by the source; null or absent is unknown, not zero.
                                  shares:
                                    type:
                                    - number
                                    - 'null'
                                    description: shares reported by the source; null or absent is unknown, not zero.
                                additionalProperties: true
                              author:
                                type: object
                                properties:
                                  name:
                                    type:
                                    - string
                                    - 'null'
                                    description: Author display name.
                                  url:
                                    type:
                                    - string
                                    - 'null'
                                    description: Original source URL when supplied.
                                  handle:
                                    type:
                                    - string
                                    - 'null'
                                    description: Public account identifier.
                                  followers:
                                    type:
                                    - number
                                    - 'null'
                                    description: Followers reported by the source; null or absent is unknown, not zero.
                                additionalProperties: true
                              is_repost:
                                type:
                                - boolean
                                - 'null'
                                description: Source repost flag when known.
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    type:
                                    - string
                                    description: Source identifier. Preserve its exact string value; do not convert large IDs to numbers.
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    type:
                                    - string
                                    description: Original source URL when supplied.
                                    minLength: 1
                              - required:
                                - text
                                properties:
                                  text:
                                    type:
                                    - string
                                    description: Post text.
                                    minLength: 1
                              - required:
                                - created_at
                                properties:
                                  created_at:
                                    type:
                                    - string
                                    description: Source publication time, normalized to an ISO date-time when available.
                                    minLength: 1
                              - required:
                                - stats
                                properties:
                                  stats:
                                    type: object
                                    properties:
                                      likes:
                                        type:
                                        - number
                                        - 'null'
                                        description: likes reported by the source; null or absent is unknown, not zero.
                                      comments:
                                        type:
                                        - number
                                        - 'null'
                                        description: comments reported by the source; null or absent is unknown, not zero.
                                      shares:
                                        type:
                                        - number
                                        - 'null'
                                        description: shares reported by the source; null or absent is unknown, not zero.
                                    additionalProperties: true
                              - required:
                                - author
                                properties:
                                  author:
                                    type: object
                                    properties:
                                      name:
                                        type:
                                        - string
                                        - 'null'
                                        description: Author display name.
                                      url:
                                        type:
                                        - string
                                        - 'null'
                                        description: Original source URL when supplied.
                                      handle:
                                        type:
                                        - string
                                        - 'null'
                                        description: Public account identifier.
                                      followers:
                                        type:
                                        - number
                                        - 'null'
                                        description: Followers reported by the source; null or absent is unknown, not zero.
                                    additionalProperties: true
                              - required:
                                - is_repost
                                properties:
                                  is_repost:
                                    type:
                                    - boolean
                                    description: Source repost flag when known.
                          description: Records in this response page.
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned row count when supplied; not the full source total.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque next-page token. A missing token does not prove full history was retrieved.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator; null means unknown.
                        _warnings:
                          type: array
                          items:
                            type: string
                          description: Collection limitations or component warnings. Read before interpreting coverage.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items:
                        - id: urn:li:activity:1234567890123456789
                          text: Illustrative company post
                          stats:
                            likes: 12
                            comments: 3
                        cursor: null
                        has_more: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 4
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/company-profile:
    get:
      operationId: linkedin_company_profile
      tags:
      - Linked In
      summary: LinkedIn company record
      description: 'The enriched record for one company: industry, description, type, size band, headcount and its change over a month, quarter and year, followers, founding year, headquarters, revenue and funding where known, and open-role count. Distinct from linkedin/company, which answers what the public page shows. Costs 5 credits per successful live response.'
      parameters:
      - name: handle
        in: query
        required: false
        schema:
          type: string
        example: google
        description: Company handle (the URL slug)
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/company/google
        description: Full company URL, instead of the handle
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/company-profile.json
                      title: linkedin/company-profile data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        cover:
                          description: Optional cover supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        description:
                          description: Source description; null or absent means not supplied.
                          type:
                          - string
                          - 'null'
                        employees:
                          description: Optional employees supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        employees_range:
                          description: Optional employees range supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        followers:
                          description: Optional followers supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        handle:
                          description: Optional handle supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        hq:
                          description: Optional hq supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            city:
                              description: Optional city supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            country:
                              description: Optional country supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            line:
                              description: Optional line supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            postal_code:
                              description: Optional postal code supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            region:
                              description: Optional region supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                        id:
                          description: Source identifier. Preserve the supplied type and exact value.
                          type:
                          - string
                          - 'null'
                        industries:
                          description: Optional industries supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - string
                            - 'null'
                        logo:
                          description: Optional logo supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        name:
                          description: Optional name supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        platform:
                          description: Optional platform supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        specialities:
                          description: Optional specialities supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - string
                            - 'null'
                        url:
                          description: Original source URL when supplied.
                          type:
                          - string
                          - 'null'
                        website:
                          description: Optional website supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - cover
                          properties:
                            cover:
                              description: Optional cover supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - description
                          properties:
                            description:
                              description: Source description; null or absent means not supplied.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - employees
                          properties:
                            employees:
                              description: Optional employees supplied by this operation. Null means unknown.
                              type:
                              - number
                        - required:
                          - employees_range
                          properties:
                            employees_range:
                              description: Optional employees range supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - followers
                          properties:
                            followers:
                              description: Optional followers supplied by this operation. Null means unknown.
                              type:
                              - number
                        - required:
                          - handle
                          properties:
                            handle:
                              description: Optional handle supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - hq
                          properties:
                            hq:
                              description: Optional hq supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                city:
                                  description: Optional city supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                country:
                                  description: Optional country supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                line:
                                  description: Optional line supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                postal_code:
                                  description: Optional postal code supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                region:
                                  description: Optional region supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - id
                          properties:
                            id:
                              description: Source identifier. Preserve the supplied type and exact value.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - industries
                          properties:
                            industries:
                              description: Optional industries supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                        - required:
                          - logo
                          properties:
                            logo:
                              description: Optional logo supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - name
                          properties:
                            name:
                              description: Optional name supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - specialities
                          properties:
                            specialities:
                              description: Optional specialities supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                        - required:
                          - url
                          properties:
                            url:
                              description: Original source URL when supplied.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - website
                          properties:
                            website:
                              description: Optional website supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - cover: example
                        description: example
                        employees: 0
                        employees_range: example
                        followers: 0
                        handle: example
                        hq:
                          city: example
                          country: example
                          line: example
                          postal_code: example
                          region: example
                        id: example
                        industries:
                        - example
                        logo: example
                        name: example
                        platform: example
                        specialities:
                        - example
                        url: https://example.com/example
                        website: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 5
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/group:
    get:
      operationId: linkedin_group
      tags:
      - Linked In
      summary: LinkedIn group
      description: 'A LinkedIn group: name, members, description, rules, owners, industries and images. Costs 3 credits per successful live response.'
      parameters:
      - name: group_id
        in: query
        required: true
        schema:
          type: string
        example: '62438'
        description: A LinkedIn group id or URL
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/group.json
                      title: linkedin/group data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        active:
                          description: Optional active supplied by this operation. Null means unknown.
                          type:
                          - boolean
                          - 'null'
                        cover:
                          description: Optional cover supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        created_at:
                          description: Source creation time, not the API retrieval time.
                          type:
                          - string
                          - 'null'
                        description:
                          description: Source description; null or absent means not supplied.
                          type:
                          - string
                          - 'null'
                        id:
                          description: Source identifier. Preserve the supplied type and exact value.
                          type:
                          - string
                          - 'null'
                        industries:
                          description: Optional industries supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - string
                            - 'null'
                        logo:
                          description: Optional logo supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        members:
                          description: Optional members supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        name:
                          description: Optional name supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        owners:
                          description: Optional owners supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - object
                            - 'null'
                            properties:
                              handle:
                                description: Optional handle supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              headline:
                                description: Optional headline supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              joined_at:
                                description: Optional joined at supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              name:
                                description: Optional name supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                        platform:
                          description: Optional platform supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        post_approval_required:
                          description: Optional post approval required supplied by this operation. Null means unknown.
                          type:
                          - boolean
                          - 'null'
                        public:
                          description: Optional public supplied by this operation. Null means unknown.
                          type:
                          - boolean
                          - 'null'
                        rules:
                          description: Optional rules supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        url:
                          description: Original source URL when supplied.
                          type:
                          - string
                          - 'null'
                        urn:
                          description: Optional urn supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - active
                          properties:
                            active:
                              description: Optional active supplied by this operation. Null means unknown.
                              type:
                              - boolean
                        - required:
                          - cover
                          properties:
                            cover:
                              description: Optional cover supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - created_at
                          properties:
                            created_at:
                              description: Source creation time, not the API retrieval time.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - description
                          properties:
                            description:
                              description: Source description; null or absent means not supplied.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - id
                          properties:
                            id:
                              description: Source identifier. Preserve the supplied type and exact value.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - industries
                          properties:
                            industries:
                              description: Optional industries supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                        - required:
                          - logo
                          properties:
                            logo:
                              description: Optional logo supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - members
                          properties:
                            members:
                              description: Optional members supplied by this operation. Null means unknown.
                              type:
                              - number
                        - required:
                          - name
                          properties:
                            name:
                              description: Optional name supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - owners
                          properties:
                            owners:
                              description: Optional owners supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  handle:
                                    description: Optional handle supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  joined_at:
                                    description: Optional joined at supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                        - required:
                          - post_approval_required
                          properties:
                            post_approval_required:
                              description: Optional post approval required supplied by this operation. Null means unknown.
                              type:
                              - boolean
                        - required:
                          - public
                          properties:
                            public:
                              description: Optional public supplied by this operation. Null means unknown.
                              type:
                              - boolean
                        - required:
                          - rules
                          properties:
                            rules:
                              description: Optional rules supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - url
                          properties:
                            url:
                              description: Original source URL when supplied.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - urn
                          properties:
                            urn:
                              description: Optional urn supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - active: false
                        cover: example
                        created_at: '2026-09-01T12:00:00Z'
                        description: example
                        id: example
                        industries:
                        - example
                        logo: example
                        members: 0
                        name: example
                        owners:
                        - handle: example
                          headline: example
                          joined_at: '2026-09-01T12:00:00Z'
                          name: example
                          url: https://example.com/example
                        platform: example
                        post_approval_required: false
                        public: false
                        rules: example
                        url: https://example.com/example
                        urn: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 3
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/group-posts:
    get:
      operationId: linkedin_group_posts
      tags:
      - Linked In
      summary: LinkedIn group posts
      description: Posts in a LinkedIn group with available text, media, engagement and author. Continue with the returned cursor and the same group and account; when a cursor is returned it is required for that source's next page. A page number alone does not switch an existing traversal to another source. Total collection size and completeness may be unknown. Costs 5 credits per successful live response.
      parameters:
      - name: group_id
        in: query
        required: true
        schema:
          type: string
        example: '62438'
        description: A LinkedIn group id or URL
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number, starting at 1. With a returned cursor, omit page or supply the matching next page. A page number alone cannot continue a source that requires its cursor.
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Opaque continuation from the previous response. Keep the same group and account; do not edit the token. Required for subsequent pages when returned.
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/group-posts.json
                      title: linkedin/group-posts data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        cursor:
                          description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                          type:
                          - string
                          - 'null'
                        group_id:
                          description: Optional group id supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              author:
                                description: Public author information supplied with this record.
                                type:
                                - object
                                - 'null'
                                properties:
                                  account_type:
                                    description: Optional account type supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  avatar:
                                    description: Optional avatar supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  handle:
                                    description: Optional handle supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              comments_preview:
                                description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                type:
                                - array
                                - 'null'
                                items: {}
                              created_at:
                                description: Source creation time, not the API retrieval time.
                                type:
                                - string
                                - 'null'
                              document:
                                description: Optional document supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  pages:
                                    description: Optional pages supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  title:
                                    description: Source title when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              image:
                                description: Optional image supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              images:
                                description: Optional images supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              links:
                                description: Optional links supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              platform:
                                description: Optional platform supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              post_type:
                                description: Optional post type supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              stats:
                                description: Optional stats supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  comments:
                                    description: Optional comments supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  likes:
                                    description: Optional likes supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  reactions:
                                    description: Optional reactions supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    - 'null'
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - object
                                      - 'null'
                                      properties: {}
                                      additionalProperties: true
                                  shares:
                                    description: Optional shares supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                additionalProperties: true
                              text:
                                description: Source text when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                              urns:
                                description: Optional urns supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  share:
                                    description: Optional share supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              video_thumbnail:
                                description: Optional video thumbnail supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - author
                                properties:
                                  author:
                                    description: Public author information supplied with this record.
                                    type:
                                    - object
                                    properties:
                                      account_type:
                                        description: Optional account type supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      avatar:
                                        description: Optional avatar supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      handle:
                                        description: Optional handle supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      headline:
                                        description: Optional headline supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      id:
                                        description: Source identifier. Preserve the supplied type and exact value.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - comments_preview
                                properties:
                                  comments_preview:
                                    description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                    type:
                                    - array
                                    items: {}
                              - required:
                                - created_at
                                properties:
                                  created_at:
                                    description: Source creation time, not the API retrieval time.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - document
                                properties:
                                  document:
                                    description: Optional document supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      pages:
                                        description: Optional pages supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      title:
                                        description: Source title when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - image
                                properties:
                                  image:
                                    description: Optional image supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - images
                                properties:
                                  images:
                                    description: Optional images supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                              - required:
                                - links
                                properties:
                                  links:
                                    description: Optional links supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                              - required:
                                - post_type
                                properties:
                                  post_type:
                                    description: Optional post type supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - stats
                                properties:
                                  stats:
                                    description: Optional stats supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      comments:
                                        description: Optional comments supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      likes:
                                        description: Optional likes supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      reactions:
                                        description: Optional reactions supplied by this operation. Null means unknown.
                                        type:
                                        - array
                                        - 'null'
                                        items:
                                          description: Optional record supplied by this operation. Null means unknown.
                                          type:
                                          - object
                                          - 'null'
                                          properties: {}
                                          additionalProperties: true
                                      shares:
                                        description: Optional shares supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - text
                                properties:
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - urns
                                properties:
                                  urns:
                                    description: Optional urns supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      share:
                                        description: Optional share supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - video_thumbnail
                                properties:
                                  video_thumbnail:
                                    description: Optional video thumbnail supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        total:
                          description: Source-reported total; null is unknown.
                          type:
                          - number
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        cursor: null
                        group_id: example
                        has_more: false
                        items:
                        - author:
                            account_type: example
                            avatar: https://example.com/example
                            handle: example
                            headline: example
                            id: example
                            name: example
                            url: https://example.com/example
                          comments_preview: []
                          created_at: '2026-09-01T12:00:00Z'
                          document:
                            pages: 0
                            title: example
                          id: example
                          image: https://example.com/example
                          images:
                          - example
                          links:
                          - example
                          platform: example
                          post_type: example
                          stats:
                            comments: 0
                            likes: 0
                            reactions:
                            - {}
                            shares: 0
                          text: example
                          url: https://example.com/example
                          urns:
                            share: example
                          video_thumbnail: example
                        page: 0
                        total: 0
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 5
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/job:
    get:
      operationId: linkedin_job
      tags:
      - Linked In
      summary: LinkedIn job posting
      description: 'One job posting in full: title, company, location, description, posting and last-seen times, employment type, seniority, remote flag, salary where stated, applicant count and the external apply link. Costs 1 credit per successful live response.'
      parameters:
      - name: id
        in: query
        required: true
        schema:
          type: string
        example: '4344456572'
        description: Job id from a search result
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/job.json
                      title: linkedin/job data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        id:
                          type:
                          - string
                          - 'null'
                          description: Exact source identifier; preserve it as a string.
                        title:
                          type:
                          - string
                          - 'null'
                          description: title
                        location:
                          type:
                          - string
                          - 'null'
                          description: location
                        country:
                          type:
                          - string
                          - 'null'
                          description: country
                        country_code:
                          type:
                          - string
                          - 'null'
                          description: country code
                        description:
                          type:
                          - string
                          - 'null'
                          description: description
                        description_html:
                          type:
                          - string
                          - 'null'
                          description: description html
                        date_posted:
                          type:
                          - string
                          - 'null'
                          description: date posted
                        employment_type:
                          type:
                          - string
                          - 'null'
                          description: employment type
                        apply_url:
                          type:
                          - string
                          - 'null'
                          description: apply url
                        url:
                          type:
                          - string
                          - 'null'
                          description: url
                        company:
                          type:
                          - object
                          - 'null'
                          properties:
                            name:
                              type:
                              - string
                              - 'null'
                              description: name
                            image:
                              type:
                              - string
                              - 'null'
                              description: image
                          additionalProperties: true
                        salary:
                          type:
                          - object
                          - 'null'
                          properties:
                            min:
                              type:
                              - number
                              - 'null'
                              description: Lower salary amount.
                            max:
                              type:
                              - number
                              - 'null'
                              description: Upper salary amount.
                            currency:
                              type:
                              - string
                              - 'null'
                              description: Source currency code.
                          additionalProperties: true
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - id
                          properties:
                            id:
                              type:
                              - string
                              description: Exact source identifier; preserve it as a string.
                              minLength: 1
                        - required:
                          - title
                          properties:
                            title:
                              type:
                              - string
                              description: title
                              minLength: 1
                        - required:
                          - location
                          properties:
                            location:
                              type:
                              - string
                              description: location
                              minLength: 1
                        - required:
                          - country
                          properties:
                            country:
                              type:
                              - string
                              description: country
                              minLength: 1
                        - required:
                          - country_code
                          properties:
                            country_code:
                              type:
                              - string
                              description: country code
                              minLength: 1
                        - required:
                          - description
                          properties:
                            description:
                              type:
                              - string
                              description: description
                              minLength: 1
                        - required:
                          - description_html
                          properties:
                            description_html:
                              type:
                              - string
                              description: description html
                              minLength: 1
                        - required:
                          - date_posted
                          properties:
                            date_posted:
                              type:
                              - string
                              description: date posted
                              minLength: 1
                        - required:
                          - employment_type
                          properties:
                            employment_type:
                              type:
                              - string
                              description: employment type
                              minLength: 1
                        - required:
                          - apply_url
                          properties:
                            apply_url:
                              type:
                              - string
                              description: apply url
                              minLength: 1
                        - required:
                          - url
                          properties:
                            url:
                              type:
                              - string
                              description: url
                              minLength: 1
                        - required:
                          - company
                          properties:
                            company:
                              type:
                              - object
                              properties:
                                name:
                                  type:
                                  - string
                                  - 'null'
                                  description: name
                                image:
                                  type:
                                  - string
                                  - 'null'
                                  description: image
                              additionalProperties: true
                        - required:
                          - salary
                          properties:
                            salary:
                              type:
                              - object
                              properties:
                                min:
                                  type:
                                  - number
                                  - 'null'
                                  description: Lower salary amount.
                                max:
                                  type:
                                  - number
                                  - 'null'
                                  description: Upper salary amount.
                                currency:
                                  type:
                                  - string
                                  - 'null'
                                  description: Source currency code.
                              additionalProperties: true
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - id: '123'
                        title: Example role
                        description: Illustrative job description.
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 1
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/person:
    get:
      operationId: linkedin_person
      tags:
      - Linked In
      summary: LinkedIn person record
      description: 'The enriched record for one person: headline, summary, location, connections and followers, current role, full work history, education, skills, languages and links. Distinct from linkedin/profile, which answers what the public page shows. Email addresses are never returned. Costs 5 credits per successful live response.'
      parameters:
      - name: handle
        in: query
        required: false
        schema:
          type: string
        example: williamhgates
        description: Public profile handle (the URL slug)
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/williamhgates
        description: Full profile URL, instead of the handle
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/person.json
                      title: linkedin/person data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        avatar:
                          description: Optional avatar supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        background_image:
                          description: Optional background image supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        certifications:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        current_role:
                          description: Optional current role supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            company:
                              description: Optional company supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            company_handle:
                              description: Optional company handle supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            company_url:
                              description: Optional company url supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            is_current:
                              description: Optional is current supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            start:
                              description: Optional start supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            title:
                              description: Source title when supplied.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                        education:
                          description: Optional education supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - object
                            - 'null'
                            properties:
                              end:
                                description: Optional end supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              institution:
                                description: Optional institution supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              start:
                                description: Optional start supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                        experience:
                          description: Optional experience supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - object
                            - 'null'
                            properties:
                              company:
                                description: Optional company supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              company_handle:
                                description: Optional company handle supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              company_url:
                                description: Optional company url supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              is_current:
                                description: Optional is current supplied by this operation. Null means unknown.
                                type:
                                - boolean
                                - 'null'
                              start:
                                description: Optional start supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              title:
                                description: Source title when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                        first_name:
                          description: Optional first name supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        handle:
                          description: Optional handle supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        headline:
                          description: Optional headline supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        id:
                          description: Source identifier. Preserve the supplied type and exact value.
                          type:
                          - string
                          - 'null'
                        languages:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        last_name:
                          description: Optional last name supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        location:
                          description: Optional location supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            city:
                              description: Optional city supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            country:
                              description: Optional country supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            full:
                              description: Optional full supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                        name:
                          description: Optional name supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        platform:
                          description: Optional platform supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        position_info:
                          description: Optional position info supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            current_employment_verified:
                              description: Optional current employment verified supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            ordering:
                              description: Optional ordering supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            positions_returned:
                              description: Optional positions returned supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                            positions_with_skills:
                              description: Optional positions with skills supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                            skills_scope:
                              description: Optional skills scope supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                        projects:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        skills:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        summary:
                          description: Optional summary supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        top_position:
                          description: Optional top position supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            company:
                              description: Optional company supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            company_handle:
                              description: Optional company handle supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            company_url:
                              description: Optional company url supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            is_current:
                              description: Optional is current supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            start:
                              description: Optional start supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            title:
                              description: Source title when supplied.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                        url:
                          description: Original source URL when supplied.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - avatar
                          properties:
                            avatar:
                              description: Optional avatar supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - background_image
                          properties:
                            background_image:
                              description: Optional background image supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - certifications
                          properties:
                            certifications:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - current_role
                          properties:
                            current_role:
                              description: Optional current role supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                company:
                                  description: Optional company supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                company_handle:
                                  description: Optional company handle supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                company_url:
                                  description: Optional company url supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                is_current:
                                  description: Optional is current supplied by this operation. Null means unknown.
                                  type:
                                  - boolean
                                  - 'null'
                                start:
                                  description: Optional start supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                title:
                                  description: Source title when supplied.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - education
                          properties:
                            education:
                              description: Optional education supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  end:
                                    description: Optional end supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  institution:
                                    description: Optional institution supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  start:
                                    description: Optional start supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                        - required:
                          - experience
                          properties:
                            experience:
                              description: Optional experience supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  company:
                                    description: Optional company supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  company_handle:
                                    description: Optional company handle supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  company_url:
                                    description: Optional company url supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  is_current:
                                    description: Optional is current supplied by this operation. Null means unknown.
                                    type:
                                    - boolean
                                    - 'null'
                                  start:
                                    description: Optional start supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  title:
                                    description: Source title when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                        - required:
                          - first_name
                          properties:
                            first_name:
                              description: Optional first name supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - handle
                          properties:
                            handle:
                              description: Optional handle supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - headline
                          properties:
                            headline:
                              description: Optional headline supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - id
                          properties:
                            id:
                              description: Source identifier. Preserve the supplied type and exact value.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - languages
                          properties:
                            languages:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - last_name
                          properties:
                            last_name:
                              description: Optional last name supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - location
                          properties:
                            location:
                              description: Optional location supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                city:
                                  description: Optional city supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                country:
                                  description: Optional country supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                full:
                                  description: Optional full supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - name
                          properties:
                            name:
                              description: Optional name supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - position_info
                          properties:
                            position_info:
                              description: Optional position info supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                current_employment_verified:
                                  description: Optional current employment verified supplied by this operation. Null means unknown.
                                  type:
                                  - boolean
                                  - 'null'
                                ordering:
                                  description: Optional ordering supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                positions_returned:
                                  description: Optional positions returned supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                positions_with_skills:
                                  description: Optional positions with skills supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                skills_scope:
                                  description: Optional skills scope supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - projects
                          properties:
                            projects:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - skills
                          properties:
                            skills:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - summary
                          properties:
                            summary:
                              description: Optional summary supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - top_position
                          properties:
                            top_position:
                              description: Optional top position supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                company:
                                  description: Optional company supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                company_handle:
                                  description: Optional company handle supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                company_url:
                                  description: Optional company url supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                is_current:
                                  description: Optional is current supplied by this operation. Null means unknown.
                                  type:
                                  - boolean
                                  - 'null'
                                start:
                                  description: Optional start supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                title:
                                  description: Source title when supplied.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - url
                          properties:
                            url:
                              description: Original source URL when supplied.
                              type:
                              - string
                              minLength: 1
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - avatar: https://example.com/example
                        background_image: https://example.com/example
                        certifications: []
                        current_role:
                          company: example
                          company_handle: example
                          company_url: https://example.com/example
                          is_current: false
                          start: example
                          title: example
                        education:
                        - end: example
                          institution: example
                          start: example
                        experience:
                        - company: example
                          company_handle: example
                          company_url: https://example.com/example
                          is_current: false
                          start: example
                          title: example
                        first_name: example
                        handle: example
                        headline: example
                        id: example
                        languages: []
                        last_name: example
                        location:
                          city: example
                          country: example
                          full: example
                        name: example
                        platform: example
                        position_info:
                          current_employment_verified: false
                          ordering: example
                          positions_returned: 0
                          positions_with_skills: 0
                          skills_scope: example
                        projects: []
                        skills: []
                        summary: example
                        top_position:
                          company: example
                          company_handle: example
                          company_url: https://example.com/example
                          is_current: false
                          start: example
                          title: example
                        url: https://example.com/example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 5
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/post:
    get:
      operationId: linkedin_post
      tags:
      - Linked In
      summary: Post details
      description: 'One LinkedIn post: text, author, like and comment counts, with a short comment preview. Costs 5 credits per successful live response.'
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        example: https://www.linkedin.com/feed/update/urn:li:activity:7500971887234097153
        description: Full LinkedIn post URL.
      - name: include_comments
        in: query
        required: false
        schema:
          type: string
        example: 'false'
        description: Set true to include one comments page within this request’s existing price, spending limit and total deadline. No extra customer charge. Inspect comments_status and comments_page; a failed comments lookup leaves the post available with partial=true. Continue via linkedin/post-comments at that route’s normal price.
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/post.json
                      title: linkedin/post data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        id:
                          type:
                          - string
                          - 'null'
                          description: Source identifier. Preserve its exact string value; do not convert large IDs to numbers.
                        url:
                          type:
                          - string
                          - 'null'
                          description: Original source URL when supplied.
                        text:
                          type:
                          - string
                          - 'null'
                          description: Post text.
                        created_at:
                          type:
                          - string
                          - 'null'
                          description: Source publication time, normalized to an ISO date-time when available.
                        stats:
                          type: object
                          properties:
                            likes:
                              type:
                              - number
                              - 'null'
                              description: likes reported by the source; null or absent is unknown, not zero.
                            comments:
                              type:
                              - number
                              - 'null'
                              description: comments reported by the source; null or absent is unknown, not zero.
                            shares:
                              type:
                              - number
                              - 'null'
                              description: shares reported by the source; null or absent is unknown, not zero.
                          additionalProperties: true
                        author:
                          type: object
                          properties:
                            name:
                              type:
                              - string
                              - 'null'
                              description: Author display name.
                            url:
                              type:
                              - string
                              - 'null'
                              description: Original source URL when supplied.
                            handle:
                              type:
                              - string
                              - 'null'
                              description: Public account identifier.
                            followers:
                              type:
                              - number
                              - 'null'
                              description: Followers reported by the source; null or absent is unknown, not zero.
                          additionalProperties: true
                        is_repost:
                          type:
                          - boolean
                          - 'null'
                          description: Source repost flag when known.
                        _warnings:
                          type: array
                          items:
                            type: string
                          description: Collection limitations or component warnings. Read before interpreting coverage.
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - id
                          properties:
                            id:
                              type:
                              - string
                              description: Source identifier. Preserve its exact string value; do not convert large IDs to numbers.
                              minLength: 1
                        - required:
                          - url
                          properties:
                            url:
                              type:
                              - string
                              description: Original source URL when supplied.
                              minLength: 1
                        - required:
                          - text
                          properties:
                            text:
                              type:
                              - string
                              description: Post text.
                              minLength: 1
                        - required:
                          - created_at
                          properties:
                            created_at:
                              type:
                              - string
                              description: Source publication time, normalized to an ISO date-time when available.
                              minLength: 1
                        - required:
                          - stats
                          properties:
                            stats:
                              type: object
                              properties:
                                likes:
                                  type:
                                  - number
                                  - 'null'
                                  description: likes reported by the source; null or absent is unknown, not zero.
                                comments:
                                  type:
                                  - number
                                  - 'null'
                                  description: comments reported by the source; null or absent is unknown, not zero.
                                shares:
                                  type:
                                  - number
                                  - 'null'
                                  description: shares reported by the source; null or absent is unknown, not zero.
                              additionalProperties: true
                        - required:
                          - author
                          properties:
                            author:
                              type: object
                              properties:
                                name:
                                  type:
                                  - string
                                  - 'null'
                                  description: Author display name.
                                url:
                                  type:
                                  - string
                                  - 'null'
                                  description: Original source URL when supplied.
                                handle:
                                  type:
                                  - string
                                  - 'null'
                                  description: Public account identifier.
                                followers:
                                  type:
                                  - number
                                  - 'null'
                                  description: Followers reported by the source; null or absent is unknown, not zero.
                              additionalProperties: true
                        - required:
                          - is_repost
                          properties:
                            is_repost:
                              type:
                              - boolean
                              description: Source repost flag when known.
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - id: urn:li:activity:1234567890123456789
                        text: Illustrative company post
                        stats:
                          likes: 12
                          comments: 3
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 5
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/post-comments:
    get:
      operationId: linkedin_post_comments
      tags:
      - Linked In
      summary: LinkedIn post comments
      description: 'A post''s comments, ten a page with the total: text, time, likes, reply count, pinned and edited flags, the commenter''s name, headline and profile. Costs 4 credits per successful live response.'
      parameters:
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/feed/update/urn:li:activity:7496695637644828672
        description: Post URL (or pass comments_urn from a profile-posts card, which saves a request)
      - name: comments_urn
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: urns.comments from a profile-posts card
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: '2'
        description: Continue with the complete cursor from the previous response and the original target. Do not edit it. Source coverage varies; a fallback continuation is bound to its source and account and expires after one hour.
      - name: pages
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: 'Optional bounded collection of 1–3 source pages at the normal price, within one shared spending limit and total deadline. Default 1. Inspect pages_fetched, partial and window_stop_reason: fewer pages may fit. Continue using the returned cursor with the same pages and filters. Source order is preserved; this is not an exhaustive result set.'
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/post-comments.json
                      title: linkedin/post-comments data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        cursor:
                          description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                          type:
                          - string
                          - 'null'
                        dropped:
                          description: Optional dropped supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              author:
                                description: Public author information supplied with this record.
                                type:
                                - object
                                - 'null'
                                properties:
                                  avatar:
                                    description: Optional avatar supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              created_at:
                                description: Source creation time, not the API retrieval time.
                                type:
                                - string
                                - 'null'
                              edited:
                                description: Optional edited supplied by this operation. Null means unknown.
                                type:
                                - boolean
                                - 'null'
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              likes:
                                description: Optional likes supplied by this operation. Null means unknown.
                                type:
                                - number
                                - 'null'
                              pinned:
                                description: Optional pinned supplied by this operation. Null means unknown.
                                type:
                                - boolean
                                - 'null'
                              reply_count:
                                description: Optional reply count supplied by this operation. Null means unknown.
                                type:
                                - number
                                - 'null'
                              text:
                                description: Source text when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - author
                                properties:
                                  author:
                                    description: Public author information supplied with this record.
                                    type:
                                    - object
                                    properties:
                                      avatar:
                                        description: Optional avatar supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      headline:
                                        description: Optional headline supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - created_at
                                properties:
                                  created_at:
                                    description: Source creation time, not the API retrieval time.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - edited
                                properties:
                                  edited:
                                    description: Optional edited supplied by this operation. Null means unknown.
                                    type:
                                    - boolean
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - likes
                                properties:
                                  likes:
                                    description: Optional likes supplied by this operation. Null means unknown.
                                    type:
                                    - number
                              - required:
                                - pinned
                                properties:
                                  pinned:
                                    description: Optional pinned supplied by this operation. Null means unknown.
                                    type:
                                    - boolean
                              - required:
                                - reply_count
                                properties:
                                  reply_count:
                                    description: Optional reply count supplied by this operation. Null means unknown.
                                    type:
                                    - number
                              - required:
                                - text
                                properties:
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    minLength: 1
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        post_url:
                          description: Optional post url supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        total:
                          description: Source-reported total; null is unknown.
                          type:
                          - number
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        cursor: null
                        dropped: 0
                        has_more: false
                        items:
                        - author:
                            avatar: https://example.com/example
                            headline: example
                            name: example
                            url: https://example.com/example
                          created_at: '2026-09-01T12:00:00Z'
                          edited: false
                          id: example
                          likes: 0
                          pinned: false
                          reply_count: 0
                          text: example
                          url: https://example.com/example
                        page: 0
                        post_url: https://example.com/example
                        total: 0
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 4
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/post-reactions:
    get:
      operationId: linkedin_post_reactions
      tags:
      - Linked In
      summary: LinkedIn post reactions
      description: 'Who reacted to a post and how, up to ten records per response: reaction type, name, headline and profile. Totals are source-reported and may include unavailable reactions. Continue with the complete returned cursor and the same post. A newly acquired source page costs eight credits; saved continuation pages marked next_page_credits=0 are free and expire after one hour. Source coverage depends on the supplied post identifier. Costs 8 credits per successful live response.'
      parameters:
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/feed/update/urn:li:activity:7496695637644828672
        description: Post URL (or pass reactions_urn from a profile-posts card)
      - name: reactions_urn
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: urns.reactions from a profile-posts card
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: '2'
        description: Opaque continuation from the previous response. Keep the same post and account; do not edit the token. Saved pages with next_page_credits=0 are free for one hour; a new source acquisition uses the normal endpoint price.
      - name: pages
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: 'Optional bounded collection of 1–3 source pages at the normal price, within one shared spending limit and total deadline. Default 1. Inspect pages_fetched, partial and window_stop_reason: fewer pages may fit. Continue using the returned cursor with the same pages and filters. Source order is preserved; this is not an exhaustive result set.'
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/post-reactions.json
                      title: linkedin/post-reactions data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        cursor:
                          description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                          type:
                          - string
                          - 'null'
                        dropped:
                          description: Optional dropped supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              actor:
                                description: Optional actor supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  avatar:
                                    description: Optional avatar supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              type:
                                description: Optional type supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - actor
                                properties:
                                  actor:
                                    description: Optional actor supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      avatar:
                                        description: Optional avatar supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      headline:
                                        description: Optional headline supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      id:
                                        description: Source identifier. Preserve the supplied type and exact value.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        post_url:
                          description: Optional post url supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        total:
                          description: Source-reported total; null is unknown.
                          type:
                          - number
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        cursor: null
                        dropped: 0
                        has_more: false
                        items:
                        - actor:
                            avatar: https://example.com/example
                            headline: example
                            id: example
                            name: example
                            url: https://example.com/example
                          type: example
                        page: 0
                        post_url: https://example.com/example
                        total: 0
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 8
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/post-reposts:
    get:
      operationId: linkedin_post_reposts
      tags:
      - Linked In
      summary: LinkedIn post reposts
      description: 'Who reposted a post, ten a page with the total: the repost''s own URL and commentary, the reposter''s name and profile. Costs 4 credits per successful live response.'
      parameters:
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/feed/update/urn:li:activity:7496695637644828672
        description: Post URL (or pass reposts_urn from a profile-posts card)
      - name: reposts_urn
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: urns.reposts from a profile-posts card
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: '2'
        description: Page number from the previous page
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/post-reposts.json
                      title: linkedin/post-reposts data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        cursor:
                          description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                          type:
                          - string
                          - 'null'
                        dropped:
                          description: Optional dropped supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              reposter:
                                description: Optional reposter supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  avatar:
                                    description: Optional avatar supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              text:
                                description: Source text when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - reposter
                                properties:
                                  reposter:
                                    description: Optional reposter supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      avatar:
                                        description: Optional avatar supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      id:
                                        description: Source identifier. Preserve the supplied type and exact value.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - text
                                properties:
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    minLength: 1
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        post_url:
                          description: Optional post url supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        total:
                          description: Source-reported total; null is unknown.
                          type:
                          - number
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        cursor: null
                        dropped: 0
                        has_more: false
                        items:
                        - reposter:
                            avatar: https://example.com/example
                            id: example
                            name: example
                            url: https://example.com/example
                          text: example
                          url: https://example.com/example
                        page: 0
                        post_url: https://example.com/example
                        total: 0
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 4
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/post-transcript:
    get:
      operationId: linkedin_post_transcript
      tags:
      - Linked In
      summary: Video transcript
      description: The spoken words of a video in a LinkedIn post as text. transcript is null when the video has no speech or captions — that is the honest answer, not an error. Costs 5 credits per successful live response.
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        example: https://www.linkedin.com/feed/update/urn:li:activity:7500971887234097153
        description: LinkedIn post URL containing a video under ~2 minutes.
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/post-transcript.json
                      title: linkedin/post-transcript data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        has_transcript:
                          description: Optional has transcript supplied by this operation. Null means unknown.
                          type:
                          - boolean
                          - 'null'
                        platform:
                          description: Optional platform supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        transcript:
                          description: Optional transcript supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        url:
                          description: Original source URL when supplied.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - has_transcript
                          properties:
                            has_transcript:
                              description: Optional has transcript supplied by this operation. Null means unknown.
                              type:
                              - boolean
                        - required:
                          - transcript
                          properties:
                            transcript:
                              description: Optional transcript supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - url
                          properties:
                            url:
                              description: Original source URL when supplied.
                              type:
                              - string
                              minLength: 1
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - has_transcript: false
                        platform: example
                        transcript: example
                        url: https://example.com/example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 5
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile:
    get:
      operationId: linkedin_profile
      tags:
      - Linked In
      summary: Person profile
      description: 'A person''s public LinkedIn profile: headline, member id, about, location, followers and connections, experience, education, skills, languages and certifications. Recent posts are listed by linkedin/profile-posts. Costs 5 credits per successful live response.'
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: LinkedIn profile URL.
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile.json
                      title: linkedin/profile data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        _warnings:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        about:
                          description: Optional about supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        articles:
                          description: Optional articles supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - object
                            - 'null'
                            properties:
                              author:
                                description: Public author information supplied with this record.
                                type:
                                - string
                                - 'null'
                              date_published:
                                description: Optional date published supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              headline:
                                description: Optional headline supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              image_url:
                                description: Optional image url supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              text:
                                description: Source text when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                        avatar_url:
                          description: Optional avatar url supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        background_image:
                          description: Optional background image supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        certifications:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        education:
                          description: Optional education supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - object
                            - 'null'
                            properties:
                              end:
                                description: Optional end supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              institution:
                                description: Optional institution supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              start:
                                description: Optional start supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                        experience:
                          description: Optional experience supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - object
                            - 'null'
                            properties:
                              company:
                                description: Optional company supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              company_handle:
                                description: Optional company handle supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              company_url:
                                description: Optional company url supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              is_current:
                                description: Optional is current supplied by this operation. Null means unknown.
                                type:
                                - boolean
                                - 'null'
                              org:
                                description: Optional org supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              start:
                                description: Optional start supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              title:
                                description: Source title when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                        first_name:
                          description: Optional first name supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        followers:
                          description: Optional followers supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        handle:
                          description: Optional handle supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        headline:
                          description: Optional headline supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        id:
                          description: Source identifier. Preserve the supplied type and exact value.
                          type:
                          - string
                          - 'null'
                        id_kind:
                          description: Optional id kind supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        languages:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        last_name:
                          description: Optional last name supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        location:
                          description: Optional location supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        member_urn:
                          description: Optional member urn supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        name:
                          description: Optional name supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        platform:
                          description: Optional platform supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        position_info:
                          description: Optional position info supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            current_employment_verified:
                              description: Optional current employment verified supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            ordering:
                              description: Optional ordering supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            positions_returned:
                              description: Optional positions returned supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                            positions_with_skills:
                              description: Optional positions with skills supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                            skills_scope:
                              description: Optional skills scope supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                        projects:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        publications:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        recent_posts:
                          description: Optional recent posts supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - object
                            - 'null'
                            properties:
                              date:
                                description: Optional date supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              title:
                                description: Source title when supplied.
                                type:
                                - string
                                - 'null'
                              type:
                                description: Optional type supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                        recommendations:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        skills:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        top_position:
                          description: Optional top position supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            company:
                              description: Optional company supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            company_handle:
                              description: Optional company handle supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            company_url:
                              description: Optional company url supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            is_current:
                              description: Optional is current supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            org:
                              description: Optional org supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            start:
                              description: Optional start supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            title:
                              description: Source title when supplied.
                              type:
                              - string
                              - 'null'
                            url:
                              description: Original source URL when supplied.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                        url:
                          description: Original source URL when supplied.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - about
                          properties:
                            about:
                              description: Optional about supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - articles
                          properties:
                            articles:
                              description: Optional articles supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  author:
                                    description: Public author information supplied with this record.
                                    type:
                                    - string
                                    - 'null'
                                  date_published:
                                    description: Optional date published supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  image_url:
                                    description: Optional image url supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                        - required:
                          - avatar_url
                          properties:
                            avatar_url:
                              description: Optional avatar url supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - background_image
                          properties:
                            background_image:
                              description: Optional background image supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - certifications
                          properties:
                            certifications:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - education
                          properties:
                            education:
                              description: Optional education supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  end:
                                    description: Optional end supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  institution:
                                    description: Optional institution supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  start:
                                    description: Optional start supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                        - required:
                          - experience
                          properties:
                            experience:
                              description: Optional experience supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  company:
                                    description: Optional company supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  company_handle:
                                    description: Optional company handle supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  company_url:
                                    description: Optional company url supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  is_current:
                                    description: Optional is current supplied by this operation. Null means unknown.
                                    type:
                                    - boolean
                                    - 'null'
                                  org:
                                    description: Optional org supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  start:
                                    description: Optional start supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  title:
                                    description: Source title when supplied.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                        - required:
                          - first_name
                          properties:
                            first_name:
                              description: Optional first name supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - followers
                          properties:
                            followers:
                              description: Optional followers supplied by this operation. Null means unknown.
                              type:
                              - number
                        - required:
                          - handle
                          properties:
                            handle:
                              description: Optional handle supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - headline
                          properties:
                            headline:
                              description: Optional headline supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - id
                          properties:
                            id:
                              description: Source identifier. Preserve the supplied type and exact value.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - id_kind
                          properties:
                            id_kind:
                              description: Optional id kind supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - languages
                          properties:
                            languages:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - last_name
                          properties:
                            last_name:
                              description: Optional last name supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - location
                          properties:
                            location:
                              description: Optional location supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - member_urn
                          properties:
                            member_urn:
                              description: Optional member urn supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - name
                          properties:
                            name:
                              description: Optional name supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - position_info
                          properties:
                            position_info:
                              description: Optional position info supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                current_employment_verified:
                                  description: Optional current employment verified supplied by this operation. Null means unknown.
                                  type:
                                  - boolean
                                  - 'null'
                                ordering:
                                  description: Optional ordering supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                positions_returned:
                                  description: Optional positions returned supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                positions_with_skills:
                                  description: Optional positions with skills supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                skills_scope:
                                  description: Optional skills scope supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - projects
                          properties:
                            projects:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - publications
                          properties:
                            publications:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - recent_posts
                          properties:
                            recent_posts:
                              description: Optional recent posts supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  date:
                                    description: Optional date supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    - 'null'
                                  title:
                                    description: Source title when supplied.
                                    type:
                                    - string
                                    - 'null'
                                  type:
                                    description: Optional type supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                        - required:
                          - recommendations
                          properties:
                            recommendations:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - skills
                          properties:
                            skills:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - top_position
                          properties:
                            top_position:
                              description: Optional top position supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                company:
                                  description: Optional company supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                company_handle:
                                  description: Optional company handle supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                company_url:
                                  description: Optional company url supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                is_current:
                                  description: Optional is current supplied by this operation. Null means unknown.
                                  type:
                                  - boolean
                                  - 'null'
                                org:
                                  description: Optional org supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                start:
                                  description: Optional start supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                title:
                                  description: Source title when supplied.
                                  type:
                                  - string
                                  - 'null'
                                url:
                                  description: Original source URL when supplied.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - url
                          properties:
                            url:
                              description: Original source URL when supplied.
                              type:
                              - string
                              minLength: 1
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - _warnings: []
                        about: example
                        articles:
                        - author: example
                          date_published: '2026-09-01T12:00:00Z'
                          headline: example
                          image_url: https://example.com/example
                          text: example
                          url: https://example.com/example
                        avatar_url: https://example.com/example
                        background_image: https://example.com/example
                        certifications: []
                        education:
                        - end: example
                          institution: example
                          start: example
                        experience:
                        - company: example
                          company_handle: example
                          company_url: https://example.com/example
                          is_current: false
                          org: example
                          start: example
                          title: example
                          url: https://example.com/example
                        first_name: example
                        followers: 0
                        handle: example
                        headline: example
                        id: example
                        id_kind: example
                        languages: []
                        last_name: example
                        location: example
                        member_urn: example
                        name: example
                        platform: example
                        position_info:
                          current_employment_verified: false
                          ordering: example
                          positions_returned: 0
                          positions_with_skills: 0
                          skills_scope: example
                        projects: []
                        publications: []
                        recent_posts:
                        - date: '2026-09-01T12:00:00Z'
                          id: example
                          title: example
                          type: example
                          url: https://example.com/example
                        recommendations: []
                        skills: []
                        top_position:
                          company: example
                          company_handle: example
                          company_url: https://example.com/example
                          is_current: false
                          org: example
                          start: example
                          title: example
                          url: https://example.com/example
                        url: https://example.com/example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 5
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-certifications:
    get:
      operationId: linkedin_profile_certifications
      tags:
      - Linked In
      summary: LinkedIn member certifications
      description: 'A member''s licences and certifications, one page at a time: title, issuing authority, issue date and credential link. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAAARpiwIBp_SzoeHPlUfOvmtibe08Ea1iCh4
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-certifications.json
                      title: linkedin/profile-certifications data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        _meta:
                          description: Optional  meta supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            billing:
                              description: Optional billing supplied by this operation. Null means unknown.
                              type:
                              - object
                              - 'null'
                              properties:
                                charged:
                                  description: Optional charged supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                list_price:
                                  description: Optional list price supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                reason:
                                  description: Optional reason supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                          additionalProperties: true
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          items: {}
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        total:
                          description: Source-reported total; null is unknown.
                          type:
                          - number
                          - 'null'
                        urn:
                          description: Optional urn supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        urn_lookup:
                          description: Optional urn lookup supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            cached:
                              description: Optional cached supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            method:
                              description: Optional method supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            performed:
                              description: Optional performed supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            username:
                              description: Optional username supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - _meta:
                          billing:
                            charged: 0
                            list_price: 0
                            reason: example
                        count: 0
                        has_more: false
                        items: []
                        page: 0
                        total: 0
                        urn: example
                        urn_lookup:
                          cached: false
                          method: example
                          performed: false
                          username: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-comments:
    get:
      operationId: linkedin_profile_comments
      tags:
      - Linked In
      summary: LinkedIn profile comments
      description: The posts a person recently commented on, twenty a page, each with the person's comment. Costs 4 credits per successful live response.
      parameters:
      - name: handle
        in: query
        required: false
        schema:
          type: string
        example: satyanadella
        description: Public profile handle (the URL slug), or pass url
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella
        description: Full profile URL
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Continue with the complete cursor from the previous response and the original target. Do not edit it. Source coverage varies; a fallback continuation is bound to its source and account and expires after one hour.
      - name: pagination_token
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: pagination_token from the previous page
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-comments.json
                      title: linkedin/profile-comments data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        cursor:
                          description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                          type:
                          - string
                          - 'null'
                        dropped:
                          description: Optional dropped supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              author:
                                description: Public author information supplied with this record.
                                type:
                                - object
                                - 'null'
                                properties:
                                  avatar:
                                    description: Optional avatar supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              comment:
                                description: Optional comment supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  author:
                                    description: Public author information supplied with this record.
                                    type:
                                    - object
                                    - 'null'
                                    properties: {}
                                    additionalProperties: true
                                  created_at:
                                    description: Source creation time, not the API retrieval time.
                                    type:
                                    - string
                                    - 'null'
                                  edited:
                                    description: Optional edited supplied by this operation. Null means unknown.
                                    type:
                                    - boolean
                                    - 'null'
                                  likes:
                                    description: Optional likes supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  reply_count:
                                    description: Optional reply count supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              comments_preview:
                                description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                type:
                                - array
                                - 'null'
                                items: {}
                              created_at:
                                description: Source creation time, not the API retrieval time.
                                type:
                                - string
                                - 'null'
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              image:
                                description: Optional image supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              images:
                                description: Optional images supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              links:
                                description: Optional links supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              platform:
                                description: Optional platform supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              posted_ago:
                                description: Optional posted ago supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              stats:
                                description: Optional stats supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  comments:
                                    description: Optional comments supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  likes:
                                    description: Optional likes supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  reactions:
                                    description: Optional reactions supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    - 'null'
                                    properties: {}
                                    additionalProperties: true
                                  shares:
                                    description: Optional shares supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                additionalProperties: true
                              text:
                                description: Source text when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                              urns:
                                description: Optional urns supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  comments:
                                    description: Optional comments supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  reactions:
                                    description: Optional reactions supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  reposts:
                                    description: Optional reposts supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              video_thumbnail:
                                description: Optional video thumbnail supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - author
                                properties:
                                  author:
                                    description: Public author information supplied with this record.
                                    type:
                                    - object
                                    properties:
                                      avatar:
                                        description: Optional avatar supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      headline:
                                        description: Optional headline supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - comment
                                properties:
                                  comment:
                                    description: Optional comment supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      author:
                                        description: Public author information supplied with this record.
                                        type:
                                        - object
                                        - 'null'
                                        properties: {}
                                        additionalProperties: true
                                      created_at:
                                        description: Source creation time, not the API retrieval time.
                                        type:
                                        - string
                                        - 'null'
                                      edited:
                                        description: Optional edited supplied by this operation. Null means unknown.
                                        type:
                                        - boolean
                                        - 'null'
                                      likes:
                                        description: Optional likes supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      reply_count:
                                        description: Optional reply count supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      text:
                                        description: Source text when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - comments_preview
                                properties:
                                  comments_preview:
                                    description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                    type:
                                    - array
                                    items: {}
                              - required:
                                - created_at
                                properties:
                                  created_at:
                                    description: Source creation time, not the API retrieval time.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - image
                                properties:
                                  image:
                                    description: Optional image supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - images
                                properties:
                                  images:
                                    description: Optional images supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                              - required:
                                - links
                                properties:
                                  links:
                                    description: Optional links supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                              - required:
                                - posted_ago
                                properties:
                                  posted_ago:
                                    description: Optional posted ago supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - stats
                                properties:
                                  stats:
                                    description: Optional stats supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      comments:
                                        description: Optional comments supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      likes:
                                        description: Optional likes supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      reactions:
                                        description: Optional reactions supplied by this operation. Null means unknown.
                                        type:
                                        - object
                                        - 'null'
                                        properties: {}
                                        additionalProperties: true
                                      shares:
                                        description: Optional shares supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - text
                                properties:
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - urns
                                properties:
                                  urns:
                                    description: Optional urns supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      comments:
                                        description: Optional comments supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      reactions:
                                        description: Optional reactions supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      reposts:
                                        description: Optional reposts supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - video_thumbnail
                                properties:
                                  video_thumbnail:
                                    description: Optional video thumbnail supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        pagination_token:
                          description: Optional pagination token supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        cursor: null
                        dropped: 0
                        has_more: false
                        items:
                        - author:
                            avatar: https://example.com/example
                            headline: example
                            name: example
                            url: https://example.com/example
                          comment:
                            author: {}
                            created_at: '2026-09-01T12:00:00Z'
                            edited: false
                            likes: 0
                            reply_count: 0
                            text: example
                          comments_preview: []
                          created_at: '2026-09-01T12:00:00Z'
                          id: example
                          image: https://example.com/example
                          images:
                          - example
                          links:
                          - example
                          platform: example
                          posted_ago: example
                          stats:
                            comments: 0
                            likes: 0
                            reactions: {}
                            shares: 0
                          text: example
                          url: https://example.com/example
                          urns:
                            comments: example
                            reactions: example
                            reposts: example
                          video_thumbnail: example
                        page: 0
                        pagination_token: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 4
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-contact:
    get:
      operationId: linkedin_profile_contact
      tags:
      - Linked In
      summary: LinkedIn public contact details
      description: 'A member''s public contact card: websites and social handles. E-mail addresses, phone numbers and postal addresses are personal data and are withheld; the answer lists what was withheld. Costs 3 credits per successful live response.'
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-contact.json
                      title: linkedin/profile-contact data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        handle:
                          description: Optional handle supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        name:
                          description: Optional name supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        platform:
                          description: Optional platform supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        twitter:
                          description: Source array was empty in the reviewed captures; item fields remain unspecified.
                          type:
                          - array
                          - 'null'
                          items: {}
                        urn:
                          description: Optional urn supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        websites:
                          description: Optional websites supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - object
                            - 'null'
                            properties:
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                        withheld:
                          description: Optional withheld supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - string
                            - 'null'
                        withheld_note:
                          description: Optional withheld note supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - handle
                          properties:
                            handle:
                              description: Optional handle supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - name
                          properties:
                            name:
                              description: Optional name supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - twitter
                          properties:
                            twitter:
                              description: Source array was empty in the reviewed captures; item fields remain unspecified.
                              type:
                              - array
                              items: {}
                        - required:
                          - urn
                          properties:
                            urn:
                              description: Optional urn supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - websites
                          properties:
                            websites:
                              description: Optional websites supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                        - required:
                          - withheld
                          properties:
                            withheld:
                              description: Optional withheld supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                        - required:
                          - withheld_note
                          properties:
                            withheld_note:
                              description: Optional withheld note supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - handle: example
                        name: example
                        platform: example
                        twitter: []
                        urn: example
                        websites:
                        - url: https://example.com/example
                        withheld:
                        - example
                        withheld_note: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 3
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-educations:
    get:
      operationId: linkedin_profile_educations
      tags:
      - Linked In
      summary: LinkedIn member education
      description: 'A member''s education history, one page at a time: school, degree and dates. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAAARpiwIBp_SzoeHPlUfOvmtibe08Ea1iCh4
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-educations.json
                      title: linkedin/profile-educations data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              degree:
                                description: Optional degree supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              end_date:
                                description: Optional end date supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              school:
                                description: Optional school supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              start_date:
                                description: Optional start date supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - degree
                                properties:
                                  degree:
                                    description: Optional degree supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - end_date
                                properties:
                                  end_date:
                                    description: Optional end date supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - school
                                properties:
                                  school:
                                    description: Optional school supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - start_date
                                properties:
                                  start_date:
                                    description: Optional start date supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        total:
                          description: Source-reported total; null is unknown.
                          type:
                          - number
                          - 'null'
                        urn:
                          description: Optional urn supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        urn_lookup:
                          description: Optional urn lookup supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            cached:
                              description: Optional cached supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            method:
                              description: Optional method supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            performed:
                              description: Optional performed supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            username:
                              description: Optional username supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        has_more: false
                        items:
                        - degree: example
                          end_date: '2026-09-01T12:00:00Z'
                          school: example
                          start_date: '2026-09-01T12:00:00Z'
                        page: 0
                        total: 0
                        urn: example
                        urn_lookup:
                          cached: false
                          method: example
                          performed: false
                          username: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-experiences:
    get:
      operationId: linkedin_profile_experiences
      tags:
      - Linked In
      summary: LinkedIn member experiences
      description: 'A member''s work experiences, one page at a time: title, employment type, location, dates, description, skills and the company (id, name, URL, logo). Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAAAjpjWIBMh1iBR4OgSPK5GXetlQ6dYUT-qo
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-experiences.json
                      title: linkedin/profile-experiences data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              company:
                                description: Optional company supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    - 'null'
                                  logo:
                                    description: Optional logo supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              end_date:
                                description: Optional end date supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              location:
                                description: Optional location supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              skills:
                                description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                type:
                                - array
                                - 'null'
                                items: {}
                              start_date:
                                description: Optional start date supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              title:
                                description: Source title when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - company
                                properties:
                                  company:
                                    description: Optional company supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      id:
                                        description: Source identifier. Preserve the supplied type and exact value.
                                        type:
                                        - string
                                        - 'null'
                                      logo:
                                        description: Optional logo supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - end_date
                                properties:
                                  end_date:
                                    description: Optional end date supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - location
                                properties:
                                  location:
                                    description: Optional location supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - skills
                                properties:
                                  skills:
                                    description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                    type:
                                    - array
                                    items: {}
                              - required:
                                - start_date
                                properties:
                                  start_date:
                                    description: Optional start date supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - title
                                properties:
                                  title:
                                    description: Source title when supplied.
                                    type:
                                    - string
                                    minLength: 1
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        total:
                          description: Source-reported total; null is unknown.
                          type:
                          - number
                          - 'null'
                        urn:
                          description: Optional urn supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        urn_lookup:
                          description: Optional urn lookup supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            cached:
                              description: Optional cached supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            method:
                              description: Optional method supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            performed:
                              description: Optional performed supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            username:
                              description: Optional username supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        has_more: false
                        items:
                        - company:
                            id: example
                            logo: example
                            name: example
                            url: https://example.com/example
                          end_date: '2026-09-01T12:00:00Z'
                          location: example
                          skills: []
                          start_date: '2026-09-01T12:00:00Z'
                          title: example
                        page: 0
                        total: 0
                        urn: example
                        urn_lookup:
                          cached: false
                          method: example
                          performed: false
                          username: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-freshness:
    get:
      operationId: linkedin_profile_freshness
      tags:
      - Linked In
      summary: LinkedIn account freshness
      description: 'The account-freshness panel of a member (not the About text): the month the account joined and how recently the contact details and profile photo changed. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-freshness.json
                      title: linkedin/profile-freshness data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        contact_information_updated:
                          description: Optional contact information updated supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        joined:
                          description: Optional joined supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        platform:
                          description: Optional platform supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        profile_photo_updated:
                          description: Optional profile photo updated supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        urn:
                          description: Optional urn supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        urn_lookup:
                          description: Optional urn lookup supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            cached:
                              description: Optional cached supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            method:
                              description: Optional method supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            performed:
                              description: Optional performed supplied by this operation. Null means unknown.
                              type:
                              - boolean
                              - 'null'
                            username:
                              description: Optional username supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - contact_information_updated
                          properties:
                            contact_information_updated:
                              description: Optional contact information updated supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - joined
                          properties:
                            joined:
                              description: Optional joined supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - profile_photo_updated
                          properties:
                            profile_photo_updated:
                              description: Optional profile photo updated supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - urn
                          properties:
                            urn:
                              description: Optional urn supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - urn_lookup
                          properties:
                            urn_lookup:
                              description: Optional urn lookup supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                cached:
                                  description: Optional cached supplied by this operation. Null means unknown.
                                  type:
                                  - boolean
                                  - 'null'
                                method:
                                  description: Optional method supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                performed:
                                  description: Optional performed supplied by this operation. Null means unknown.
                                  type:
                                  - boolean
                                  - 'null'
                                username:
                                  description: Optional username supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - contact_information_updated: '2026-09-01T12:00:00Z'
                        joined: example
                        platform: example
                        profile_photo_updated: '2026-09-01T12:00:00Z'
                        urn: example
                        urn_lookup:
                          cached: false
                          method: example
                          performed: false
                          username: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-honors:
    get:
      operationId: linkedin_profile_honors
      tags:
      - Linked In
      summary: LinkedIn member honours
      description: 'A member''s honours and awards, one page at a time: title, issuer, date and the associated organisation. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAAC41xVEBx77koDz3k1eJ5E9t8UZ7g0IVGj4
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-honors.json
                      title: linkedin/profile-honors data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              title:
                                type:
                                - string
                                - 'null'
                                description: title
                              issued_by:
                                type:
                                - string
                                - 'null'
                                description: issued by
                              issued_at:
                                type:
                                - string
                                - 'null'
                                description: issued at
                              associated_with:
                                type:
                                - string
                                - 'null'
                                description: associated with
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - title
                                properties:
                                  title:
                                    type:
                                    - string
                                    description: title
                                    minLength: 1
                              - required:
                                - issued_by
                                properties:
                                  issued_by:
                                    type:
                                    - string
                                    description: issued by
                                    minLength: 1
                              - required:
                                - issued_at
                                properties:
                                  issued_at:
                                    type:
                                    - string
                                    description: issued at
                                    minLength: 1
                              - required:
                                - associated_with
                                properties:
                                  associated_with:
                                    type:
                                    - string
                                    description: associated with
                                    minLength: 1
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        cursor: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-images:
    get:
      operationId: linkedin_profile_images
      tags:
      - Linked In
      summary: LinkedIn member image posts
      description: 'A member''s posts that carry images, twenty per page with a continuation token: post id, URL, the images at every size and the relative posting time. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAABCtiL8B26nfi3Nbpo_AM8ngg4LeClT1Wh8
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: The token from the previous page
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-images.json
                      title: linkedin/profile-images data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type:
                                - string
                                - 'null'
                                description: Exact source identifier; preserve it as a string.
                              url:
                                type:
                                - string
                                - 'null'
                                description: url
                              created_at_text:
                                type:
                                - string
                                - 'null'
                                description: created at text
                              images:
                                type: array
                                items:
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    url:
                                      type:
                                      - string
                                      - 'null'
                                      description: Original source URL when supplied.
                                    width:
                                      type:
                                      - number
                                      - 'null'
                                      description: width; null is unknown.
                                    height:
                                      type:
                                      - number
                                      - 'null'
                                      description: height; null is unknown.
                                  additionalProperties: true
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    type:
                                    - string
                                    description: Exact source identifier; preserve it as a string.
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    type:
                                    - string
                                    description: url
                                    minLength: 1
                              - required:
                                - created_at_text
                                properties:
                                  created_at_text:
                                    type:
                                    - string
                                    description: created at text
                                    minLength: 1
                              - required:
                                - images
                                properties:
                                  images:
                                    type: array
                                    items:
                                      type:
                                      - object
                                      - 'null'
                                      properties:
                                        url:
                                          type:
                                          - string
                                          - 'null'
                                          description: Original source URL when supplied.
                                        width:
                                          type:
                                          - number
                                          - 'null'
                                          description: width; null is unknown.
                                        height:
                                          type:
                                          - number
                                          - 'null'
                                          description: height; null is unknown.
                                      additionalProperties: true
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        cursor: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-interests-companies:
    get:
      operationId: linkedin_profile_interests_companies
      tags:
      - Linked In
      summary: LinkedIn member followed companies
      description: 'The companies a member follows, one page at a time: id, name, URL, follower count and logo. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAAEDH77YBEVIYXAaEwTicp5CcB_hR7DfFL9o
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-interests-companies.json
                      title: linkedin/profile-interests-companies data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type:
                                - string
                                - 'null'
                                description: Exact source identifier; preserve it as a string.
                              name:
                                type:
                                - string
                                - 'null'
                                description: name
                              url:
                                type:
                                - string
                                - 'null'
                                description: url
                              logo:
                                type:
                                - string
                                - 'null'
                                description: logo
                              followers:
                                type:
                                - number
                                - 'null'
                                description: Public followers.
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    type:
                                    - string
                                    description: Exact source identifier; preserve it as a string.
                                    minLength: 1
                              - required:
                                - name
                                properties:
                                  name:
                                    type:
                                    - string
                                    description: name
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    type:
                                    - string
                                    description: url
                                    minLength: 1
                              - required:
                                - logo
                                properties:
                                  logo:
                                    type:
                                    - string
                                    description: logo
                                    minLength: 1
                              - required:
                                - followers
                                properties:
                                  followers:
                                    type:
                                    - number
                                    description: Public followers.
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        cursor: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-interests-groups:
    get:
      operationId: linkedin_profile_interests_groups
      tags:
      - Linked In
      summary: LinkedIn member groups
      description: 'The groups a member belongs to, one page at a time: id, name, URL, member count and logo. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAAAjpjWIBMh1iBR4OgSPK5GXetlQ6dYUT-qo
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-interests-groups.json
                      title: linkedin/profile-interests-groups data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type:
                                - string
                                - 'null'
                                description: Exact source identifier; preserve it as a string.
                              name:
                                type:
                                - string
                                - 'null'
                                description: name
                              url:
                                type:
                                - string
                                - 'null'
                                description: url
                              logo:
                                type:
                                - string
                                - 'null'
                                description: logo
                              members:
                                type:
                                - number
                                - 'null'
                                description: Public member count.
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    type:
                                    - string
                                    description: Exact source identifier; preserve it as a string.
                                    minLength: 1
                              - required:
                                - name
                                properties:
                                  name:
                                    type:
                                    - string
                                    description: name
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    type:
                                    - string
                                    description: url
                                    minLength: 1
                              - required:
                                - logo
                                properties:
                                  logo:
                                    type:
                                    - string
                                    description: logo
                                    minLength: 1
                              - required:
                                - members
                                properties:
                                  members:
                                    type:
                                    - number
                                    description: Public member count.
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        cursor: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-posts:
    get:
      operationId: linkedin_profile_posts
      tags:
      - Linked In
      summary: LinkedIn profile posts
      description: 'A person''s posts, newest first, twenty a page: text, media, links, like/comment/share counts with the reaction breakdown, and the engagement tokens the post-comments, post-reactions and post-reposts routes accept. Costs 4 credits per successful live response.'
      parameters:
      - name: handle
        in: query
        required: false
        schema:
          type: string
        example: satyanadella
        description: Public profile handle (the URL slug), or pass url
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella
        description: Full profile URL
      - name: media
        in: query
        required: false
        schema:
          type: string
          enum:
          - image
          - video
        example: ''
        description: 'image or video: only posts carrying that media Accepted values: image, video. Case, spaces, hyphens and underscores are interchangeable.'
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Continue with the complete cursor from the previous response and the original target. Do not edit it. Source coverage varies; a fallback continuation is bound to its source and account and expires after one hour.
      - name: pagination_token
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: pagination_token from the previous page, passed alongside the cursor
      - name: pages
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Optional bounded collection of 1–3 source pages within the same normal price, total deadline and spending limit. Default 1. Fewer pages may fit; inspect pages_fetched and window_stop_reason. Continue with both returned cursor and pagination_token when present; keep pages and filters unchanged. This is not a complete historical archive or a last-active indicator.
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-posts.json
                      title: linkedin/profile-posts data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        cursor:
                          description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                          type:
                          - string
                          - 'null'
                        dropped:
                          description: Optional dropped supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              author:
                                description: Public author information supplied with this record.
                                type:
                                - object
                                - 'null'
                                properties:
                                  avatar:
                                    description: Optional avatar supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              comments_preview:
                                description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                type:
                                - array
                                - 'null'
                                items: {}
                              created_at:
                                description: Source creation time, not the API retrieval time.
                                type:
                                - string
                                - 'null'
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              image:
                                description: Optional image supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              images:
                                description: Optional images supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              is_repost:
                                description: Optional is repost supplied by this operation. Null means unknown.
                                type:
                                - boolean
                                - 'null'
                              links:
                                description: Optional links supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              platform:
                                description: Optional platform supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              posted_ago:
                                description: Optional posted ago supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              stats:
                                description: Optional stats supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  comments:
                                    description: Optional comments supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  likes:
                                    description: Optional likes supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  reactions:
                                    description: Optional reactions supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    - 'null'
                                    properties: {}
                                    additionalProperties: true
                                  shares:
                                    description: Optional shares supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                additionalProperties: true
                              text:
                                description: Source text when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                              urns:
                                description: Optional urns supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  comments:
                                    description: Optional comments supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  reactions:
                                    description: Optional reactions supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  reposts:
                                    description: Optional reposts supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              video_thumbnail:
                                description: Optional video thumbnail supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - author
                                properties:
                                  author:
                                    description: Public author information supplied with this record.
                                    type:
                                    - object
                                    properties:
                                      avatar:
                                        description: Optional avatar supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      headline:
                                        description: Optional headline supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - comments_preview
                                properties:
                                  comments_preview:
                                    description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                    type:
                                    - array
                                    items: {}
                              - required:
                                - created_at
                                properties:
                                  created_at:
                                    description: Source creation time, not the API retrieval time.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - image
                                properties:
                                  image:
                                    description: Optional image supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - images
                                properties:
                                  images:
                                    description: Optional images supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                              - required:
                                - is_repost
                                properties:
                                  is_repost:
                                    description: Optional is repost supplied by this operation. Null means unknown.
                                    type:
                                    - boolean
                              - required:
                                - links
                                properties:
                                  links:
                                    description: Optional links supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                              - required:
                                - posted_ago
                                properties:
                                  posted_ago:
                                    description: Optional posted ago supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - stats
                                properties:
                                  stats:
                                    description: Optional stats supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      comments:
                                        description: Optional comments supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      likes:
                                        description: Optional likes supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      reactions:
                                        description: Optional reactions supplied by this operation. Null means unknown.
                                        type:
                                        - object
                                        - 'null'
                                        properties: {}
                                        additionalProperties: true
                                      shares:
                                        description: Optional shares supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - text
                                properties:
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - urns
                                properties:
                                  urns:
                                    description: Optional urns supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      comments:
                                        description: Optional comments supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      reactions:
                                        description: Optional reactions supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      reposts:
                                        description: Optional reposts supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - video_thumbnail
                                properties:
                                  video_thumbnail:
                                    description: Optional video thumbnail supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        pagination_token:
                          description: Optional pagination token supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        cursor: null
                        dropped: 0
                        has_more: false
                        items:
                        - author:
                            avatar: https://example.com/example
                            headline: example
                            name: example
                            url: https://example.com/example
                          comments_preview: []
                          created_at: '2026-09-01T12:00:00Z'
                          id: example
                          image: https://example.com/example
                          images:
                          - example
                          is_repost: false
                          links:
                          - example
                          platform: example
                          posted_ago: example
                          stats:
                            comments: 0
                            likes: 0
                            reactions: {}
                            shares: 0
                          text: example
                          url: https://example.com/example
                          urns:
                            comments: example
                            reactions: example
                            reposts: example
                          video_thumbnail: example
                        page: 0
                        pagination_token: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 4
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-publications:
    get:
      operationId: linkedin_profile_publications
      tags:
      - Linked In
      summary: LinkedIn member publications
      description: 'A member''s publications, one page at a time: title, publisher, description, date and link. Source expansion is not available for every profile. A refused section returns an uncharged error; an empty section with a positive source total is explicitly partial. A profile URL may require a separate identity lookup within the quoted request. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAAB8rG_UB7cstjC__gk5318uYsZOIVkyysi4
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-publications.json
                      title: linkedin/profile-publications data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              title:
                                type:
                                - string
                                - 'null'
                                description: title
                              publisher:
                                type:
                                - string
                                - 'null'
                                description: publisher
                              description:
                                type:
                                - string
                                - 'null'
                                description: description
                              date:
                                type:
                                - string
                                - 'null'
                                description: date
                              url:
                                type:
                                - string
                                - 'null'
                                description: url
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - title
                                properties:
                                  title:
                                    type:
                                    - string
                                    description: title
                                    minLength: 1
                              - required:
                                - publisher
                                properties:
                                  publisher:
                                    type:
                                    - string
                                    description: publisher
                                    minLength: 1
                              - required:
                                - description
                                properties:
                                  description:
                                    type:
                                    - string
                                    description: description
                                    minLength: 1
                              - required:
                                - date
                                properties:
                                  date:
                                    type:
                                    - string
                                    description: date
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    type:
                                    - string
                                    description: url
                                    minLength: 1
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        cursor: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-reactions:
    get:
      operationId: linkedin_profile_reactions
      tags:
      - Linked In
      summary: LinkedIn profile reactions
      description: The posts a person recently reacted to, twenty a page, in the profile-posts shape. Costs 4 credits per successful live response.
      parameters:
      - name: handle
        in: query
        required: false
        schema:
          type: string
        example: satyanadella
        description: Public profile handle (the URL slug), or pass url
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella
        description: Full profile URL
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Continue with the complete cursor from the previous response and the original target. Do not edit it. Source coverage varies; a fallback continuation is bound to its source and account and expires after one hour.
      - name: pagination_token
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: pagination_token from the previous page
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-reactions.json
                      title: linkedin/profile-reactions data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        cursor:
                          description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                          type:
                          - string
                          - 'null'
                        dropped:
                          description: Optional dropped supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              author:
                                description: Public author information supplied with this record.
                                type:
                                - object
                                - 'null'
                                properties:
                                  avatar:
                                    description: Optional avatar supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              comments_preview:
                                description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                type:
                                - array
                                - 'null'
                                items: {}
                              created_at:
                                description: Source creation time, not the API retrieval time.
                                type:
                                - string
                                - 'null'
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              image:
                                description: Optional image supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              images:
                                description: Optional images supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              links:
                                description: Optional links supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              platform:
                                description: Optional platform supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              posted_ago:
                                description: Optional posted ago supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              stats:
                                description: Optional stats supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  comments:
                                    description: Optional comments supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  likes:
                                    description: Optional likes supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  reactions:
                                    description: Optional reactions supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    - 'null'
                                    properties: {}
                                    additionalProperties: true
                                  shares:
                                    description: Optional shares supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                additionalProperties: true
                              text:
                                description: Source text when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                              urns:
                                description: Optional urns supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  comments:
                                    description: Optional comments supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  reactions:
                                    description: Optional reactions supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  reposts:
                                    description: Optional reposts supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              video_thumbnail:
                                description: Optional video thumbnail supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - author
                                properties:
                                  author:
                                    description: Public author information supplied with this record.
                                    type:
                                    - object
                                    properties:
                                      avatar:
                                        description: Optional avatar supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      headline:
                                        description: Optional headline supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - comments_preview
                                properties:
                                  comments_preview:
                                    description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                    type:
                                    - array
                                    items: {}
                              - required:
                                - created_at
                                properties:
                                  created_at:
                                    description: Source creation time, not the API retrieval time.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - image
                                properties:
                                  image:
                                    description: Optional image supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - images
                                properties:
                                  images:
                                    description: Optional images supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                              - required:
                                - links
                                properties:
                                  links:
                                    description: Optional links supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                              - required:
                                - posted_ago
                                properties:
                                  posted_ago:
                                    description: Optional posted ago supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - stats
                                properties:
                                  stats:
                                    description: Optional stats supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      comments:
                                        description: Optional comments supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      likes:
                                        description: Optional likes supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      reactions:
                                        description: Optional reactions supplied by this operation. Null means unknown.
                                        type:
                                        - object
                                        - 'null'
                                        properties: {}
                                        additionalProperties: true
                                      shares:
                                        description: Optional shares supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - text
                                properties:
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - urns
                                properties:
                                  urns:
                                    description: Optional urns supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      comments:
                                        description: Optional comments supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      reactions:
                                        description: Optional reactions supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      reposts:
                                        description: Optional reposts supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - video_thumbnail
                                properties:
                                  video_thumbnail:
                                    description: Optional video thumbnail supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                        page:
                          description: Optional page supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        pagination_token:
                          description: Optional pagination token supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        cursor: null
                        dropped: 0
                        has_more: false
                        items:
                        - author:
                            avatar: https://example.com/example
                            headline: example
                            name: example
                            url: https://example.com/example
                          comments_preview: []
                          created_at: '2026-09-01T12:00:00Z'
                          id: example
                          image: https://example.com/example
                          images:
                          - example
                          links:
                          - example
                          platform: example
                          posted_ago: example
                          stats:
                            comments: 0
                            likes: 0
                            reactions: {}
                            shares: 0
                          text: example
                          url: https://example.com/example
                          urns:
                            comments: example
                            reactions: example
                            reposts: example
                          video_thumbnail: example
                        page: 0
                        pagination_token: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 4
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-recommendations:
    get:
      operationId: linkedin_profile_recommendations
      tags:
      - Linked In
      summary: LinkedIn member recommendations
      description: 'The recommendations a member received or gave, one page at a time: text, date, relationship and the recommender. Source expansion is not available for every profile. A refused section returns an uncharged error; an empty section with a positive source total is explicitly partial. A profile URL may require a separate identity lookup within the quoted request. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAAC3iNKcB3qbWJrP7K5Z3i89AF5c1snr8bhc
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: type
        in: query
        required: false
        schema:
          type: string
          enum:
          - received
          - given
        example: received
        description: 'received (default) or given Accepted values: received, given. Case, spaces, hyphens and underscores are interchangeable.'
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: pagination_token
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: The supplier's pagination token, forwarded as given
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-recommendations.json
                      title: linkedin/profile-recommendations data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              text:
                                type:
                                - string
                                - 'null'
                                description: text
                              date:
                                type:
                                - string
                                - 'null'
                                description: date
                              relationship:
                                type:
                                - string
                                - 'null'
                                description: relationship
                              recommender:
                                type:
                                - object
                                - 'null'
                                properties:
                                  id:
                                    type:
                                    - string
                                    - 'null'
                                    description: Exact source identifier; preserve it as a string.
                                  handle:
                                    type:
                                    - string
                                    - 'null'
                                    description: handle
                                  name:
                                    type:
                                    - string
                                    - 'null'
                                    description: name
                                  url:
                                    type:
                                    - string
                                    - 'null'
                                    description: url
                                  headline:
                                    type:
                                    - string
                                    - 'null'
                                    description: headline
                                  location:
                                    type:
                                    - string
                                    - 'null'
                                    description: location
                                  avatar_url:
                                    type:
                                    - string
                                    - 'null'
                                    description: avatar url
                                  followers:
                                    type:
                                    - number
                                    - 'null'
                                    description: Public follower count.
                                  verified:
                                    type:
                                    - boolean
                                    - 'null'
                                    description: Explicit verification flag when supplied.
                                additionalProperties: true
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - text
                                properties:
                                  text:
                                    type:
                                    - string
                                    description: text
                                    minLength: 1
                              - required:
                                - date
                                properties:
                                  date:
                                    type:
                                    - string
                                    description: date
                                    minLength: 1
                              - required:
                                - relationship
                                properties:
                                  relationship:
                                    type:
                                    - string
                                    description: relationship
                                    minLength: 1
                              - required:
                                - recommender
                                properties:
                                  recommender:
                                    type:
                                    - object
                                    properties:
                                      id:
                                        type:
                                        - string
                                        - 'null'
                                        description: Exact source identifier; preserve it as a string.
                                      handle:
                                        type:
                                        - string
                                        - 'null'
                                        description: handle
                                      name:
                                        type:
                                        - string
                                        - 'null'
                                        description: name
                                      url:
                                        type:
                                        - string
                                        - 'null'
                                        description: url
                                      headline:
                                        type:
                                        - string
                                        - 'null'
                                        description: headline
                                      location:
                                        type:
                                        - string
                                        - 'null'
                                        description: location
                                      avatar_url:
                                        type:
                                        - string
                                        - 'null'
                                        description: avatar url
                                      followers:
                                        type:
                                        - number
                                        - 'null'
                                        description: Public follower count.
                                      verified:
                                        type:
                                        - boolean
                                        - 'null'
                                        description: Explicit verification flag when supplied.
                                    additionalProperties: true
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        cursor: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-skills:
    get:
      operationId: linkedin_profile_skills
      tags:
      - Linked In
      summary: LinkedIn member skills
      description: 'A member''s skills, twenty per page: name, endorsement count and whether the skill assessment was passed. Source expansion is not available for every profile. A refused section returns an uncharged error; an empty section with a positive source total is explicitly partial. A profile URL may require a separate identity lookup within the quoted request. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAACkphDcBDruPBdXiAnqyc834jkTkd_4kRnU
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-skills.json
                      title: linkedin/profile-skills data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type:
                                - string
                                - 'null'
                                description: Skill name.
                              endorsements:
                                type:
                                - number
                                - 'null'
                                description: Source endorsements.
                              passed_assessment:
                                type:
                                - boolean
                                - 'null'
                                description: Source skill-assessment flag.
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - name
                                properties:
                                  name:
                                    type:
                                    - string
                                    description: Skill name.
                                    minLength: 1
                              - required:
                                - endorsements
                                properties:
                                  endorsements:
                                    type:
                                    - number
                                    description: Source endorsements.
                              - required:
                                - passed_assessment
                                properties:
                                  passed_assessment:
                                    type:
                                    - boolean
                                    description: Source skill-assessment flag.
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        cursor: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-stats:
    get:
      operationId: linkedin_profile_stats
      tags:
      - Linked In
      summary: LinkedIn follower and connection counts
      description: A member's follower and connection counts. Costs 3 credits per successful live response.
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-stats.json
                      title: linkedin/profile-stats data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        handle:
                          type:
                          - string
                          - 'null'
                          description: Requested handle.
                        followers:
                          type:
                          - number
                          - 'null'
                          description: followers; null is unknown.
                        connections:
                          type:
                          - number
                          - 'null'
                          description: connections; null is unknown.
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - handle
                          properties:
                            handle:
                              type:
                              - string
                              description: Requested handle.
                              minLength: 1
                        - required:
                          - followers
                          properties:
                            followers:
                              type:
                              - number
                              description: followers; null is unknown.
                        - required:
                          - connections
                          properties:
                            connections:
                              type:
                              - number
                              description: connections; null is unknown.
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - handle: example
                        followers: null
                        connections: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 3
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-videos:
    get:
      operationId: linkedin_profile_videos
      tags:
      - Linked In
      summary: LinkedIn member video posts
      description: 'A member''s video posts, paged with a continuation token: post id, URL, duration, thumbnail, like and comment counts and the reaction breakdown. Source expansion is not available for every profile. A refused section returns an uncharged error; an empty section with a positive source total is explicitly partial. A profile URL may require a separate identity lookup within the quoted request. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAABCtiL8B26nfi3Nbpo_AM8ngg4LeClT1Wh8
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: The token from the previous page
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-videos.json
                      title: linkedin/profile-videos data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type:
                                - string
                                - 'null'
                                description: Exact source identifier; preserve it as a string.
                              url:
                                type:
                                - string
                                - 'null'
                                description: url
                              created_at_text:
                                type:
                                - string
                                - 'null'
                                description: created at text
                              duration:
                                type:
                                - string
                                - 'null'
                                description: duration
                              thumbnail:
                                type:
                                - string
                                - 'null'
                                description: thumbnail
                              stats:
                                type:
                                - object
                                - 'null'
                                properties:
                                  likes:
                                    type:
                                    - number
                                    - 'null'
                                    description: likes; null is unknown.
                                  comments:
                                    type:
                                    - number
                                    - 'null'
                                    description: comments; null is unknown.
                                additionalProperties: true
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    type:
                                    - string
                                    description: Exact source identifier; preserve it as a string.
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    type:
                                    - string
                                    description: url
                                    minLength: 1
                              - required:
                                - created_at_text
                                properties:
                                  created_at_text:
                                    type:
                                    - string
                                    description: created at text
                                    minLength: 1
                              - required:
                                - duration
                                properties:
                                  duration:
                                    type:
                                    - string
                                    description: duration
                                    minLength: 1
                              - required:
                                - thumbnail
                                properties:
                                  thumbnail:
                                    type:
                                    - string
                                    description: thumbnail
                                    minLength: 1
                              - required:
                                - stats
                                properties:
                                  stats:
                                    type:
                                    - object
                                    properties:
                                      likes:
                                        type:
                                        - number
                                        - 'null'
                                        description: likes; null is unknown.
                                      comments:
                                        type:
                                        - number
                                        - 'null'
                                        description: comments; null is unknown.
                                    additionalProperties: true
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        cursor: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile-volunteers:
    get:
      operationId: linkedin_profile_volunteers
      tags:
      - Linked In
      summary: LinkedIn member volunteering
      description: 'A member''s volunteer experiences, one page at a time: organisation, role, cause, duration, description and dates. Source expansion is not available for every profile. A refused section returns an uncharged error; an empty section with a positive source total is explicitly partial. A profile URL may require a separate identity lookup within the quoted request. Costs 16 credits per successful live response.'
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        example: ACoAAAWowRcBd8L3PJrg7-jrzLZGZeGBLz9kmSw
        description: The member URN (ACoAA…). Send this or url.
      - name: url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/in/satyanadella/
        description: Profile URL or handle, resolved to the URN by one extra supplier request (reported as urn_lookup)
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile-volunteers.json
                      title: linkedin/profile-volunteers data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              organization:
                                type:
                                - string
                                - 'null'
                                description: organization
                              title:
                                type:
                                - string
                                - 'null'
                                description: title
                              cause:
                                type:
                                - string
                                - 'null'
                                description: cause
                              duration:
                                type:
                                - string
                                - 'null'
                                description: duration
                              description:
                                type:
                                - string
                                - 'null'
                                description: description
                              start_date:
                                type:
                                - string
                                - 'null'
                                description: start date
                              end_date:
                                type:
                                - string
                                - 'null'
                                description: end date
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - organization
                                properties:
                                  organization:
                                    type:
                                    - string
                                    description: organization
                                    minLength: 1
                              - required:
                                - title
                                properties:
                                  title:
                                    type:
                                    - string
                                    description: title
                                    minLength: 1
                              - required:
                                - cause
                                properties:
                                  cause:
                                    type:
                                    - string
                                    description: cause
                                    minLength: 1
                              - required:
                                - duration
                                properties:
                                  duration:
                                    type:
                                    - string
                                    description: duration
                                    minLength: 1
                              - required:
                                - description
                                properties:
                                  description:
                                    type:
                                    - string
                                    description: description
                                    minLength: 1
                              - required:
                                - start_date
                                properties:
                                  start_date:
                                    type:
                                    - string
                                    description: start date
                                    minLength: 1
                              - required:
                                - end_date
                                properties:
                                  end_date:
                                    type:
                                    - string
                                    description: end date
                                    minLength: 1
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        cursor: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 16
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/profile/full:
    get:
      operationId: linkedin_profile_full
      tags:
      - Linked In
      summary: LinkedIn profile with posts (one page)
      description: 'A real public profile plus one page of posts/videos, preserving original normalized component fields and source order. HTTP 200 may be partial: inspect complete, partial and legs. Failed profile: no posts requested, zero charge. Failed posts: profile retained and only that successful component charged. Cached components use the public cache-hit price. Computed fields summarize the returned page, including available engagement averages and observed posting frequency. Missing metrics remain unknown. Costs 15 credits per successful live response.'
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        example: https://www.linkedin.com/company/microsoft
        description: Public profile identifier. LinkedIn accepts /company/name or /in/name URLs.
      - name: posts
        in: query
        required: false
        schema:
          type: string
        example: '25'
        description: Desired page size, 1-100. Existing components choose their own page size; the entire single source page is preserved, even if longer or shorter, so no records are skipped between cursors. No automatic extra pages.
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Opaque posts_cursor from the previous response; use posts_pagination.next_params to retain all required context. Unsupported component continuation is refused before calls.
      - name: include
        in: query
        required: false
        schema:
          type: string
        example: posts,computed
        description: 'CSV: posts and/or computed (default both), or profile alone. Profile is always returned. Computed is arithmetic over this page only, not an AI summary.'
      - name: pagination_token
        in: query
        required: false
        schema:
          type: string
        description: Pass with the cursor when the personal-profile posts page supplied it. Company continuation is rejected until its registered component supports it.
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/profile/full.json
                      title: linkedin/profile/full data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        _meta:
                          description: Optional  meta supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            billing:
                              description: Optional billing supplied by this operation. Null means unknown.
                              type:
                              - object
                              - 'null'
                              properties:
                                charged:
                                  description: Optional charged supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                components:
                                  description: Optional components supplied by this operation. Null means unknown.
                                  type:
                                  - array
                                  - 'null'
                                  items:
                                    description: Optional record supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    - 'null'
                                    properties: {}
                                    additionalProperties: true
                                formula:
                                  description: Optional formula supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                list_price:
                                  description: Optional list price supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                maximum_component_credits:
                                  description: Optional maximum component credits supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                              additionalProperties: true
                          additionalProperties: true
                        _warnings:
                          description: Optional  warnings supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - string
                            - 'null'
                        complete:
                          description: Optional complete supplied by this operation. Null means unknown.
                          type:
                          - boolean
                          - 'null'
                        computed:
                          description: Optional computed supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            averages:
                              description: Optional averages supplied by this operation. Null means unknown.
                              type:
                              - object
                              - 'null'
                              properties:
                                comments:
                                  description: Optional comments supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                likes:
                                  description: Optional likes supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                shares:
                                  description: Optional shares supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                              additionalProperties: true
                            metric_samples:
                              description: Optional metric samples supplied by this operation. Null means unknown.
                              type:
                              - object
                              - 'null'
                              properties:
                                comments:
                                  description: Optional comments supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                likes:
                                  description: Optional likes supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                shares:
                                  description: Optional shares supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                views:
                                  description: Optional views supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                              additionalProperties: true
                            note:
                              description: Optional note supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            observed_posts_per_day:
                              description: Optional observed posts per day supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                            posting_window:
                              description: Optional posting window supplied by this operation. Null means unknown.
                              type:
                              - object
                              - 'null'
                              properties:
                                days:
                                  description: Optional days supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                end:
                                  description: Optional end supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                posts_with_timestamps:
                                  description: Optional posts with timestamps supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                start:
                                  description: Optional start supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                            sample_size:
                              description: Optional sample size supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                          additionalProperties: true
                        identity_kind:
                          description: Optional identity kind supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        legs:
                          description: Optional legs supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - object
                            - 'null'
                            properties:
                              attempts:
                                description: Optional attempts supplied by this operation. Null means unknown.
                                type:
                                - number
                                - 'null'
                              component:
                                description: Optional component supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              credits:
                                description: Optional credits supplied by this operation. Null means unknown.
                                type:
                                - number
                                - 'null'
                              endpoint:
                                description: Optional endpoint supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              ok:
                                description: Optional ok supplied by this operation. Null means unknown.
                                type:
                                - boolean
                                - 'null'
                              served_by:
                                description: Optional served by supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              status:
                                description: Optional status supplied by this operation. Null means unknown.
                                type:
                                - number
                                - 'null'
                            additionalProperties: true
                        partial:
                          description: Optional partial supplied by this operation. Null means unknown.
                          type:
                          - boolean
                          - 'null'
                        platform:
                          description: Optional platform supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        posts:
                          description: Optional posts supplied by this operation. Null means unknown.
                          type:
                          - array
                          - 'null'
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type:
                            - object
                            - 'null'
                            properties:
                              author:
                                description: Public author information supplied with this record.
                                type:
                                - object
                                - 'null'
                                properties:
                                  avatar:
                                    description: Optional avatar supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  headline:
                                    description: Optional headline supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              comments_preview:
                                description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                type:
                                - array
                                - 'null'
                                items: {}
                              created_at:
                                description: Source creation time, not the API retrieval time.
                                type:
                                - string
                                - 'null'
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              image:
                                description: Optional image supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              images:
                                description: Optional images supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              is_repost:
                                description: Optional is repost supplied by this operation. Null means unknown.
                                type:
                                - boolean
                                - 'null'
                              links:
                                description: Optional links supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              platform:
                                description: Optional platform supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              posted_ago:
                                description: Optional posted ago supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              stats:
                                description: Optional stats supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  comments:
                                    description: Optional comments supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  likes:
                                    description: Optional likes supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  reactions:
                                    description: Optional reactions supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    - 'null'
                                    properties: {}
                                    additionalProperties: true
                                  shares:
                                    description: Optional shares supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                additionalProperties: true
                              text:
                                description: Source text when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                              urns:
                                description: Optional urns supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  comments:
                                    description: Optional comments supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  reactions:
                                    description: Optional reactions supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  reposts:
                                    description: Optional reposts supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                            additionalProperties: true
                        posts_cursor:
                          description: Optional posts cursor supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                        posts_metadata:
                          description: Optional posts metadata supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            count:
                              description: Number of records in this response, not lifetime or total matches.
                              type:
                              - number
                              - 'null'
                            cursor:
                              description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                              type:
                              - string
                              - 'null'
                            has_more:
                              description: Source continuation indicator; null means unknown.
                              type:
                              - boolean
                              - 'null'
                            page:
                              description: Optional page supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                            total:
                              description: Source-reported total; null is unknown.
                              type:
                              - number
                              - 'null'
                          additionalProperties: true
                        posts_pagination:
                          description: Optional posts pagination supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            has_more:
                              description: Source continuation indicator; null means unknown.
                              type:
                              - boolean
                              - 'null'
                            next_params:
                              description: Optional next params supplied by this operation. Null means unknown.
                              type:
                              - object
                              - 'null'
                              properties:
                                cursor:
                                  description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                                  type:
                                  - string
                                  - 'null'
                                url:
                                  description: Original source URL when supplied.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                            page_size_control:
                              description: Optional page size control supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            requested:
                              description: Optional requested supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                            returned:
                              description: Optional returned supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                            total:
                              description: Source-reported total; null is unknown.
                              type:
                              - number
                              - 'null'
                          additionalProperties: true
                        profile:
                          description: Optional profile supplied by this operation. Null means unknown.
                          type:
                          - object
                          - 'null'
                          properties:
                            cover_url:
                              description: Optional cover url supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            description:
                              description: Source description; null or absent means not supplied.
                              type:
                              - string
                              - 'null'
                            employees_count:
                              description: Optional employees count supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                            followers:
                              description: Optional followers supplied by this operation. Null means unknown.
                              type:
                              - number
                              - 'null'
                            funding:
                              description: Optional funding supplied by this operation. Null means unknown.
                              type:
                              - object
                              - 'null'
                              properties:
                                last_round:
                                  description: Optional last round supplied by this operation. Null means unknown.
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    amount:
                                      description: Optional amount supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                                  additionalProperties: true
                              additionalProperties: true
                            handle:
                              description: Optional handle supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            headquarters:
                              description: Optional headquarters supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            id:
                              description: Source identifier. Preserve the supplied type and exact value.
                              type:
                              - string
                              - 'null'
                            industry:
                              description: Optional industry supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            location:
                              description: Optional location supplied by this operation. Null means unknown.
                              type:
                              - object
                              - 'null'
                              properties:
                                city:
                                  description: Optional city supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                country:
                                  description: Optional country supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                state:
                                  description: Optional state supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                            logo_url:
                              description: Optional logo url supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            name:
                              description: Optional name supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            platform:
                              description: Optional platform supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            posts_preview:
                              description: Optional posts preview supplied by this operation. Null means unknown.
                              type:
                              - array
                              - 'null'
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  created_at:
                                    description: Source creation time, not the API retrieval time.
                                    type:
                                    - string
                                    - 'null'
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    - 'null'
                                  platform:
                                    description: Optional platform supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                            posts_preview_info:
                              description: Optional posts preview info supplied by this operation. Null means unknown.
                              type:
                              - object
                              - 'null'
                              properties:
                                pagination_supported:
                                  description: Optional pagination supported supplied by this operation. Null means unknown.
                                  type:
                                  - boolean
                                  - 'null'
                                returned:
                                  description: Optional returned supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                source_pagination_token:
                                  description: Optional source pagination token supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                            similar_pages:
                              description: Optional similar pages supplied by this operation. Null means unknown.
                              type:
                              - array
                              - 'null'
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  logo_url:
                                    description: Optional logo url supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                            size:
                              description: Optional size supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            specialties:
                              description: Optional specialties supplied by this operation. Null means unknown.
                              type:
                              - array
                              - 'null'
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            type:
                              description: Optional type supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                            url:
                              description: Original source URL when supplied.
                              type:
                              - string
                              - 'null'
                            website:
                              description: Optional website supplied by this operation. Null means unknown.
                              type:
                              - string
                              - 'null'
                          additionalProperties: true
                        scope:
                          description: Optional scope supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      allOf:
                      - anyOf:
                        - required:
                          - computed
                          properties:
                            computed:
                              description: Optional computed supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                averages:
                                  description: Optional averages supplied by this operation. Null means unknown.
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    comments:
                                      description: Optional comments supplied by this operation. Null means unknown.
                                      type:
                                      - number
                                      - 'null'
                                    likes:
                                      description: Optional likes supplied by this operation. Null means unknown.
                                      type:
                                      - number
                                      - 'null'
                                    shares:
                                      description: Optional shares supplied by this operation. Null means unknown.
                                      type:
                                      - number
                                      - 'null'
                                  additionalProperties: true
                                metric_samples:
                                  description: Optional metric samples supplied by this operation. Null means unknown.
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    comments:
                                      description: Optional comments supplied by this operation. Null means unknown.
                                      type:
                                      - number
                                      - 'null'
                                    likes:
                                      description: Optional likes supplied by this operation. Null means unknown.
                                      type:
                                      - number
                                      - 'null'
                                    shares:
                                      description: Optional shares supplied by this operation. Null means unknown.
                                      type:
                                      - number
                                      - 'null'
                                    views:
                                      description: Optional views supplied by this operation. Null means unknown.
                                      type:
                                      - number
                                      - 'null'
                                  additionalProperties: true
                                note:
                                  description: Optional note supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                observed_posts_per_day:
                                  description: Optional observed posts per day supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                posting_window:
                                  description: Optional posting window supplied by this operation. Null means unknown.
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    days:
                                      description: Optional days supplied by this operation. Null means unknown.
                                      type:
                                      - number
                                      - 'null'
                                    end:
                                      description: Optional end supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                                    posts_with_timestamps:
                                      description: Optional posts with timestamps supplied by this operation. Null means unknown.
                                      type:
                                      - number
                                      - 'null'
                                    start:
                                      description: Optional start supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                                  additionalProperties: true
                                sample_size:
                                  description: Optional sample size supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - identity_kind
                          properties:
                            identity_kind:
                              description: Optional identity kind supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - legs
                          properties:
                            legs:
                              description: Optional legs supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  attempts:
                                    description: Optional attempts supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  component:
                                    description: Optional component supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  credits:
                                    description: Optional credits supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  endpoint:
                                    description: Optional endpoint supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  ok:
                                    description: Optional ok supplied by this operation. Null means unknown.
                                    type:
                                    - boolean
                                    - 'null'
                                  served_by:
                                    description: Optional served by supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  status:
                                    description: Optional status supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                additionalProperties: true
                        - required:
                          - posts
                          properties:
                            posts:
                              description: Optional posts supplied by this operation. Null means unknown.
                              type:
                              - array
                              items:
                                description: Optional record supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  author:
                                    description: Public author information supplied with this record.
                                    type:
                                    - object
                                    - 'null'
                                    properties:
                                      avatar:
                                        description: Optional avatar supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      headline:
                                        description: Optional headline supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                                  comments_preview:
                                    description: Source array was empty in the reviewed captures; item fields remain unspecified.
                                    type:
                                    - array
                                    - 'null'
                                    items: {}
                                  created_at:
                                    description: Source creation time, not the API retrieval time.
                                    type:
                                    - string
                                    - 'null'
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    - 'null'
                                  image:
                                    description: Optional image supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  images:
                                    description: Optional images supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    - 'null'
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                                  is_repost:
                                    description: Optional is repost supplied by this operation. Null means unknown.
                                    type:
                                    - boolean
                                    - 'null'
                                  links:
                                    description: Optional links supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    - 'null'
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                                  platform:
                                    description: Optional platform supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  posted_ago:
                                    description: Optional posted ago supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  stats:
                                    description: Optional stats supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    - 'null'
                                    properties:
                                      comments:
                                        description: Optional comments supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      likes:
                                        description: Optional likes supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      reactions:
                                        description: Optional reactions supplied by this operation. Null means unknown.
                                        type:
                                        - object
                                        - 'null'
                                        properties: {}
                                        additionalProperties: true
                                      shares:
                                        description: Optional shares supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                    additionalProperties: true
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                  urns:
                                    description: Optional urns supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    - 'null'
                                    properties:
                                      comments:
                                        description: Optional comments supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      reactions:
                                        description: Optional reactions supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      reposts:
                                        description: Optional reposts supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                                additionalProperties: true
                        - required:
                          - posts_cursor
                          properties:
                            posts_cursor:
                              description: Optional posts cursor supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                        - required:
                          - posts_metadata
                          properties:
                            posts_metadata:
                              description: Optional posts metadata supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                count:
                                  description: Number of records in this response, not lifetime or total matches.
                                  type:
                                  - number
                                  - 'null'
                                cursor:
                                  description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                                  type:
                                  - string
                                  - 'null'
                                has_more:
                                  description: Source continuation indicator; null means unknown.
                                  type:
                                  - boolean
                                  - 'null'
                                page:
                                  description: Optional page supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                total:
                                  description: Source-reported total; null is unknown.
                                  type:
                                  - number
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - posts_pagination
                          properties:
                            posts_pagination:
                              description: Optional posts pagination supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                has_more:
                                  description: Source continuation indicator; null means unknown.
                                  type:
                                  - boolean
                                  - 'null'
                                next_params:
                                  description: Optional next params supplied by this operation. Null means unknown.
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    cursor:
                                      description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                                      type:
                                      - string
                                      - 'null'
                                    url:
                                      description: Original source URL when supplied.
                                      type:
                                      - string
                                      - 'null'
                                  additionalProperties: true
                                page_size_control:
                                  description: Optional page size control supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                requested:
                                  description: Optional requested supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                returned:
                                  description: Optional returned supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                total:
                                  description: Source-reported total; null is unknown.
                                  type:
                                  - number
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - profile
                          properties:
                            profile:
                              description: Optional profile supplied by this operation. Null means unknown.
                              type:
                              - object
                              properties:
                                cover_url:
                                  description: Optional cover url supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                description:
                                  description: Source description; null or absent means not supplied.
                                  type:
                                  - string
                                  - 'null'
                                employees_count:
                                  description: Optional employees count supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                followers:
                                  description: Optional followers supplied by this operation. Null means unknown.
                                  type:
                                  - number
                                  - 'null'
                                funding:
                                  description: Optional funding supplied by this operation. Null means unknown.
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    last_round:
                                      description: Optional last round supplied by this operation. Null means unknown.
                                      type:
                                      - object
                                      - 'null'
                                      properties:
                                        amount:
                                          description: Optional amount supplied by this operation. Null means unknown.
                                          type:
                                          - string
                                          - 'null'
                                      additionalProperties: true
                                  additionalProperties: true
                                handle:
                                  description: Optional handle supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                headquarters:
                                  description: Optional headquarters supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                id:
                                  description: Source identifier. Preserve the supplied type and exact value.
                                  type:
                                  - string
                                  - 'null'
                                industry:
                                  description: Optional industry supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                location:
                                  description: Optional location supplied by this operation. Null means unknown.
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    city:
                                      description: Optional city supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                                    country:
                                      description: Optional country supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                                    state:
                                      description: Optional state supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                                  additionalProperties: true
                                logo_url:
                                  description: Optional logo url supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                name:
                                  description: Optional name supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                platform:
                                  description: Optional platform supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                posts_preview:
                                  description: Optional posts preview supplied by this operation. Null means unknown.
                                  type:
                                  - array
                                  - 'null'
                                  items:
                                    description: Optional record supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    - 'null'
                                    properties:
                                      created_at:
                                        description: Source creation time, not the API retrieval time.
                                        type:
                                        - string
                                        - 'null'
                                      id:
                                        description: Source identifier. Preserve the supplied type and exact value.
                                        type:
                                        - string
                                        - 'null'
                                      platform:
                                        description: Optional platform supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      text:
                                        description: Source text when supplied.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                                posts_preview_info:
                                  description: Optional posts preview info supplied by this operation. Null means unknown.
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    pagination_supported:
                                      description: Optional pagination supported supplied by this operation. Null means unknown.
                                      type:
                                      - boolean
                                      - 'null'
                                    returned:
                                      description: Optional returned supplied by this operation. Null means unknown.
                                      type:
                                      - number
                                      - 'null'
                                    source_pagination_token:
                                      description: Optional source pagination token supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                                  additionalProperties: true
                                similar_pages:
                                  description: Optional similar pages supplied by this operation. Null means unknown.
                                  type:
                                  - array
                                  - 'null'
                                  items:
                                    description: Optional record supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    - 'null'
                                    properties:
                                      logo_url:
                                        description: Optional logo url supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                                size:
                                  description: Optional size supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                specialties:
                                  description: Optional specialties supplied by this operation. Null means unknown.
                                  type:
                                  - array
                                  - 'null'
                                  items:
                                    description: Optional record supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                type:
                                  description: Optional type supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                                url:
                                  description: Original source URL when supplied.
                                  type:
                                  - string
                                  - 'null'
                                website:
                                  description: Optional website supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              additionalProperties: true
                        - required:
                          - scope
                          properties:
                            scope:
                              description: Optional scope supplied by this operation. Null means unknown.
                              type:
                              - string
                              minLength: 1
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - _meta:
                          billing:
                            charged: 0
                            components:
                            - {}
                            formula: example
                            list_price: 0
                            maximum_component_credits: 0
                        _warnings:
                        - example
                        complete: false
                        computed:
                          averages:
                            comments: 0
                            likes: 0
                            shares: 0
                          metric_samples:
                            comments: 0
                            likes: 0
                            shares: 0
                            views: 0
                          note: example
                          observed_posts_per_day: 0
                          posting_window:
                            days: 0
                            end: example
                            posts_with_timestamps: 0
                            start: example
                          sample_size: 0
                        identity_kind: example
                        legs:
                        - attempts: 0
                          component: example
                          credits: 0
                          endpoint: example
                          ok: false
                          served_by: example
                          status: 0
                        partial: false
                        platform: example
                        posts:
                        - author:
                            avatar: https://example.com/example
                            headline: example
                            name: example
                            url: https://example.com/example
                          comments_preview: []
                          created_at: '2026-09-01T12:00:00Z'
                          id: example
                          image: https://example.com/example
                          images:
                          - example
                          is_repost: false
                          links:
                          - example
                          platform: example
                          posted_ago: example
                          stats:
                            comments: 0
                            likes: 0
                            reactions: {}
                            shares: 0
                          text: example
                          url: https://example.com/example
                          urns:
                            comments: example
                            reactions: example
                            reposts: example
                        posts_cursor: example
                        posts_metadata:
                          count: 0
                          cursor: null
                          has_more: false
                          page: 0
                          total: 0
                        posts_pagination:
                          has_more: false
                          next_params:
                            cursor: null
                            url: https://example.com/example
                          page_size_control: example
                          requested: 0
                          returned: 0
                          total: 0
                        profile:
                          cover_url: https://example.com/example
                          description: example
                          employees_count: 0
                          followers: 0
                          funding:
                            last_round:
                              amount: example
                          handle: example
                          headquarters: example
                          id: example
                          industry: example
                          location:
                            city: example
                            country: example
                            state: example
                          logo_url: https://example.com/example
                          name: example
                          platform: example
                          posts_preview:
                          - created_at: '2026-09-01T12:00:00Z'
                            id: example
                            platform: example
                            text: example
                            url: https://example.com/example
                          posts_preview_info:
                            pagination_supported: false
                            returned: 0
                            source_pagination_token: example
                          similar_pages:
                          - logo_url: https://example.com/example
                            name: example
                            url: https://example.com/example
                          size: example
                          specialties:
                          - example
                          type: example
                          url: https://example.com/example
                          website: example
                        scope: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 15
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/search-industries:
    get:
      operationId: linkedin_search_industries
      tags:
      - Linked In
      summary: LinkedIn industry lookup
      description: LinkedIn industries matching a typed name, each with the id the people-search industry filter takes. Costs 4 credits per successful live response.
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
        example: Software
        description: The start of an industry name
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/search-industries.json
                      title: linkedin/search-industries data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              kind:
                                description: Optional kind supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              name:
                                description: Optional name supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - name
                                properties:
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                        query:
                          description: Optional query supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        has_more: false
                        items:
                        - id: example
                          kind: example
                          name: example
                        query: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 4
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/search-jobs:
    get:
      operationId: linkedin_search_jobs
      tags:
      - Linked In
      summary: LinkedIn job search
      description: Search job postings by free text, location, country or company, one page at a time, in the same posting shape as a company's jobs. Costs 3 credits per successful live response.
      parameters:
      - name: query
        in: query
        required: false
        schema:
          type: string
        example: data engineer
        description: Required for the first page (title is an accepted alias). A returned cursor can continue the original search without query. Preserve the original filters when continuing.
      - name: location
        in: query
        required: false
        schema:
          type: string
        example: London
        description: Country or city; worldwide when empty
      - name: organization_ids
        in: query
        required: false
        schema:
          type: string
        example: '1441'
        description: Organisation ids from jobs/linkedin/organizations
      - name: date_posted
        in: query
        required: false
        schema:
          type: string
          enum:
          - month
          - week
          - day
        example: week
        description: 'month, week or day Accepted values: month, week, day. Case, spaces, hyphens and underscores are interchangeable.'
      - name: employment_types
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - contractor
            - fulltime
            - parttime
            - intern
            - temporary
        style: form
        explode: false
        example:
        - fulltime
        description: 'contractor, fulltime, parttime, intern or temporary Accepted values (comma-separated): contractor, fulltime, parttime, intern, temporary. Case, spaces, hyphens and underscores are interchangeable.'
      - name: experience_levels
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - intern
            - entry
            - associate
            - midSenior
            - director
        style: form
        explode: false
        example:
        - midSenior
        description: 'intern, entry, associate, midSenior or director Accepted values (comma-separated): intern, entry, associate, midSenior, director. Case, spaces, hyphens and underscores are interchangeable.'
      - name: workplace_types
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - remote
            - hybrid
            - onSite
        style: form
        explode: false
        example:
        - remote
        description: 'remote, hybrid or onSite Accepted values (comma-separated): remote, hybrid, onSite. Case, spaces, hyphens and underscores are interchangeable.'
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Cursor from the previous page
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/search-jobs.json
                      title: linkedin/search-jobs data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type:
                                - string
                                - 'null'
                                description: Exact source identifier; preserve it as a string.
                              title:
                                type:
                                - string
                                - 'null'
                                description: title
                              location:
                                type:
                                - string
                                - 'null'
                                description: location
                              country:
                                type:
                                - string
                                - 'null'
                                description: country
                              country_code:
                                type:
                                - string
                                - 'null'
                                description: country code
                              description:
                                type:
                                - string
                                - 'null'
                                description: description
                              description_html:
                                type:
                                - string
                                - 'null'
                                description: description html
                              date_posted:
                                type:
                                - string
                                - 'null'
                                description: date posted
                              employment_type:
                                type:
                                - string
                                - 'null'
                                description: employment type
                              apply_url:
                                type:
                                - string
                                - 'null'
                                description: apply url
                              url:
                                type:
                                - string
                                - 'null'
                                description: url
                              company:
                                type:
                                - object
                                - 'null'
                                properties:
                                  name:
                                    type:
                                    - string
                                    - 'null'
                                    description: name
                                  image:
                                    type:
                                    - string
                                    - 'null'
                                    description: image
                                additionalProperties: true
                              salary:
                                type:
                                - object
                                - 'null'
                                properties:
                                  min:
                                    type:
                                    - number
                                    - 'null'
                                    description: Lower salary amount.
                                  max:
                                    type:
                                    - number
                                    - 'null'
                                    description: Upper salary amount.
                                  currency:
                                    type:
                                    - string
                                    - 'null'
                                    description: Source currency code.
                                additionalProperties: true
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    type:
                                    - string
                                    description: Exact source identifier; preserve it as a string.
                                    minLength: 1
                              - required:
                                - title
                                properties:
                                  title:
                                    type:
                                    - string
                                    description: title
                                    minLength: 1
                              - required:
                                - location
                                properties:
                                  location:
                                    type:
                                    - string
                                    description: location
                                    minLength: 1
                              - required:
                                - country
                                properties:
                                  country:
                                    type:
                                    - string
                                    description: country
                                    minLength: 1
                              - required:
                                - country_code
                                properties:
                                  country_code:
                                    type:
                                    - string
                                    description: country code
                                    minLength: 1
                              - required:
                                - description
                                properties:
                                  description:
                                    type:
                                    - string
                                    description: description
                                    minLength: 1
                              - required:
                                - description_html
                                properties:
                                  description_html:
                                    type:
                                    - string
                                    description: description html
                                    minLength: 1
                              - required:
                                - date_posted
                                properties:
                                  date_posted:
                                    type:
                                    - string
                                    description: date posted
                                    minLength: 1
                              - required:
                                - employment_type
                                properties:
                                  employment_type:
                                    type:
                                    - string
                                    description: employment type
                                    minLength: 1
                              - required:
                                - apply_url
                                properties:
                                  apply_url:
                                    type:
                                    - string
                                    description: apply url
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    type:
                                    - string
                                    description: url
                                    minLength: 1
                              - required:
                                - company
                                properties:
                                  company:
                                    type:
                                    - object
                                    properties:
                                      name:
                                        type:
                                        - string
                                        - 'null'
                                        description: name
                                      image:
                                        type:
                                        - string
                                        - 'null'
                                        description: image
                                    additionalProperties: true
                              - required:
                                - salary
                                properties:
                                  salary:
                                    type:
                                    - object
                                    properties:
                                      min:
                                        type:
                                        - number
                                        - 'null'
                                        description: Lower salary amount.
                                      max:
                                        type:
                                        - number
                                        - 'null'
                                        description: Upper salary amount.
                                      currency:
                                        type:
                                        - string
                                        - 'null'
                                        description: Source currency code.
                                    additionalProperties: true
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        count: 0
                        cursor: null
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 3
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/search-locations:
    get:
      operationId: linkedin_search_locations
      tags:
      - Linked In
      summary: LinkedIn location lookup
      description: LinkedIn locations matching a typed name, each with the id the people-search location filter takes. Costs 4 credits per successful live response.
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
        example: London
        description: The start of a place name
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/search-locations.json
                      title: linkedin/search-locations data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              kind:
                                description: Optional kind supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              name:
                                description: Optional name supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - name
                                properties:
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                        query:
                          description: Optional query supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        has_more: false
                        items:
                        - id: example
                          kind: example
                          name: example
                        query: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 4
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/search-people:
    get:
      operationId: linkedin_search_people
      tags:
      - Linked In
      summary: LinkedIn people search
      description: 'People matching a name with optional title, location, company, school and industry filters: handle, headline, location, followers and badges. Costs 8 credits per successful live response.'
      parameters:
      - name: query
        in: query
        required: false
        schema:
          type: string
        example: Bill Gates
        description: A person's name
      - name: title
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Job title filter
      - name: location
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: A location id from linkedin/search-locations
      - name: current_company
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Current company filter
      - name: past_company
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Past company filter
      - name: school
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: A school id from linkedin/search-schools
      - name: industry
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: An industry id from linkedin/search-industries
      - name: page
        in: query
        required: false
        schema:
          type: string
        example: '1'
        description: Page number
      - name: search_url
        in: query
        required: false
        schema:
          type: string
        example: https://www.linkedin.com/search/results/people/?keywords=Bill%20Gates
        description: 'Alternative to query: a public LinkedIn people-search URL with keywords. Single selected location, company, school, industry and language filters are supported. Multiple selections, network/Sales Navigator filters and filter-only searches are rejected before source calls. This translates supported filters; it does not use your LinkedIn login.'
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: geocode_location
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Compatibility alias for location. The canonical parameter takes precedence if both are supplied.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/search-people.json
                      title: linkedin/search-people data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type:
                                - string
                                - 'null'
                                description: Exact source identifier; preserve it as a string.
                              handle:
                                type:
                                - string
                                - 'null'
                                description: handle
                              name:
                                type:
                                - string
                                - 'null'
                                description: name
                              url:
                                type:
                                - string
                                - 'null'
                                description: url
                              headline:
                                type:
                                - string
                                - 'null'
                                description: headline
                              location:
                                type:
                                - string
                                - 'null'
                                description: location
                              avatar_url:
                                type:
                                - string
                                - 'null'
                                description: avatar url
                              followers:
                                type:
                                - number
                                - 'null'
                                description: Public follower count.
                              verified:
                                type:
                                - boolean
                                - 'null'
                                description: Explicit verification flag when supplied.
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    type:
                                    - string
                                    description: Exact source identifier; preserve it as a string.
                                    minLength: 1
                              - required:
                                - handle
                                properties:
                                  handle:
                                    type:
                                    - string
                                    description: handle
                                    minLength: 1
                              - required:
                                - name
                                properties:
                                  name:
                                    type:
                                    - string
                                    description: name
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    type:
                                    - string
                                    description: url
                                    minLength: 1
                              - required:
                                - headline
                                properties:
                                  headline:
                                    type:
                                    - string
                                    description: headline
                                    minLength: 1
                              - required:
                                - location
                                properties:
                                  location:
                                    type:
                                    - string
                                    description: location
                                    minLength: 1
                              - required:
                                - avatar_url
                                properties:
                                  avatar_url:
                                    type:
                                    - string
                                    description: avatar url
                                    minLength: 1
                              - required:
                                - followers
                                properties:
                                  followers:
                                    type:
                                    - number
                                    description: Public follower count.
                              - required:
                                - verified
                                properties:
                                  verified:
                                    type:
                                    - boolean
                                    description: Explicit verification flag when supplied.
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        count: 0
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 8
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/search-posts:
    get:
      operationId: linkedin_search_posts
      tags:
      - Linked In
      summary: Indexed post search
      description: Search indexed public LinkedIn posts by keyword or hashtag. Index coverage is incomplete and can lag new posts; this is not an exhaustive live feed. Optional date_posted accepts last-hour, last-day, last-week, last-month or last-year. Continue with the returned cursor and unchanged filters. Costs 4 credits per successful live response.
      parameters:
      - name: query
        in: query
        required: false
        schema:
          type: string
        example: artificial intelligence
        description: Search term.
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Page number cursor from the previous page.
      - name: date_posted
        in: query
        required: false
        schema:
          type: string
          enum:
          - last-hour
          - last-day
          - last-week
          - last-month
          - last-year
        x-value-aliases:
          past-hour: last-hour
          past-day: last-day
          past-week: last-week
          past-month: last-month
          past-year: last-year
        description: 'Limit indexed posts by date. Omit for any date. Accepted values: last-hour, last-day, last-week, last-month, last-year. Case, spaces, hyphens and underscores are interchangeable.'
      - name: hashtag
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: 'Alternative to query: exact hashtag (with or without #). Searches one source page and keeps exact matches in post text. This is a bounded search, not an exhaustive hashtag feed. Preserve hashtag and date_posted with the cursor, including after empty filtered pages.'
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/search-posts.json
                      title: linkedin/search-posts data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        cursor:
                          description: Opaque next-page token; pass it back unchanged. Null does not prove complete history.
                          type:
                          - string
                          - 'null'
                        dropped:
                          description: Optional dropped supplied by this operation. Null means unknown.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              author:
                                description: Public author information supplied with this record.
                                type:
                                - object
                                - 'null'
                                properties:
                                  followers:
                                    description: Optional followers supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    - 'null'
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    - 'null'
                                additionalProperties: true
                              comments_preview:
                                description: Optional comments preview supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - object
                                  - 'null'
                                  properties: {}
                                  additionalProperties: true
                              comments_preview_info:
                                description: Optional comments preview info supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  pagination_supported:
                                    description: Optional pagination supported supplied by this operation. Null means unknown.
                                    type:
                                    - boolean
                                    - 'null'
                                  returned:
                                    description: Optional returned supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  total:
                                    description: Source-reported total; null is unknown.
                                    type:
                                    - number
                                    - 'null'
                                additionalProperties: true
                              created_at:
                                description: Source creation time, not the API retrieval time.
                                type:
                                - string
                                - 'null'
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              image:
                                description: Optional image supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              images:
                                description: Optional images supplied by this operation. Null means unknown.
                                type:
                                - array
                                - 'null'
                                items:
                                  description: Optional record supplied by this operation. Null means unknown.
                                  type:
                                  - string
                                  - 'null'
                              platform:
                                description: Optional platform supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              stats:
                                description: Optional stats supplied by this operation. Null means unknown.
                                type:
                                - object
                                - 'null'
                                properties:
                                  comments:
                                    description: Optional comments supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                  likes:
                                    description: Optional likes supplied by this operation. Null means unknown.
                                    type:
                                    - number
                                    - 'null'
                                additionalProperties: true
                              summary:
                                description: Optional summary supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              text:
                                description: Source text when supplied.
                                type:
                                - string
                                - 'null'
                              url:
                                description: Original source URL when supplied.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - author
                                properties:
                                  author:
                                    description: Public author information supplied with this record.
                                    type:
                                    - object
                                    properties:
                                      followers:
                                        description: Optional followers supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      name:
                                        description: Optional name supplied by this operation. Null means unknown.
                                        type:
                                        - string
                                        - 'null'
                                      url:
                                        description: Original source URL when supplied.
                                        type:
                                        - string
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - comments_preview
                                properties:
                                  comments_preview:
                                    description: Optional comments preview supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - object
                                      - 'null'
                                      properties: {}
                                      additionalProperties: true
                              - required:
                                - comments_preview_info
                                properties:
                                  comments_preview_info:
                                    description: Optional comments preview info supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      pagination_supported:
                                        description: Optional pagination supported supplied by this operation. Null means unknown.
                                        type:
                                        - boolean
                                        - 'null'
                                      returned:
                                        description: Optional returned supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      total:
                                        description: Source-reported total; null is unknown.
                                        type:
                                        - number
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - created_at
                                properties:
                                  created_at:
                                    description: Source creation time, not the API retrieval time.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - image
                                properties:
                                  image:
                                    description: Optional image supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - images
                                properties:
                                  images:
                                    description: Optional images supplied by this operation. Null means unknown.
                                    type:
                                    - array
                                    items:
                                      description: Optional record supplied by this operation. Null means unknown.
                                      type:
                                      - string
                                      - 'null'
                              - required:
                                - stats
                                properties:
                                  stats:
                                    description: Optional stats supplied by this operation. Null means unknown.
                                    type:
                                    - object
                                    properties:
                                      comments:
                                        description: Optional comments supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                      likes:
                                        description: Optional likes supplied by this operation. Null means unknown.
                                        type:
                                        - number
                                        - 'null'
                                    additionalProperties: true
                              - required:
                                - summary
                                properties:
                                  summary:
                                    description: Optional summary supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - text
                                properties:
                                  text:
                                    description: Source text when supplied.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    description: Original source URL when supplied.
                                    type:
                                    - string
                                    minLength: 1
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - cursor: null
                        dropped: 0
                        has_more: false
                        items:
                        - author:
                            followers: 0
                            name: example
                            url: https://example.com/example
                          comments_preview:
                          - {}
                          comments_preview_info:
                            pagination_supported: false
                            returned: 0
                            total: 0
                          created_at: '2026-09-01T12:00:00Z'
                          id: example
                          image: https://example.com/example
                          images:
                          - example
                          platform: example
                          stats:
                            comments: 0
                            likes: 0
                          summary: example
                          text: example
                          url: https://example.com/example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 4
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/search-posts-native:
    get:
      operationId: linkedin_search_posts_native
      tags:
      - Linked In
      summary: Post search
      description: Search public LinkedIn posts beyond the external search index, with post links, text, dates, author and available engagement. Ordinary posts have no title; article.title is the attached article title. Author websites are included when supplied. Coverage is incomplete, source totals may change, and there is no exhaustive or real-time guarantee. Relevance order; dates filter the acquired page. For bounded author-location and public-contact enrichment, use /examples/linkedin-post-search.mjs with separately priced profile lookups and an explicit credit cap. Author location is not post origin. Existing indexed search remains four credits. Costs 5 credits per successful live response.
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
        example: OpenAI
        description: Keywords, 1–200 characters. Results use relevance order. Coverage is incomplete and freshness is not guaranteed.
      - name: date_posted
        in: query
        required: false
        schema:
          type: string
        example: last-month
        description: 'Source window: last-day, last-week or last-month (default). Keep unchanged with the cursor. Local timestamp filtering also excludes unknown dates and records outside the requested window.'
      - name: date_from
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Optional inclusive UTC date YYYY-MM-DD, applied only to the acquired page within date_posted. It does not expand historical coverage. Unknown dates are excluded and counted.
      - name: date_to
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Optional inclusive UTC date YYYY-MM-DD. Same bounded-page scope as date_from. Empty filtered pages can still have continuation.
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        example: ''
        description: Complete opaque continuation from this endpoint, same account, query and filters. Expires one hour after the first page. Each further source page has the normal five-credit price; source totals can change.
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/search-posts-native.json
                      title: linkedin/search-posts-native data fields
                      description: Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type:
                                - string
                                - 'null'
                                description: Exact source identifier; preserve it as a string.
                              url:
                                type:
                                - string
                                - 'null'
                                description: Original source URL when supplied.
                              platform:
                                type:
                                - string
                                - 'null'
                                description: platform
                              title:
                                type:
                                - string
                                - 'null'
                                description: Null for an ordinary post; not inferred from content.
                              text:
                                type:
                                - string
                                - 'null'
                                description: text
                              caption:
                                type:
                                - string
                                - 'null'
                                description: caption
                              created_at:
                                type:
                                - string
                                - 'null'
                                description: created at
                              author:
                                type:
                                - object
                                - 'null'
                                properties:
                                  id:
                                    type:
                                    - string
                                    - 'null'
                                    description: Exact source identifier; preserve it as a string.
                                  handle:
                                    type:
                                    - string
                                    - 'null'
                                    description: handle
                                  name:
                                    type:
                                    - string
                                    - 'null'
                                    description: name
                                  url:
                                    type:
                                    - string
                                    - 'null'
                                    description: url
                                  headline:
                                    type:
                                    - string
                                    - 'null'
                                    description: headline
                                  location:
                                    type:
                                    - string
                                    - 'null'
                                    description: location
                                  avatar_url:
                                    type:
                                    - string
                                    - 'null'
                                    description: avatar url
                                  followers:
                                    type:
                                    - number
                                    - 'null'
                                    description: Public follower count.
                                  verified:
                                    type:
                                    - boolean
                                    - 'null'
                                    description: Explicit verification flag when supplied.
                                  type:
                                    type:
                                    - string
                                    - 'null'
                                    description: person or company when supplied.
                                  website:
                                    type:
                                    - string
                                    - 'null'
                                    description: Original source URL when supplied.
                                  website_label:
                                    type:
                                    - string
                                    - 'null'
                                    description: Public website label.
                                additionalProperties: true
                              stats:
                                type:
                                - object
                                - 'null'
                                properties:
                                  likes:
                                    type:
                                    - number
                                    - 'null'
                                    description: likes; null is unknown.
                                  comments:
                                    type:
                                    - number
                                    - 'null'
                                    description: comments; null is unknown.
                                  replies:
                                    type:
                                    - number
                                    - 'null'
                                    description: replies; null is unknown.
                                  shares:
                                    type:
                                    - number
                                    - 'null'
                                    description: shares; null is unknown.
                                  views:
                                    type:
                                    - number
                                    - 'null'
                                    description: views; null is unknown.
                                additionalProperties: true
                              article:
                                type:
                                - object
                                - 'null'
                                properties:
                                  title:
                                    type:
                                    - string
                                    - 'null'
                                    description: Attached article title, not the post title.
                                  url:
                                    type:
                                    - string
                                    - 'null'
                                    description: Original source URL when supplied.
                                  description:
                                    type:
                                    - string
                                    - 'null'
                                    description: Attached article description.
                                additionalProperties: true
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    type:
                                    - string
                                    description: Exact source identifier; preserve it as a string.
                                    minLength: 1
                              - required:
                                - url
                                properties:
                                  url:
                                    type:
                                    - string
                                    description: Original source URL when supplied.
                                    minLength: 1
                              - required:
                                - title
                                properties:
                                  title:
                                    type:
                                    - string
                                    description: Null for an ordinary post; not inferred from content.
                                    minLength: 1
                              - required:
                                - text
                                properties:
                                  text:
                                    type:
                                    - string
                                    description: text
                                    minLength: 1
                              - required:
                                - caption
                                properties:
                                  caption:
                                    type:
                                    - string
                                    description: caption
                                    minLength: 1
                              - required:
                                - created_at
                                properties:
                                  created_at:
                                    type:
                                    - string
                                    description: created at
                                    minLength: 1
                              - required:
                                - author
                                properties:
                                  author:
                                    type:
                                    - object
                                    properties:
                                      id:
                                        type:
                                        - string
                                        - 'null'
                                        description: Exact source identifier; preserve it as a string.
                                      handle:
                                        type:
                                        - string
                                        - 'null'
                                        description: handle
                                      name:
                                        type:
                                        - string
                                        - 'null'
                                        description: name
                                      url:
                                        type:
                                        - string
                                        - 'null'
                                        description: url
                                      headline:
                                        type:
                                        - string
                                        - 'null'
                                        description: headline
                                      location:
                                        type:
                                        - string
                                        - 'null'
                                        description: location
                                      avatar_url:
                                        type:
                                        - string
                                        - 'null'
                                        description: avatar url
                                      followers:
                                        type:
                                        - number
                                        - 'null'
                                        description: Public follower count.
                                      verified:
                                        type:
                                        - boolean
                                        - 'null'
                                        description: Explicit verification flag when supplied.
                                      type:
                                        type:
                                        - string
                                        - 'null'
                                        description: person or company when supplied.
                                      website:
                                        type:
                                        - string
                                        - 'null'
                                        description: Original source URL when supplied.
                                      website_label:
                                        type:
                                        - string
                                        - 'null'
                                        description: Public website label.
                                    additionalProperties: true
                              - required:
                                - stats
                                properties:
                                  stats:
                                    type:
                                    - object
                                    properties:
                                      likes:
                                        type:
                                        - number
                                        - 'null'
                                        description: likes; null is unknown.
                                      comments:
                                        type:
                                        - number
                                        - 'null'
                                        description: comments; null is unknown.
                                      replies:
                                        type:
                                        - number
                                        - 'null'
                                        description: replies; null is unknown.
                                      shares:
                                        type:
                                        - number
                                        - 'null'
                                        description: shares; null is unknown.
                                      views:
                                        type:
                                        - number
                                        - 'null'
                                        description: views; null is unknown.
                                    additionalProperties: true
                              - required:
                                - article
                                properties:
                                  article:
                                    type:
                                    - object
                                    properties:
                                      title:
                                        type:
                                        - string
                                        - 'null'
                                        description: Attached article title, not the post title.
                                      url:
                                        type:
                                        - string
                                        - 'null'
                                        description: Original source URL when supplied.
                                      description:
                                        type:
                                        - string
                                        - 'null'
                                        description: Attached article description.
                                    additionalProperties: true
                        count:
                          type:
                          - number
                          - 'null'
                          description: Returned rows, not the total population.
                        cursor:
                          type:
                          - string
                          - 'null'
                          description: Opaque continuation; pass unchanged.
                        has_more:
                          type:
                          - boolean
                          - 'null'
                          description: Source continuation indicator.
                        total:
                          type:
                          - number
                          - 'null'
                          description: Source-reported total; null means unknown.
                        source_total:
                          type:
                          - number
                          - 'null'
                          description: Unverified changing source total before local filtering.
                        retrieved_count:
                          type:
                          - number
                          - 'null'
                          description: Rows acquired before date filtering.
                        date_filter:
                          type:
                          - object
                          - 'null'
                          properties:
                            scope:
                              type:
                              - string
                              - 'null'
                              description: scope
                            date_posted:
                              type:
                              - string
                              - 'null'
                              description: date posted
                            date_from:
                              type:
                              - string
                              - 'null'
                              description: date from
                            date_to:
                              type:
                              - string
                              - 'null'
                              description: date to
                            since:
                              type:
                              - string
                              - 'null'
                              description: since
                            until:
                              type:
                              - string
                              - 'null'
                              description: until
                            unknown_date_count:
                              type:
                              - number
                              - 'null'
                              description: unknown date count; null is unknown.
                            excluded_count:
                              type:
                              - number
                              - 'null'
                              description: excluded count; null is unknown.
                          additionalProperties: true
                        fetched_at:
                          type:
                          - string
                          - 'null'
                          description: Source date or timestamp; absent dates remain unknown.
                        completeness:
                          type:
                          - string
                          - 'null'
                          description: Always unknown; no exhaustive coverage or freshness guarantee.
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - items: []
                        count: 0
                        retrieved_count: 0
                        cursor: null
                        has_more: false
                        total: null
                        source_total: 0
                        completeness: unknown
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 5
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
  /v1/linkedin/search-schools:
    get:
      operationId: linkedin_search_schools
      tags:
      - Linked In
      summary: LinkedIn school lookup
      description: LinkedIn schools matching a typed name, each with the id the people-search school filter takes. Costs 4 credits per successful live response.
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
        example: Stanford
        description: The start of a school name
      - name: dry_run
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: judgments
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'on'
          - 'off'
        example: 'on'
        description: 'Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label
        in: query
        required: false
        schema:
          type: string
          enum:
          - default
          - none
        example: none
        description: 'Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.'
      - name: label_evidence
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
          - '0'
          - 'true'
          - 'false'
        example: '1'
        description: 'Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.'
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          enum:
          - engagement_bait
        example: engagement_bait
        description: 'Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.'
      - name: fit
        in: query
        required: false
        schema:
          type: string
          enum:
          - goal
        example: goal
        description: 'Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        example: Find concrete product complaints
        description: 'Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.'
      - name: tokens
        in: query
        required: false
        schema:
          type: string
        example: '4000'
        description: Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.
      - name: X-Max-Credits
        in: header
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        example: 5
        description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs.
      security:
      - ApiKeyHeader: []
      - BearerKey: []
      responses:
        '200':
          description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.'
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Success'
                - type: object
                  properties:
                    data:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      $id: https://www.monocrawl.com/schemas/linkedin/search-schools.json
                      title: linkedin/search-schools data fields
                      description: Optional data supplied by this operation. Null means unknown.
                      type: object
                      properties:
                        count:
                          description: Number of records in this response, not lifetime or total matches.
                          type:
                          - number
                          - 'null'
                        has_more:
                          description: Source continuation indicator; null means unknown.
                          type:
                          - boolean
                          - 'null'
                        items:
                          description: Returned records. Source coverage and completeness vary.
                          type:
                          - array
                          items:
                            description: Optional record supplied by this operation. Null means unknown.
                            type: object
                            properties:
                              id:
                                description: Source identifier. Preserve the supplied type and exact value.
                                type:
                                - string
                                - 'null'
                              kind:
                                description: Optional kind supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                              name:
                                description: Optional name supplied by this operation. Null means unknown.
                                type:
                                - string
                                - 'null'
                            additionalProperties: true
                            allOf:
                            - anyOf:
                              - required:
                                - id
                                properties:
                                  id:
                                    description: Source identifier. Preserve the supplied type and exact value.
                                    type:
                                    - string
                                    minLength: 1
                              - required:
                                - name
                                properties:
                                  name:
                                    description: Optional name supplied by this operation. Null means unknown.
                                    type:
                                    - string
                                    minLength: 1
                        query:
                          description: Optional query supplied by this operation. Null means unknown.
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                      required:
                      - items
                      x-contract-version: '2026-09-22'
                      x-validation-scope: Required success payload structure; optional fields and source completeness remain separate.
                      examples:
                      - count: 0
                        has_more: false
                        items:
                        - id: example
                          kind: example
                          name: example
                        query: example
        default:
          description: The error envelope — the same shape for every non-2xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-credits: 4
      x-production-available: true
      x-capacity:
        status: not_assessed
        message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee.
      x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes.
      x-live-proven: true
components:
  schemas:
    Error:
      type: object
      required:
      - success
      - error
      - credits_used
      - request_id
      properties:
        success:
          const: false
        error:
          type: object
          required:
          - type
          - message
          - status
          properties:
            type:
              type: string
              enum:
              - UNAUTHORIZED
              - KEY_REVOKED
              - KEY_LIMIT_EXCEEDED
              - RATE_LIMITED
              - INSUFFICIENT_CREDITS
              - RESOURCE_NOT_FOUND
              - INVALID_PARAMETERS
              - TARGET_ACCESS_DENIED
              - UPSTREAM_ERROR
              - UPSTREAM_TIMEOUT
              - FREE_CAPACITY_UNAVAILABLE
              - CAPACITY_UNAVAILABLE
              - ENDPOINT_NOT_FOUND
              - ENDPOINT_NOT_AVAILABLE
              - FAIR_USE_EXCEEDED
              - INTERNAL_ERROR
            message:
              type: string
            status:
              type: integer
            doc_url:
              type: string
              description: Deep link to the exact section of the errors guide for this type.
            details:
              type: object
        credits_used:
          type:
          - integer
          - 'null'
          description: Confirmed net charge; null when billing is pending reconciliation. Inspect error.details.billing_status and retain request_id.
        credits_remaining:
          type: integer
        request_id:
          type: string
    Success:
      type: object
      required:
      - success
      - platform
      - endpoint
      - data
      - credits_used
      - credits_remaining
      - request_id
      properties:
        _completeness:
          type: object
          description: Reported response completeness, not a guarantee of complete platform history. Missing source assertions remain unknown.
          properties:
            state:
              type: string
              enum:
              - complete
              - partial
              - unknown
            scope:
              type: string
            inspection_limited:
              type: boolean
        success:
          const: true
        platform:
          type: string
        endpoint:
          type: string
          description: The resolved path, e.g. `/v1/github/profile`.
        data:
          description: Amazon responses include marketplace.country and marketplace.domain (resolved request marketplace, UK by default). X profiles preserve location, bio_link and cover_url when supplied. TikTok profiles preserve commerce_user, seller, region, location and business_category when supplied; region identifies the account region rather than personal residence. TikTok comments use platform_default selection, which can change between fetches; keep the same video and options when following cursors. Amazon review variant is readable text. Facebook profiles preserve cover_url, following and created_at when supplied; likes_count and followers are distinct and follower totals may be rounded. Endpoint-specific normalized payload, not one universal post/profile schema. Many lists use items/count/cursor; a null cursor means no usable next cursor was supplied, not proof that all history was retrieved. Check has_more and warnings where present. Social full-profile bundles use posts_cursor and posts_pagination.next_params; retain all returned next parameters. YouTube channel bundles instead use recent_videos, cursor and recent_videos_pagination. Inspect complete/partial/legs where supplied for bounded or failed components. Optional model-derived fields are labelled, not source facts.
        credits_used:
          type: integer
        credits_remaining:
          type: integer
        request_id:
          type: string
        cached:
          type: boolean
        stale:
          type: boolean
          description: True only for an explicitly labelled, zero-credit reference snapshot served after a temporary upstream failure.
        age_seconds:
          type: integer
          minimum: 0
          description: Age of a stale snapshot since its original retrieval; not reset by outage recovery.
        fetched_at:
          type: string
          format: date-time
          description: Original retrieval time of a stale snapshot, in UTC.
        synthetic:
          type: boolean
          description: Present and true only on the explicitly requested /sandbox surface. Synthetic responses are representative and charged 0 credits; production /v1 never returns them.
        degraded:
          type: boolean
          description: Reserved for sandbox compatibility. Production /v1 reports upstream failure as an error and never serves a representative fallback.
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: Your API key (`mn_…`), from the console. The recommended style.
    BearerKey:
      type: http
      scheme: bearer
      description: The same key as a Bearer token, for clients that only expose an Authorization field. Keys are never accepted in the query string — URLs leak into logs and referrers.
x-provenance:
  method: harvested
  publisher: Monocrawl
  source: https://www.monocrawl.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)