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

# Get content insights

> Retrieve results of a previously submitted insight generation request.



## OpenAPI

````yaml GET /v4/accounts/{accountId}/drafts/{draftId}/insights
openapi: 3.1.0
info:
  title: Conductor API Documentation
  version: 4.0.0
  license:
    name: Conductor terms of service
    url: https://www.conductor.com/legal/
  termsOfService: https://www.conductor.com/legal/
  x-logo:
    url: https://app.conductor.com/images/global/logo_login.png
servers:
  - url: https://api.conductor.com
security:
  - ApiKeyAuth: []
    SigAuth: []
tags:
  - name: Draft Management
    description: Create, retrieve, update, and delete Writing Assistant drafts.
  - name: Content Insights
    description: >-
      Request and retrieve AI-driven content insights and recommendations for a
      draft.
  - name: Content Generation
    description: >-
      Generate and revise content assets — outlines, drafts, meta descriptions,
      title tags, outline expansions, and shortened text.
  - name: Content Guidance
    description: >-
      Validate and guide content against target keywords and optimization
      criteria.
  - name: Content Score
    description: >-
      Evaluate on-page content and return scoring insights across intent
      alignment and topical coverage.
  - name: Content Profile
    description: >-
      Create, retrieve, update, and delete reusable voice, tone, and
      language-rule profiles applied to draft generation.
  - name: Internal Linking
    description: >-
      Get anchor text and URL recommendations for internal linking based on a
      customer's embedded pages.
paths:
  /v4/accounts/{accountId}/drafts/{draftId}/insights:
    get:
      tags:
        - Content Insights
      summary: Get content insights
      description: Retrieve results of a previously submitted insight generation request.
      operationId: getInsights
      parameters:
        - name: accountId
          in: path
          required: true
          schema:
            type: integer
          description: Account identifier
        - name: draftId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Draft identifier
        - name: insights
          in: query
          required: false
          description: Specific insight types to retrieve
          schema:
            type: array
            items:
              $ref: '#/components/schemas/InsightType'
          style: form
          explode: true
      responses:
        '200':
          description: Insights status and data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentInsightsResponse'
        '401':
          description: Missing or invalid API key/signature.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            Caller does not have access to this account, or the draft belongs to
            a different account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SpringBootErrorResponse'
        '404':
          description: Draft not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SpringBootErrorResponse'
