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

# Search LinkedIn auto-scrapes

> List the team's collectors: saved jobs that paginate one LinkedIn or Sales Navigator list surface on a cadence and file deduped leads. Use for: which collectors are live or paused and why (status, paused_reason), what a given account collects (linkedin_account_sid), which ones feed outreach (mass_action_sid, is_null:true = collect-only), what runs next (sort next_run_at asc), and which produce (total_new_results). NOT for the leads themselves (search_linkedin_auto_scrape_results) or for one execution (search_linkedin_auto_scrape_runs). No q, and no include[] is served. Sort: created_at (default desc) | updated_at | next_run_at | last_run_at | total_new_results. page_size:0 returns the count alone.

Contract:
- MCP tool `search_linkedin_auto_scrapes`, registry package `mcp.linkedin/linkedin_auto_scrapes`, mount `linkedin.auto-scrapes`.
- Operation `search`, response envelope `search`.
- Flags: read only.



## OpenAPI

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


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


    Surface: the public `/api` contract of `gtm.service.linkedin`, 150
    operations. Internal (`/internal`) and health endpoints are deliberately
    absent; the code-faithful spec that documents those lives in
    `product/openapi/gtm.openapi.tech`.


    Conventions:

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

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

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

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

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

    - The MCP-only `_meta` field (usage analytics) never reaches the backend and
    is not part of this contract.
  version: '1.0'
  contact:
    name: GTM API
    url: https://gtm-api.com
    email: support@gtm-api.com
  license:
    name: Proprietary
    url: https://gtm-api.com/license
servers:
  - url: https://app.gtm-api.com/linkedin/v4
    description: Production, through the app.gtm-api.com gateway
  - url: http://localhost:8020
    description: Local Docker (gtm_linkedin_nginx_dev)
security:
  - BearerJwt: []
    TeamSid: []
tags:
  - name: antidetect_browser_logs
    description: >-
      Registry package `mcp.linkedin/antidetect_browser_logs`, served on MCP
      mount `linkedin.browsers`.
  - name: antidetect_browser_proxies
    description: >-
      Registry package `mcp.linkedin/antidetect_browser_proxies`, served on MCP
      mount `linkedin.browsers`.
  - name: antidetect_browsers
    description: >-
      Registry package `mcp.linkedin/antidetect_browsers`, served on MCP mount
      `linkedin.browsers`.
  - name: cloud_browser_sessions
    description: >-
      Registry package `mcp.linkedin/cloud_browser_sessions`, served on MCP
      mount `linkedin.browsers`.
  - name: cloud_browsers
    description: >-
      Registry package `mcp.linkedin/cloud_browsers`, served on MCP mount
      `linkedin.browsers`.
  - name: data_requests
    description: >-
      Registry package `mcp.linkedin/data_requests`, served on MCP mount
      `linkedin.data`.
  - name: linkedin_account_activity_log
    description: >-
      Registry package `mcp.linkedin/linkedin_account_activity_log`, served on
      MCP mount `linkedin.account-monitor`.
  - name: linkedin_account_block_log
    description: >-
      Registry package `mcp.linkedin/linkedin_account_block_log`, served on MCP
      mount `linkedin.account-monitor`.
  - name: linkedin_account_quota_hits
    description: >-
      Registry package `mcp.linkedin/linkedin_account_quota_hits`, served on MCP
      mount `linkedin.account-monitor`.
  - name: linkedin_account_smart_limits
    description: >-
      Registry package `mcp.linkedin/linkedin_account_smart_limits`, served on
      MCP mount `linkedin.accounts`.
  - name: linkedin_account_snapshots
    description: >-
      Registry package `mcp.linkedin/linkedin_account_snapshots`, served on MCP
      mount `linkedin.account-monitor`.
  - name: linkedin_account_sync_runs
    description: >-
      Registry package `mcp.linkedin/linkedin_account_sync_runs`, served on MCP
      mount `linkedin.account-monitor`.
  - name: linkedin_accounts
    description: >-
      Registry package `mcp.linkedin/linkedin_accounts`, served on MCP mount
      `linkedin.accounts`.
  - name: linkedin_auto_scrape_results
    description: >-
      Registry package `mcp.linkedin/linkedin_auto_scrape_results`, served on
      MCP mount `linkedin.auto-scrapes`.
  - name: linkedin_auto_scrape_runs
    description: >-
      Registry package `mcp.linkedin/linkedin_auto_scrape_runs`, served on MCP
      mount `linkedin.auto-scrapes`.
  - name: linkedin_auto_scrapes
    description: >-
      Registry package `mcp.linkedin/linkedin_auto_scrapes`, served on MCP mount
      `linkedin.auto-scrapes`.
  - name: linkedin_benchmarks
    description: >-
      Registry package `mcp.linkedin/linkedin_benchmarks`, served on MCP mount
      `linkedin.account-monitor`.
  - name: linkedin_connection_invitations
    description: >-
      Registry package `mcp.linkedin/linkedin_connection_invitations`, served on
      MCP mount `linkedin.network`.
  - name: linkedin_connection_requests
    description: >-
      Registry package `mcp.linkedin/linkedin_connection_requests`, served on
      MCP mount `linkedin.network`.
  - name: linkedin_connections
    description: >-
      Registry package `mcp.linkedin/linkedin_connections`, served on MCP mount
      `linkedin.network`.
  - name: linkedin_conversations
    description: >-
      Registry package `mcp.linkedin/linkedin_conversations`, served on MCP
      mount `linkedin.messaging`.
  - name: linkedin_custom_requests
    description: >-
      Registry package `mcp.linkedin/linkedin_custom_requests`, served on MCP
      mount `linkedin.platform`.
  - name: linkedin_enrichment
    description: >-
      Registry package `mcp.linkedin/linkedin_enrichment`, served on MCP mount
      `linkedin.enrichment`.
  - name: linkedin_followers
    description: >-
      Registry package `mcp.linkedin/linkedin_followers`, served on MCP mount
      `linkedin.network`.
  - name: linkedin_messages
    description: >-
      Registry package `mcp.linkedin/linkedin_messages`, served on MCP mount
      `linkedin.messaging`.
  - name: linkedin_posting
    description: >-
      Registry package `mcp.linkedin/linkedin_posting`, served on MCP mount
      `linkedin.content`.
  - name: linkedin_scraping
    description: >-
      Registry package `mcp.linkedin/linkedin_scraping`, served on MCP mount
      `linkedin.scraping`.
