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

# Domain Influence Trends Over Time

> Compares domain influence scores between two time periods,
        showing which sources are gaining or losing impact with AI models.

This endpoint calculates influence score changes between a current and comparison week,
revealing trends like Reddit growing from 0.75 to 0.88 (+17%) or a news site declining from 0.60 to 0.45 (-25%). Essential for tracking source momentum, identifying rising platforms, and detecting influence shifts in the information landscape.

**When to use:** User wants to track influence changes, identify trending sources, measure source momentum, compare time periods, or detect emerging/declining platforms.

**Common user queries:**
- "Which sources are growing in influence?"
- "Show influence trends over time"
- "Has Reddit's impact increased?"
- "Compare source influence week over week"
- "Which platforms are gaining traction?"
- "Track influence evolution"

**Returns:** Array of domains with current and comparison influence scores plus change metrics.
Example: [{"domain": "reddit.com", "current_score": 0.88, "previous_score": 0.75, "change": 0.13,
"change_percent": 17.3}]

Required permission: `read:analysis`.



## OpenAPI

````yaml https://openapi.shareofmodel.ai/swagger.json get /v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/sources/influence_score_evolution_by_domain
openapi: 3.0.3
info:
  title: Share Of Model API
  version: v1
  description: >-
    ## Model Context Protocol (MCP)


    In addition to this REST API, Share of Model exposes a **Model Context
    Protocol** server that lets AI assistants (Claude Desktop, Claude Code, MCP
    Inspector, custom agents…) call our endpoints directly as tools. Any
    MCP-compatible client can interact with Share of Model without writing
    custom integration code — connect once with your usual login and start
    asking the assistant to query the data for you.


    ### Connecting from Claude Desktop


    Open **Settings → Connectors**, scroll to the bottom and click **Add custom
    connector**, then paste `https://mcp.shareofmodel.ai/mcp/`. A browser window
    opens for you to log in with your Share of Model account (same login as the
    web app), and the assistant gains access to the tools.


    ### Connecting from Claude Code


    ```bash

    claude mcp add --transport http share-of-model
    https://mcp.shareofmodel.ai/mcp/

    ```


    The first time you call a tool, Claude Code opens your browser to complete
    the login.


    ### Connecting from MCP Inspector


    ```bash

    npx @modelcontextprotocol/inspector

    ```


    In the Inspector UI, pick **Streamable HTTP** as transport, paste
    `https://mcp.shareofmodel.ai/mcp/`, and click **Connect**. The first
    connection prompts you to log in.


    ### Available tools


    Only endpoints tagged `mcp` in this OpenAPI spec are exposed as MCP tools,
    and only read-only (`GET`) routes are exposed. Everything tagged `mcp` below
    is callable from any compliant MCP client.


    ### Example prompts


    Once connected, try asking your assistant things like:


    - _"List the workspaces I have access to."_

    - _"Show me the latest searches in workspace X."_

    - _"Compare the share of model between brand A and brand B over the last 30
    days."_


    For more details on the protocol itself, see the [Model Context Protocol
    specification](https://modelcontextprotocol.io/).
servers:
  - description: Production API
    url: https://api.shareofmodel.ai/
  - description: Development API
    url: https://api.dev.shareofmodel.ai/
security: []
tags:
  - name: Auth
    description: Endpoints needed for API authentication.
  - name: Organizations
    description: Endpoints related to organizations, to list all available organizations.
  - name: Workspaces
    description: Endpoints related to workspaces, to list all available workspaces.
  - name: Analyses
    description: Endpoints related to analyses and analyses management.
  - name: Asset Evaluations
    description: Endpoints related to assets and asset evaluations.
  - name: Brand Catalog
    description: Endpoints related to general brand information.
  - name: Content Briefs
    description: Endpoints related to content briefs generation and optimisation.
  - name: Metrics
    description: >+
      Endpoints related to brand metrics.


      **LEXICON**



      **Brand Awareness**: What opinion the LLMs have concerning specific
      brands, related to certain categories.



      **Brand Perception**: The general sentiment of the LLMs towards a brand,

      based on the pros and cons they mention.

paths:
  /v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/sources/influence_score_evolution_by_domain:
    get:
      tags:
        - Metrics
      summary: Domain Influence Trends Over Time
      description: >-
        Compares domain influence scores between two time periods,
                showing which sources are gaining or losing impact with AI models.

        This endpoint calculates influence score changes between a current and
        comparison week,

        revealing trends like Reddit growing from 0.75 to 0.88 (+17%) or a news
        site declining from 0.60 to 0.45 (-25%). Essential for tracking source
        momentum, identifying rising platforms, and detecting influence shifts
        in the information landscape.


        **When to use:** User wants to track influence changes, identify
        trending sources, measure source momentum, compare time periods, or
        detect emerging/declining platforms.


        **Common user queries:**

        - "Which sources are growing in influence?"

        - "Show influence trends over time"

        - "Has Reddit's impact increased?"

        - "Compare source influence week over week"

        - "Which platforms are gaining traction?"

        - "Track influence evolution"


        **Returns:** Array of domains with current and comparison influence
        scores plus change metrics.

        Example: [{"domain": "reddit.com", "current_score": 0.88,
        "previous_score": 0.75, "change": 0.13,

        "change_percent": 17.3}]


        Required permission: `read:analysis`.
      operationId: sources_influence_score_evolution_by_domain
      parameters:
        - in: path
          name: analysis_id
          schema:
            type: string
            format: uuid
          description: A UUID string identifying the analysis.
          required: true
        - in: query
          name: comparison_week_start_date
          schema:
            type: string
            format: date
          description: >-
            Comparison week start date (YYYY-MM-DD). Must be in the past of
            current_week_start_date.
          required: true
        - in: query
          name: current_week_start_date
          schema:
            type: string
            format: date
          description: Current week start date (YYYY-MM-DD).
          required: true
        - in: query
          name: format
          schema:
            type: string
            enum:
              - csv
              - json
        - in: path
          name: organization_id
          schema:
            type: string
            format: uuid
          description: A UUID string identifying the organization.
          required: true
        - in: path
          name: workspace_id
          schema:
            type: string
            format: uuid
          description: A UUID string identifying the workspace.
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SourcesInfluenceScoreEvolutionByDomain'
            text/csv:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SourcesInfluenceScoreEvolutionByDomain'
          description: ''
      security:
        - Bearer: []
components:
  schemas:
    SourcesInfluenceScoreEvolutionByDomain:
      type: object
      description: Base class with necessary methods overridden
      properties:
        domain:
          type: string
        difference:
          type: string
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
        current_week_score:
          type: string
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
        previous_week_score:
          type: string
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
      required:
        - current_week_score
        - difference
        - domain
        - previous_week_score
  securitySchemes:
    Bearer:
      type: apiKey
      in: header
      name: Authorization

````