components:
  schemas:
    InsightType:
      type: string
      enum:
        - PAA_INSIGHT
        - BODY_CONTENT_COMMON
        - CONTENT_ANALYSIS_INSIGHT
        - HTML_HEADING1_COMMON
        - HTML_HEADING2_COMMON
        - HTML_HEADING3_COMMON
        - HTML_META_DESCRIPTION_COMMON
        - HTML_TITLE_COMMON
        - CONTENT_LENGTH_INSIGHT
        - READABILITY_INSIGHT
        - OBJECTIVE_INSIGHT
        - AUDIENCE_INSIGHT
        - JOURNEY_STAGE_INSIGHT
        - CONTENT_TYPE_INSIGHT
        - SUBTOPIC_INSIGHT
        - OPPORTUNITIES_SNIPPET
        - MSV_SNIPPET
    ContentInsightsResponse:
      type: object
      required:
        - status
        - insightsStatus
        - snippetsStatus
        - results
      properties:
        startTime:
          type: integer
          format: int64
          description: Epoch milliseconds when generation started.
        status:
          $ref: '#/components/schemas/CollectionStatus'
        insightsStatus:
          $ref: '#/components/schemas/CollectionStatus'
        snippetsStatus:
          $ref: '#/components/schemas/CollectionStatus'
        results:
          type: object
          nullable: true
          description: >-
            Null while status is PROCESSING; populated once generation
            completes.
          required:
            - insights
            - snippets
          properties:
            insights:
              type: array
              items:
                $ref: '#/components/schemas/Insight'
            snippets:
              type: array
              items:
                $ref: '#/components/schemas/Snippet'
            contentProfile:
              $ref: '#/components/schemas/ContentProfile'
              nullable: true
            referenceDocuments:
              type: array
              nullable: true
              items:
                $ref: '#/components/schemas/ReferenceDocument'
    Error:
      type: object
      description: >-
        Error envelope for failures that apply uniformly across all v4 endpoints
        (e.g. gateway-level authentication failures).
      properties:
        code:
          type: string
          description: Machine-readable error code.
        message:
          type: string
          description: Human-readable error description.
    SpringBootErrorResponse:
      type: object
      description: >-
        Default error body returned by the Spring Boot backends (sage-history,
        content-guidance, serp-explorer) for unhandled/framework-level errors.
        Not endpoint-specific.
      properties:
        timestamp:
          type: string
          format: date-time
        status:
          type: integer
        error:
          type: string
          description: HTTP reason phrase, e.g. "Bad Request".
        message:
          type: string
          nullable: true
          description: >-
            Often empty; these backends do not consistently populate a detail
            message.
        path:
          type: string
    CollectionStatus:
      type: string
      description: >-
        Collection/processing state for the response, an insight, a snippet, or
        a page.
      enum:
        - PROCESSING
        - COMPLETED
        - COMPLETED_WITH_ERROR
        - FAILED
        - TIMEOUTED
    Insight:
      type: object
      required:
        - type
        - status
        - insightPresent
        - empty
      discriminator:
        propertyName: type
        mapping:
          CONTENT_ANALYSIS_INSIGHT:
            $ref: '#/components/schemas/ContentAnalysisInsight'
          PAA_INSIGHT:
            $ref: '#/components/schemas/PaaInsight'
          READABILITY_INSIGHT:
            $ref: '#/components/schemas/ReadabilityInsight'
          JOURNEY_STAGE_INSIGHT:
            $ref: '#/components/schemas/JourneyStageInsight'
          SUBTOPIC_INSIGHT:
            $ref: '#/components/schemas/SubtopicInsight'
          AUDIENCE_INSIGHT:
            $ref: '#/components/schemas/AudienceInsight'
          OBJECTIVE_INSIGHT:
            $ref: '#/components/schemas/ObjectiveInsight'
          CONTENT_TYPE_INSIGHT:
            $ref: '#/components/schemas/ContentTypeInsight'
          CONTENT_LENGTH_INSIGHT:
            $ref: '#/components/schemas/ContentLengthInsight'
          HTML_TITLE_COMMON:
            $ref: '#/components/schemas/HtmlKeywordSerpInsight'
          HTML_META_DESCRIPTION_COMMON:
            $ref: '#/components/schemas/HtmlKeywordSerpInsight'
          HTML_HEADING1_COMMON:
            $ref: '#/components/schemas/HtmlKeywordSerpInsight'
          HTML_HEADING2_COMMON:
            $ref: '#/components/schemas/HtmlKeywordSerpInsight'
          HTML_HEADING3_COMMON:
            $ref: '#/components/schemas/HtmlKeywordSerpInsight'
          BODY_CONTENT_COMMON:
            $ref: '#/components/schemas/HtmlKeywordSerpInsight'
      properties:
        type:
          $ref: '#/components/schemas/InsightType'
        errorCode:
          type: string
          nullable: true
        errorMessage:
          type: string
          nullable: true
        status:
          $ref: '#/components/schemas/ItemStatus'
        summary:
          $ref: '#/components/schemas/InsightSummary'
          nullable: true
        insightPresent:
          type: boolean
        empty:
          type: boolean
        details:
          type: object
          description: Shape varies by insight type; see the concrete *Insight subtypes.
    Snippet:
      type: object
      required:
        - type
        - status
      discriminator:
        propertyName: type
        mapping:
          MSV_SNIPPET:
            $ref: '#/components/schemas/MsvSnippet'
          OPPORTUNITIES_SNIPPET:
            $ref: '#/components/schemas/OpportunitiesSnippet'
      properties:
        type:
          type: string
          enum:
            - MSV_SNIPPET
            - OPPORTUNITIES_SNIPPET
        status:
          $ref: '#/components/schemas/ItemStatus'
        creationTime:
          type: integer
          format: int64
          nullable: true
        errorCode:
          type: string
          nullable: true
        errorMessage:
          type: string
          nullable: true
        errorPhrases:
          type: array
          items:
            type: string
    ContentProfile:
      type: object
      required:
        - id
        - accountId
        - name
      properties:
        id:
          type: string
          format: uuid
        accountId:
          type: integer
        name:
          type: string
        description:
          type: string
          nullable: true
        voiceTone:
          type: string
          nullable: true
          description: Freeform voice-and-tone guidance applied to generation.
        audience:
          type: string
          nullable: true
          description: Freeform target-audience description.
        createdBy:
          type: integer
          description: User ID of the creator.
        created:
          type: string
          format: date-time
        updatedBy:
          type: integer
        updated:
          type: string
          format: date-time
        draftCount:
          type: integer
        languageRules:
          type: array
          items:
            $ref: '#/components/schemas/LanguageRule'
    ReferenceDocument:
      type: object
      required:
        - id
        - kind
        - status
      properties:
        id:
          type: string
          format: uuid
        kind:
          type: string
          enum:
            - TEXT
            - FILE
          description: >-
            TEXT for inline-supplied text (fileName null); FILE for an uploaded
            document (fileName populated).
        fileName:
          type: string
          nullable: true
          description: Original filename for FILE documents; null for TEXT.
        text:
          type: string
          nullable: true
          description: Extracted or supplied text content.
        status:
          type: string
          enum:
            - EXTRACTED
            - STORED
            - ERROR
        createdBy:
          $ref: '#/components/schemas/UserRef'
        created:
          type: integer
          format: int64
          description: Epoch seconds.
        account:
          $ref: '#/components/schemas/AccountRef'
    ContentAnalysisInsight:
      allOf:
        - $ref: '#/components/schemas/Insight'
        - type: object
          properties:
            details:
              type: object
              properties:
                keywords:
                  type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/KeywordItem'
                    maxOccurrence:
                      type: integer
                    presets:
                      type: array
                      items:
                        type: string
                serp:
                  type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          pageMeta:
                            $ref: '#/components/schemas/PageMeta'
                          keywords:
                            type: array
                            items:
                              type: object
                              properties:
                                keyword:
                                  type: string
                                frequency:
                                  type: integer
                                otherKeywords:
                                  type: array
                                  items:
                                    type: string
    PaaInsight:
      allOf:
        - $ref: '#/components/schemas/Insight'
        - type: object
          properties:
            details:
              type: object
              properties:
                paaQuestions:
                  type: array
                  items:
                    type: object
                    properties:
                      question:
                        type: string
                      response:
                        type: string
                        nullable: true
                      changeType:
                        $ref: '#/components/schemas/ChangeType'
                whyImportantMessage:
                  type: string
    ReadabilityInsight:
      allOf:
        - $ref: '#/components/schemas/Insight'
        - type: object
          properties:
            details:
              type: object
              properties:
                serp:
                  type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          pageMeta:
                            $ref: '#/components/schemas/PageMeta'
                          metricValue:
                            $ref: '#/components/schemas/ReadabilityMetric'
                    topPageMetricValue:
                      $ref: '#/components/schemas/ReadabilityMetric'
                    averageMetricValue:
                      $ref: '#/components/schemas/ReadabilityMetric'
                own:
                  type: object
                  nullable: true
                userDefinedTarget:
                  type: object
                  nullable: true
                whyImportantMessage:
                  type: string
    JourneyStageInsight:
      allOf:
        - $ref: '#/components/schemas/Insight'
        - type: object
          properties:
            details:
              type: object
              properties:
                journeyStage:
                  type: string
                journeyStages:
                  type: array
                  items:
                    type: string
    SubtopicInsight:
      allOf:
        - $ref: '#/components/schemas/Insight'
        - type: object
          properties:
            details:
              type: object
              properties:
                chatResponseId:
                  type: string
                subtopics:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                      changeType:
                        $ref: '#/components/schemas/ChangeType'
    AudienceInsight:
      allOf:
        - $ref: '#/components/schemas/Insight'
        - type: object
          properties:
            details:
              type: object
              properties:
                audience:
                  type: string
    ObjectiveInsight:
      allOf:
        - $ref: '#/components/schemas/Insight'
        - type: object
          properties:
            details:
              type: object
              properties:
                objective:
                  type: string
    ContentTypeInsight:
      allOf:
        - $ref: '#/components/schemas/Insight'
        - type: object
          properties:
            details:
              type: object
              properties:
                contentType:
                  type: string
                contentTypes:
                  type: array
                  items:
                    type: string
    ContentLengthInsight:
      allOf:
        - $ref: '#/components/schemas/Insight'
        - type: object
          properties:
            details:
              type: object
              properties:
                serp:
                  type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          pageMeta:
                            $ref: '#/components/schemas/PageMeta'
                          metricValue:
                            type: integer
                            description: Word count.
                    topPageMetricValue:
                      type: integer
                    averageMetricValue:
                      type: number
                whyImportantMessage:
                  type: string
                range:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                      value:
                        type: integer
    HtmlKeywordSerpInsight:
      allOf:
        - $ref: '#/components/schemas/Insight'
        - type: object
          properties:
            details:
              type: object
              description: >-
                Shared shape for HTML_TITLE_COMMON,
                HTML_META_DESCRIPTION_COMMON, HTML_HEADING1/2/3_COMMON, and
                BODY_CONTENT_COMMON.
              properties:
                keywords:
                  type: object
                  properties:
                    numOfSerps:
                      type: integer
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          keyword:
                            type: string
                          numOfOccurrence:
                            type: integer
                          ownMatched:
                            type: boolean
                          changeType:
                            $ref: '#/components/schemas/ChangeType'
                serp:
                  type: array
                  items:
                    $ref: '#/components/schemas/HtmlSerpPage'
    ItemStatus:
      type: string
      description: Processing status for an individual insight or snippet item.
      enum:
        - COMPLETED
        - COMPLETED_WITH_ERRORS
        - ERROR
    InsightSummary:
      type: object
      properties:
        note:
          type: string
          nullable: true
        text:
          type: string
          nullable: true
    MsvSnippet:
      allOf:
        - $ref: '#/components/schemas/Snippet'
        - type: object
          properties:
            details:
              type: object
              properties:
                rootKeyword:
                  type: string
                topicSearchVolume:
                  type: integer
                topicPhrase:
                  type: string
            phraseDetails:
              type: array
              items:
                $ref: '#/components/schemas/PhraseVolume'
    OpportunitiesSnippet:
      allOf:
        - $ref: '#/components/schemas/Snippet'
        - type: object
          properties:
            details:
              type: object
              properties:
                phrase:
                  type: string
                  nullable: true
                topUrls:
                  type: array
                  items:
                    $ref: '#/components/schemas/OpportunityRank'
                ownPage:
                  $ref: '#/components/schemas/OpportunityRank'
                  nullable: true
                  description: The account's own ranking page, or null when not ranking.
    LanguageRule:
      type: object
      required:
        - term
        - type
      properties:
        term:
          type: string
        type:
          type: string
          enum:
            - EXCLUDE
          description: The rule to apply to term.
        extraTerm:
          type: string
          nullable: true
          description: Reserved for future language-rule types.
    UserRef:
      type: object
      required:
        - id
      properties:
        id:
          type: integer
          description: User ID.
    AccountRef:
      type: object
      required:
        - id
      properties:
        id:
          type: integer
          description: Account ID.
    KeywordItem:
      type: object
      properties:
        keyword:
          type: string
        numOfOccurrence:
          type: integer
        avgFrequency:
          type: integer
        topPageFrequency:
          type: integer
          nullable: true
        ownFrequency:
          type: integer
          nullable: true
        presets:
          type: array
          items:
            type: string
            enum:
              - IMPORTANT
              - SUPPORTING
              - ADDITIONAL
        otherKeywords:
          type: array
          nullable: true
          items:
            type: string
        changeType:
          $ref: '#/components/schemas/ChangeType'
    PageMeta:
      type: object
      properties:
        rank:
          type: integer
        url:
          type: string
          format: uri
        favicon:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        collected:
          type: boolean
    ChangeType:
      type: string
      nullable: true
      description: User-applied change to an insight item. Null when untouched.
      enum:
        - USER_ADDED
        - HIDDEN
        - RESTORED
    ReadabilityMetric:
      type: object
      properties:
        score:
          type: number
        label:
          type: string
        description:
          type: string
        marker:
          type: string
          enum:
            - LOWER
            - EQUAL
            - HIGHER
    HtmlSerpPage:
      type: object
      properties:
        favicon:
          type: string
          nullable: true
        rank:
          type: integer
        url:
          type: string
          format: uri
        status:
          $ref: '#/components/schemas/PageStatus'
        title:
          $ref: '#/components/schemas/HtmlFeatureValue'
          nullable: true
        features:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/HtmlFeature'
    PhraseVolume:
      type: object
      properties:
        rootKeyword:
          type: string
        topicSearchVolume:
          type: integer
        topicPhrase:
          type: string
    OpportunityRank:
      type: object
      required:
        - rank
        - traffic
      properties:
        rank:
          type: integer
        traffic:
          type: integer
          description: Estimated monthly organic traffic for the page at this rank.
    PageStatus:
      type: string
      description: Collection status for an HTML SERP page.
      enum:
        - COLLECTED
        - ERROR
    HtmlFeatureValue:
      type: object
      properties:
        template:
          type: string
        xpath:
          type: string
        value:
          type: string
    HtmlFeature:
      type: object
      properties:
        type:
          type: string
          enum:
            - metaDescription
            - h1
            - h2
            - h3
            - title
        xpath:
          type: string
        innerText:
          $ref: '#/components/schemas/HtmlTemplatedString'
        attributes:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HtmlTemplatedString'
    HtmlTemplatedString:
      type: object
      properties:
        template:
          type: string
        value:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: apiKey
      description: API Key as a query parameter
    SigAuth:
      type: apiKey
      in: query
      name: sig
      description: >-
        Request signature computed using API key and secret. Valid for 5 minutes
        after creation.

````