paths:
  /api/linkedin-auto-scrapes/search:
    post:
      tags:
        - linkedin_auto_scrapes
      summary: Search LinkedIn auto-scrapes
      description: >-
        List the team's collectors: saved jobs that paginate one LinkedIn or
        Sales Navigator list surface on a cadence and file deduped leads. Use
        for: which collectors are live or paused and why (status,
        paused_reason), what a given account collects (linkedin_account_sid),
        which ones feed outreach (mass_action_sid, is_null:true = collect-only),
        what runs next (sort next_run_at asc), and which produce
        (total_new_results). NOT for the leads themselves
        (search_linkedin_auto_scrape_results) or for one execution
        (search_linkedin_auto_scrape_runs). No q, and no include[] is served.
        Sort: created_at (default desc) | updated_at | next_run_at | last_run_at
        | total_new_results. page_size:0 returns the count alone.


        Contract:

        - MCP tool `search_linkedin_auto_scrapes`, registry package
        `mcp.linkedin/linkedin_auto_scrapes`, mount `linkedin.auto-scrapes`.

        - Operation `search`, response envelope `search`.

        - Flags: read only.
      operationId: search_linkedin_auto_scrapes
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchLinkedinAutoScrapesRequest'
      responses:
        '200':
          description: '`search` success envelope.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchLinkedinAutoScrapesResponse'
        4XX:
          $ref: '#/components/responses/McpClientError'
        5XX:
          $ref: '#/components/responses/McpServerError'
