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

# Read the latest website links run

> The seller's latest link suggestions run with the queue's live view of it (state and progress while it runs), the page outcomes written so far and its suggestions, each an exact edit to one of the seller's pages. Poll it while a run is in flight; suggestions appear as pages settle. `run` is null before the first run.



## OpenAPI

````yaml https://api.zeroclick.io/openapi.json get /v1/sellers/{sellerId}/links/runs/latest
openapi: 3.0.0
info:
  title: ZeroClick API
  description: >-
    REST API for managing ZeroClick sellers, services, pricing, usage, and
    analytics. Authenticate with an API key from the ZeroClick dashboard.
  version: 1.0.0
servers:
  - url: https://api.zeroclick.io
security:
  - bearerAuth: []
tags:
  - name: API keys
  - name: Sellers
  - name: Services
  - name: Meters
  - name: Plans
  - name: Plan meter prices
  - name: Usage
  - name: Analytics
  - name: Agentify
  - name: Stripe Connect
  - name: Sandbox
  - name: Organizations
  - name: Users
paths:
  /v1/sellers/{sellerId}/links/runs/latest:
    get:
      tags:
        - Sellers
      summary: Read the latest website links run
      description: >-
        The seller's latest link suggestions run with the queue's live view of
        it (state and progress while it runs), the page outcomes written so far
        and its suggestions, each an exact edit to one of the seller's pages.
        Poll it while a run is in flight; suggestions appear as pages settle.
        `run` is null before the first run.
      parameters:
        - schema:
            type: string
            minLength: 1
          in: path
          name: sellerId
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  run:
                    nullable: true
                    type: object
                    properties:
                      id:
                        type: string
                      status:
                        type: string
                        enum:
                          - queued
                          - running
                          - done
                          - failed
                          - cancelled
                      createdAt:
                        type: string
                      startedAt:
                        nullable: true
                        type: string
                      finishedAt:
                        nullable: true
                        type: string
                      coreVersion:
                        type: string
                      judgeModel:
                        type: string
                      writerModel:
                        nullable: true
                        type: string
                      seeds:
                        type: array
                        items:
                          type: string
                      stats:
                        nullable: true
                        type: object
                        properties:
                          discovered:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          selected:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          read:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          proposed:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          alreadyLinked:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          linkStorefront:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          noDestination:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          noPlacement:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          duplicates:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          skipped:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          failed:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          carried:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          applied:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          kinds:
                            type: object
                            properties:
                              article:
                                type: object
                                properties:
                                  found:
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  read:
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                required:
                                  - found
                                  - read
                                additionalProperties: false
                              docs:
                                type: object
                                properties:
                                  found:
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  read:
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                required:
                                  - found
                                  - read
                                additionalProperties: false
                              marketing:
                                type: object
                                properties:
                                  found:
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  read:
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                required:
                                  - found
                                  - read
                                additionalProperties: false
                              never:
                                type: object
                                properties:
                                  found:
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  read:
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                required:
                                  - found
                                  - read
                                additionalProperties: false
                            required:
                              - article
                              - docs
                              - marketing
                              - never
                            additionalProperties: false
                          sources:
                            type: object
                            properties:
                              declared:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              sitemaps:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              probes:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              crawl:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                            required:
                              - declared
                              - sitemaps
                              - probes
                              - crawl
                            additionalProperties: false
                          judgeCalls:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          writerCalls:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          inputTokens:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          outputTokens:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          edits:
                            type: object
                            properties:
                              linkPhrase:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              addSentence:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              fixed:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                            required:
                              - linkPhrase
                              - addSentence
                              - fixed
                            additionalProperties: false
                          firstResultMs:
                            nullable: true
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          ms:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          timedOut:
                            type: boolean
                        required:
                          - discovered
                          - selected
                          - read
                          - proposed
                          - alreadyLinked
                          - noDestination
                          - noPlacement
                          - duplicates
                          - skipped
                          - failed
                          - carried
                          - applied
                          - kinds
                          - sources
                          - judgeCalls
                          - writerCalls
                          - inputTokens
                          - outputTokens
                          - edits
                          - firstResultMs
                          - ms
                          - timedOut
                        additionalProperties: false
                      error:
                        nullable: true
                        type: string
                    required:
                      - id
                      - status
                      - createdAt
                      - startedAt
                      - finishedAt
                      - coreVersion
                      - judgeModel
                      - writerModel
                      - seeds
                      - stats
                      - error
                    additionalProperties: false
                  job:
                    nullable: true
                    type: object
                    properties:
                      state:
                        type: string
                        enum:
                          - waiting
                          - active
                          - delayed
                          - prioritized
                          - waiting-children
                          - completed
                          - failed
                          - unknown
                          - not-found
                      progress:
                        nullable: true
                        type: object
                        properties:
                          phase:
                            type: string
                          pct:
                            type: number
                          processed:
                            type: number
                          total:
                            type: number
                          current:
                            type: string
                        required:
                          - phase
                          - pct
                        additionalProperties: false
                      failedReason:
                        nullable: true
                        type: string
                      cancelled:
                        type: boolean
                    required:
                      - state
                      - progress
                      - failedReason
                      - cancelled
                    additionalProperties: false
                  pages:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        url:
                          type: string
                        status:
                          type: string
                          enum:
                            - proposed
                            - already_linked
                            - no_destination
                            - no_placement
                            - duplicate
                            - skipped
                            - failed
                        reason:
                          nullable: true
                          type: string
                        title:
                          nullable: true
                          type: string
                        kind:
                          nullable: true
                          type: string
                          enum:
                            - article
                            - docs
                            - marketing
                            - never
                        hash:
                          nullable: true
                          type: string
                        capturedAt:
                          nullable: true
                          type: string
                        selectionScore:
                          nullable: true
                          type: number
                        fetchMs:
                          nullable: true
                          type: number
                      required:
                        - id
                        - url
                        - status
                        - reason
                        - title
                        - kind
                        - hash
                        - capturedAt
                        - selectionScore
                        - fetchMs
                      additionalProperties: false
                  suggestions:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        runId:
                          type: string
                        page:
                          type: object
                          properties:
                            id:
                              type: string
                            url:
                              type: string
                            title:
                              nullable: true
                              type: string
                            hash:
                              nullable: true
                              type: string
                            capturedAt:
                              nullable: true
                              type: string
                          required:
                            - id
                            - url
                            - title
                            - hash
                            - capturedAt
                          additionalProperties: false
                        blockIndex:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        start:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        end:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        blockHash:
                          type: string
                        section:
                          type: array
                          items:
                            type: string
                        surrounding:
                          nullable: true
                          type: object
                          properties:
                            before:
                              nullable: true
                              type: string
                            after:
                              nullable: true
                              type: string
                          required:
                            - before
                            - after
                          additionalProperties: false
                        kind:
                          type: string
                          enum:
                            - link-phrase
                            - add-sentence
                        anchor:
                          type: string
                        insert:
                          nullable: true
                          type: string
                        before:
                          type: string
                        after:
                          type: string
                        sentence:
                          nullable: true
                          type: object
                          properties:
                            before:
                              type: string
                            after:
                              type: string
                          required:
                            - before
                            - after
                          additionalProperties: false
                        destination:
                          type: object
                          properties:
                            kind:
                              type: string
                            url:
                              type: string
                            name:
                              type: string
                          required:
                            - kind
                            - url
                            - name
                          additionalProperties: false
                        reason:
                          type: string
                        scores:
                          type: object
                          additionalProperties: {}
                        status:
                          type: string
                          enum:
                            - open
                            - done
                            - applied
                        statusChangedAt:
                          nullable: true
                          type: string
                        carriedFrom:
                          nullable: true
                          type: string
                        createdAt:
                          type: string
                      required:
                        - id
                        - runId
                        - page
                        - blockIndex
                        - start
                        - end
                        - blockHash
                        - section
                        - surrounding
                        - kind
                        - anchor
                        - insert
                        - before
                        - after
                        - sentence
                        - destination
                        - reason
                        - scores
                        - status
                        - statusChangedAt
                        - carriedFrom
                        - createdAt
                      additionalProperties: false
                required:
                  - run
                  - job
                  - pages
                  - suggestions
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - organization_required
                      - feature_not_enabled
                      - seller_not_found
                      - run_not_found
                      - run_finished
                      - suggestion_not_found
                      - suggestion_applied
                      - ai_not_configured
                      - website_required
                  note:
                    type: string
                required:
                  - error
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - organization_required
                      - feature_not_enabled
                      - seller_not_found
                      - run_not_found
                      - run_finished
                      - suggestion_not_found
                      - suggestion_applied
                      - ai_not_configured
                      - website_required
                  note:
                    type: string
                required:
                  - error
                additionalProperties: false
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - organization_required
                      - feature_not_enabled
                      - seller_not_found
                      - run_not_found
                      - run_finished
                      - suggestion_not_found
                      - suggestion_applied
                      - ai_not_configured
                      - website_required
                  note:
                    type: string
                required:
                  - error
                additionalProperties: false
        '503':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - organization_required
                      - feature_not_enabled
                      - seller_not_found
                      - run_not_found
                      - run_finished
                      - suggestion_not_found
                      - suggestion_applied
                      - ai_not_configured
                      - website_required
                  note:
                    type: string
                required:
                  - error
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key created in the ZeroClick dashboard under Settings → API keys.
        Keys start with `zc_`. Send them as `Authorization: Bearer zc_...`.

````

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