components:
  schemas:
    SearchLinkedinAutoScrapesRequest:
      type: object
      description: Request body of `search_linkedin_auto_scrapes`.
      properties:
        filter:
          type: object
          properties:
            sid:
              type: object
              properties:
                eq:
                  type: string
                in:
                  type: array
                  items:
                    type: string
              additionalProperties: false
            linkedin_account_sid:
              type: object
              properties:
                eq:
                  type: string
                in:
                  type: array
                  items:
                    type: string
              additionalProperties: false
            source_method:
              type: object
              properties:
                eq:
                  type: string
                  enum:
                    - search-people-by-url
                    - search-people-by-params
                    - search-sales-nav-people-by-url
                    - search-sales-nav-people-by-params
                    - similar-profiles
                    - company-employees
                    - company-decision-makers
                    - get-post-commenters
                    - get-post-reactors
                    - get-post-resharers
                    - search-companies-by-url
                    - search-companies-by-params
                    - search-sales-nav-companies-by-url
                    - search-sales-nav-companies-by-params
                    - similar-companies
                ne:
                  type: string
                  enum:
                    - search-people-by-url
                    - search-people-by-params
                    - search-sales-nav-people-by-url
                    - search-sales-nav-people-by-params
                    - similar-profiles
                    - company-employees
                    - company-decision-makers
                    - get-post-commenters
                    - get-post-reactors
                    - get-post-resharers
                    - search-companies-by-url
                    - search-companies-by-params
                    - search-sales-nav-companies-by-url
                    - search-sales-nav-companies-by-params
                    - similar-companies
                in:
                  type: array
                  items:
                    type: string
                    enum:
                      - search-people-by-url
                      - search-people-by-params
                      - search-sales-nav-people-by-url
                      - search-sales-nav-people-by-params
                      - similar-profiles
                      - company-employees
                      - company-decision-makers
                      - get-post-commenters
                      - get-post-reactors
                      - get-post-resharers
                      - search-companies-by-url
                      - search-companies-by-params
                      - search-sales-nav-companies-by-url
                      - search-sales-nav-companies-by-params
                      - similar-companies
                nin:
                  type: array
                  items:
                    type: string
                    enum:
                      - search-people-by-url
                      - search-people-by-params
                      - search-sales-nav-people-by-url
                      - search-sales-nav-people-by-params
                      - similar-profiles
                      - company-employees
                      - company-decision-makers
                      - get-post-commenters
                      - get-post-reactors
                      - get-post-resharers
                      - search-companies-by-url
                      - search-companies-by-params
                      - search-sales-nav-companies-by-url
                      - search-sales-nav-companies-by-params
                      - similar-companies
              additionalProperties: false
            detected_platform:
              type: object
              properties:
                eq:
                  type: string
                  enum:
                    - linkedin
                    - sales_navigator
                    - recruiter
                ne:
                  type: string
                  enum:
                    - linkedin
                    - sales_navigator
                    - recruiter
                in:
                  type: array
                  items:
                    type: string
                    enum:
                      - linkedin
                      - sales_navigator
                      - recruiter
                nin:
                  type: array
                  items:
                    type: string
                    enum:
                      - linkedin
                      - sales_navigator
                      - recruiter
              additionalProperties: false
            result_kind:
              type: object
              properties:
                eq:
                  type: string
                  enum:
                    - person
                    - company
                in:
                  type: array
                  items:
                    type: string
                    enum:
                      - person
                      - company
              additionalProperties: false
            replay_frequency:
              type: object
              properties:
                eq:
                  type: string
                  enum:
                    - hourly
                    - daily
                    - weekly
                    - monthly
                in:
                  type: array
                  items:
                    type: string
                    enum:
                      - hourly
                      - daily
                      - weekly
                      - monthly
                is_null:
                  type: boolean
              additionalProperties: false
              description: is_null:true selects the one-shot jobs (no cadence).
            status:
              type: object
              properties:
                eq:
                  type: string
                  enum:
                    - active
                    - paused
                in:
                  type: array
                  items:
                    type: string
                    enum:
                      - active
                      - paused
              additionalProperties: false
            paused_reason:
              type: object
              properties:
                eq:
                  type: string
                  enum:
                    - manual
                    - too_many_failures
                    - account_unavailable
                in:
                  type: array
                  items:
                    type: string
                    enum:
                      - manual
                      - too_many_failures
                      - account_unavailable
                is_null:
                  type: boolean
              additionalProperties: false
              description: >-
                Why a paused job stopped. account_unavailable is the only reason
                the platform lifts by itself.
            mass_action_sid:
              type: object
              properties:
                eq:
                  type: string
                in:
                  type: array
                  items:
                    type: string
                is_null:
                  type: boolean
              additionalProperties: false
              description: >-
                is_null:true selects collect-only jobs; eq finds every collector
                feeding one mass-action.
            next_run_at:
              type: object
              properties:
                gte:
                  type: string
                lte:
                  type: string
                gt:
                  type: string
                lt:
                  type: string
                is_null:
                  type: boolean
              additionalProperties: false
              description: >-
                Due horizon. is_null:true means paused, an exhausted one-shot,
                or a run already in flight.
            last_run_at:
              type: object
              properties:
                gte:
                  type: string
                lte:
                  type: string
                gt:
                  type: string
                lt:
                  type: string
                is_null:
                  type: boolean
              additionalProperties: false
            total_new_results:
              type: object
              properties:
                eq:
                  type: integer
                gte:
                  type: integer
                lte:
                  type: integer
                gt:
                  type: integer
                lt:
                  type: integer
              additionalProperties: false
            created_at:
              type: object
              properties:
                gte:
                  type: string
                lte:
                  type: string
                gt:
                  type: string
                lt:
                  type: string
              additionalProperties: false
            updated_at:
              type: object
              properties:
                gte:
                  type: string
                lte:
                  type: string
                gt:
                  type: string
                lt:
                  type: string
              additionalProperties: false
            deleted_at:
              type: object
              properties:
                gte:
                  type: string
                lte:
                  type: string
                is_null:
                  type: boolean
              additionalProperties: false
              description: >-
                Omit for live jobs only; send any operator to bring deleted
                collectors into scope.
        include:
          type: array
          items:
            type: string
          description: Relations to eager-load (see entity Includes).
        sort:
          type: object
          properties:
            field:
              type: string
              enum:
                - created_at
                - updated_at
                - next_run_at
                - last_run_at
                - total_new_results
            direction:
              type: string
              enum:
                - asc
                - desc
              description: Default desc.
          required:
            - field
        page_size:
          type: integer
          minimum: 0
          maximum: 200
          description: >-
            0..200, default 50. page_size=0 = count-only, page_size=1 =
            getFirst.
        cursor:
          type: string
          nullable: true
          description: >-
            Opaque forward cursor from a previous response
            pagination.next_cursor.
    SearchLinkedinAutoScrapesResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        operation:
          type: string
          enum:
            - search
        items:
          type: array
          items:
            type: object
            properties:
              item:
                type: object
                properties:
                  sid:
                    type: string
                  team_sid:
                    type: string
                  linkedin_account_sid:
                    type: string
                  source_method:
                    type: string
                    enum:
                      - search-people-by-url
                      - search-people-by-params
                      - search-sales-nav-people-by-url
                      - search-sales-nav-people-by-params
                      - similar-profiles
                      - company-employees
                      - company-decision-makers
                      - get-post-commenters
                      - get-post-reactors
                      - get-post-resharers
                      - search-companies-by-url
                      - search-companies-by-params
                      - search-sales-nav-companies-by-url
                      - search-sales-nav-companies-by-params
                      - similar-companies
                  source_input:
                    type: object
                    additionalProperties: {}
                  detected_platform:
                    type: string
                    enum:
                      - linkedin
                      - sales_navigator
                      - recruiter
                  result_kind:
                    type: string
                    enum:
                      - person
                      - company
                  status:
                    type: string
                    enum:
                      - active
                      - paused
                  consecutive_failures:
                    type: number
                  runs_count:
                    type: number
                  total_new_results:
                    type: number
                  title:
                    type: string
                    nullable: true
                  replay_frequency:
                    type: string
                    nullable: true
                    enum:
                      - hourly
                      - daily
                      - weekly
                      - monthly
                  paused_reason:
                    type: string
                    nullable: true
                    enum:
                      - manual
                      - too_many_failures
                      - account_unavailable
                  next_run_at:
                    type: string
                    nullable: true
                  last_run_at:
                    type: string
                    nullable: true
                  mass_action_sid:
                    type: string
                    nullable: true
                  created_by:
                    type: object
                    nullable: true
                    properties:
                      actor_type:
                        type: string
                        enum:
                          - user
                          - support
                          - api_key
                          - system
                      actor_sid:
                        type: string
                        nullable: true
                      team_sid:
                        type: string
                      permissions:
                        type: object
                        additionalProperties: {}
                      request_sid:
                        type: string
                        nullable: true
                      reason:
                        type: string
                        nullable: true
                    required:
                      - actor_type
                      - actor_sid
                      - team_sid
                      - permissions
                  deleted_by:
                    type: object
                    nullable: true
                    properties:
                      actor_type:
                        type: string
                        enum:
                          - user
                          - support
                          - api_key
                          - system
                      actor_sid:
                        type: string
                        nullable: true
                      team_sid:
                        type: string
                      permissions:
                        type: object
                        additionalProperties: {}
                      request_sid:
                        type: string
                        nullable: true
                      reason:
                        type: string
                        nullable: true
                    required:
                      - actor_type
                      - actor_sid
                      - team_sid
                      - permissions
                  created_at:
                    type: string
                  updated_at:
                    type: string
                  deleted_at:
                    type: string
                    nullable: true
                required:
                  - sid
                  - team_sid
                  - linkedin_account_sid
                  - source_method
                  - source_input
                  - detected_platform
                  - result_kind
                  - status
                  - consecutive_failures
                  - runs_count
                  - total_new_results
                  - title
                  - replay_frequency
                  - paused_reason
                  - next_run_at
                  - last_run_at
                  - mass_action_sid
                  - created_by
                  - deleted_by
                  - created_at
                  - updated_at
                  - deleted_at
              included:
                type: object
                additionalProperties: {}
            required:
              - item
              - included
        pagination:
          type: object
          properties:
            next_cursor:
              type: string
              nullable: true
            has_more:
              type: boolean
            total_count:
              type: integer
              nullable: true
          required:
            - next_cursor
            - has_more
            - total_count
        applied_filters:
          type: object
          additionalProperties: {}
        includes:
          type: array
          items:
            type: string
        meta:
          type: object
          properties:
            trace_id:
              type: string
              description: UUID v7; same 128-bit value as the X-Trace-Id header.
            span_id:
              type: string
              pattern: ^[0-9a-f]{16}$
              description: 16 hex chars, root span of this request.
            timestamp:
              type: string
              description: ISO 8601 UTC (Y-m-dTH:i:sZ), response time.
            duration_ms:
              type: integer
              minimum: 0
              description: Server-side wall clock.
            debug_url:
              type: string
              description: Deep link to the post-call analysis UI.
          required:
            - trace_id
            - span_id
            - timestamp
            - duration_ms
            - debug_url
        counts:
          type: object
          properties: {}
      required:
        - success
        - operation
        - items
        - pagination
        - applied_filters
        - includes
        - meta
    McpError:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_failed
                - nothing_to_update
                - not_found
                - relation_not_found
                - invalid_transition
                - limit_exceeded
                - payment_required
                - duplicate_rejected
                - conflict
                - delete_blocked
                - unauthorized
                - forbidden
                - rate_limited
                - internal_error
                - service_unavailable
                - not_implemented
            message:
              type: string
            recoverable:
              type: boolean
            suggestion:
              type: string
            field_errors:
              type: object
              additionalProperties:
                type: array
                items:
                  anyOf:
                    - type: string
                    - type: object
                      properties:
                        rule:
                          type: string
                        message:
                          type: string
                      required:
                        - rule
                        - message
            blockers:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                    description: >-
                      Machine-readable blocker type (active_flow, pending_tasks,
                      …).
                  severity:
                    type: string
                    enum:
                      - hard
                      - soft
                    description: >-
                      hard = external action required; soft = acknowledge is
                      enough.
                  description:
                    type: string
                  entity_sid:
                    type: string
                    nullable: true
                  count:
                    type: integer
                  resolution:
                    type: string
                    description: 'Hard: tool name to call. Soft: code for acknowledge[].'
                  resolution_hint:
                    type: string
                required:
                  - type
                  - severity
                  - description
                  - entity_sid
                  - resolution
                  - resolution_hint
            context:
              type: object
              additionalProperties: {}
          required:
            - code
            - message
            - recoverable
        meta:
          type: object
          properties:
            trace_id:
              type: string
              description: UUID v7; same 128-bit value as the X-Trace-Id header.
            span_id:
              type: string
              pattern: ^[0-9a-f]{16}$
              description: 16 hex chars, root span of this request.
            timestamp:
              type: string
              description: ISO 8601 UTC (Y-m-dTH:i:sZ), response time.
            duration_ms:
              type: integer
              minimum: 0
              description: Server-side wall clock.
            debug_url:
              type: string
              description: Deep link to the post-call analysis UI.
          required:
            - trace_id
            - span_id
            - timestamp
            - duration_ms
            - debug_url
      required:
        - success
        - error
  responses:
    McpClientError:
      description: >-
        MCP error envelope. `error.code` is one of validation_failed,
        nothing_to_update, not_found, relation_not_found, invalid_transition,
        limit_exceeded, payment_required, duplicate_rejected, conflict,
        delete_blocked, unauthorized, forbidden, rate_limited, not_implemented.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/McpError'
    McpServerError:
      description: >-
        MCP error envelope with `error.code` internal_error or
        service_unavailable.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/McpError'
  securitySchemes:
    BearerJwt:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Access token issued by gtm.service.id. Its `access_identity` claim
        carries `team_sid`, `actor_sid` and `actor_type`, and that team scope is
        authoritative.
    TeamSid:
      type: apiKey
      in: header
      name: Team-SID
      description: >-
        Team scope for tokens that do not carry one. Ignored when the token
        already names a team.

````