> ## 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. # All Information Sources > Lists all information sources (URLs, domains, content) that AI models cite when discussing brands in a category. This endpoint returns the raw source data including URLs, domains, titles, and timestamps. See exactly which web pages, Reddit posts, YouTube videos, news articles, and reviews AI models reference. Essential for understanding the information landscape, identifying key content creators, and discovering what content influences AI recommendations. **When to use:** User wants to see all cited sources, needs source URLs, explores information landscape, identifies content creators, or investigates what content AI references. **Common user queries:** - "What sources does AI cite?" - "List all URLs referenced" - "Show me the information sources" - "Which content does AI use?" - "Get all cited web pages" - "Display source URLs" **Returns:** Array of source objects with URLs, domains, titles, and metadata. Example: [{"url": "https://reddit.com/r/running/post123", "domain": "reddit.com", "title": "Nike shoe review", "collection_date": "2024-01-15"}] 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 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: get: tags: - Metrics summary: All Information Sources description: >- Lists all information sources (URLs, domains, content) that AI models cite when discussing brands in a category. This endpoint returns the raw source data including URLs, domains, titles, and timestamps. See exactly which web pages, Reddit posts, YouTube videos, news articles, and reviews AI models reference. Essential for understanding the information landscape, identifying key content creators, and discovering what content influences AI recommendations. **When to use:** User wants to see all cited sources, needs source URLs, explores information landscape, identifies content creators, or investigates what content AI references. **Common user queries:** - "What sources does AI cite?" - "List all URLs referenced" - "Show me the information sources" - "Which content does AI use?" - "Get all cited web pages" - "Display source URLs" **Returns:** Array of source objects with URLs, domains, titles, and metadata. Example: [{"url": "https://reddit.com/r/running/post123", "domain": "reddit.com", "title": "Nike shoe review", "collection_date": "2024-01-15"}] Required permission: `read:analysis`. operationId: sources_list parameters: - in: path name: analysis_id schema: type: string format: uuid description: A UUID string identifying the analysis. required: true - in: query name: attribute schema: type: string description: Filter by one specific attribute. - in: query name: attribute__in schema: type: string description: >- Filter by a list of attributes. Values should be comma separated, without brackets or spaces - in: query name: collection_date schema: type: string format: date description: >- Filter by a collection date being equal to the specified date. YYYY-MM-DD format - in: query name: collection_date__gt schema: type: string format: date description: >- Filter by a collection date being greater than the specified date. YYYY-MM-DD format - in: query name: collection_date__gte schema: type: string format: date description: >- Filter by a collection date being greater than or equal the specified date. YYYY-MM-DD format - in: query name: collection_date__lt schema: type: string format: date description: >- Filter by a collection date being less than the specified date. YYYY-MM-DD format - in: query name: collection_date__lte schema: type: string format: date description: >- Filter by a collection date being less than or equal the specified date. YYYY-MM-DD format - in: query name: country schema: type: string description: Filter by one specific country. - in: query name: country__in schema: type: string description: >- Filter by a list of countries. Values should be comma separated, without brackets or spaces - in: query name: domain schema: type: string description: Filter by one specific domain. - in: query name: domain__in schema: type: string description: >- Filter by a list of domains. Values should be comma separated, without brackets or spaces - in: query name: format schema: type: string enum: - csv - json - in: query name: intention schema: type: string description: Filter by one specific intention. - in: query name: intention__in schema: type: string description: Filter by a list of intentions. Values should be comma separated - in: query name: limit schema: type: integer description: Limit number of results. - in: path name: organization_id schema: type: string format: uuid description: A UUID string identifying the organization. required: true - in: query name: source schema: type: string enum: - claude-3-5-sonnet - claude-4-5-sonnet - claude-4-6-sonnet - claude-4-sonnet - deepseek-chat - deepseek-reasoner - deepseek-v3.2-maas - gemini-1.5-pro - gemini-2.0-flash - gemini-2.5-flash - gemini-2.5-flash-grounded - gemini-2.5-flash-lite - gemini-3-flash-preview - google-ai-mode - gpt-3.5-turbo - gpt-4-turbo - gpt-4o - gpt-4o-mini-search - gpt-5 - gpt-5.2 - gpt-5.4-mini - meta-llama-3.1-70B-instruct-turbo - meta-llama-3.2-70B-instruct-turbo - meta-llama-3.3-70B-instruct-turbo - meta-llama-4-maverick - mistral-7B-instruct - perplexity-sonar - rufus description: Filter by one specific source. - in: query name: source__in schema: type: string enum: - claude-3-5-sonnet - claude-4-5-sonnet - claude-4-6-sonnet - claude-4-sonnet - deepseek-chat - deepseek-reasoner - deepseek-v3.2-maas - gemini-1.5-pro - gemini-2.0-flash - gemini-2.5-flash - gemini-2.5-flash-grounded - gemini-2.5-flash-lite - gemini-3-flash-preview - google-ai-mode - gpt-3.5-turbo - gpt-4-turbo - gpt-4o - gpt-4o-mini-search - gpt-5 - gpt-5.2 - gpt-5.4-mini - meta-llama-3.1-70B-instruct-turbo - meta-llama-3.2-70B-instruct-turbo - meta-llama-3.3-70B-instruct-turbo - meta-llama-4-maverick - mistral-7B-instruct - perplexity-sonar - rufus description: >- Filter by a list of sources. Values should be comma separated, without brackets or spaces - in: query name: type schema: type: string enum: - Branded Website - Community Help Center - Comparison Site - Government/Academic - Influencer/Creator Blog - News Media - Product Review Site - Q&A/Forum - Retail/E-Commerce - Specialist Blog - Wiki/Encyclopedia description: Filter by one specific type of source. - in: query name: type__in schema: type: string enum: - Branded Website - Community Help Center - Comparison Site - Government/Academic - Influencer/Creator Blog - News Media - Product Review Site - Q&A/Forum - Retail/E-Commerce - Specialist Blog - Wiki/Encyclopedia description: >- Filter by a list of types of sources. Values should be comma separated, without brackets or spaces - 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/Sources' text/csv: schema: type: array items: $ref: '#/components/schemas/Sources' description: '' security: - Bearer: [] components: schemas: Sources: type: object properties: id: type: integer readOnly: true type: type: string nullable: true analysis_id: type: string format: uuid workspace_id: type: string format: uuid response_id: type: string format: uuid position: type: integer maximum: 127 minimum: -128 collection_date: type: string format: date country: type: string nullable: true attribute: type: string nullable: true source: enum: - gpt-3.5-turbo - gpt-4-turbo - gpt-4o - gpt-4o-mini-search - gpt-5 - gpt-5.2 - gpt-5.4-mini - gemini-1.5-pro - gemini-2.0-flash - gemini-2.5-flash-grounded - gemini-2.5-flash - gemini-2.5-flash-lite - gemini-3-flash-preview - meta-llama-3.1-70B-instruct-turbo - meta-llama-3.2-70B-instruct-turbo - meta-llama-3.3-70B-instruct-turbo - meta-llama-4-maverick - mistral-7B-instruct - claude-3-5-sonnet - claude-4-sonnet - claude-4-5-sonnet - claude-4-6-sonnet - deepseek-chat - deepseek-reasoner - deepseek-v3.2-maas - perplexity-sonar - rufus - google-ai-mode type: string description: >- * `gpt-3.5-turbo` - gpt 3.5 turbo * `gpt-4-turbo` - gpt 4 turbo * `gpt-4o` - gpt 4o * `gpt-4o-mini-search` - gpt 4o mini search * `gpt-5` - gpt 5 * `gpt-5.2` - gpt 5.2 * `gpt-5.4-mini` - gpt 5.4 mini * `gemini-1.5-pro` - gemini 1.5 pro * `gemini-2.0-flash` - gemini 2.0 flash * `gemini-2.5-flash-grounded` - gemini 2.5 flash grounded * `gemini-2.5-flash` - gemini 2.5 flash * `gemini-2.5-flash-lite` - gemini 2.5 flash lite * `gemini-3-flash-preview` - gemini 3 flash preview * `meta-llama-3.1-70B-instruct-turbo` - meta llama 3.1 70B instruct turbo * `meta-llama-3.2-70B-instruct-turbo` - meta llama 3.2 70B instruct turbo * `meta-llama-3.3-70B-instruct-turbo` - meta llama 3.3 70B instruct turbo * `meta-llama-4-maverick` - meta llama 4 maverick * `mistral-7B-instruct` - mistral 7B instruct * `claude-3-5-sonnet` - claude 3 5 sonnet * `claude-4-sonnet` - claude 4 sonnet * `claude-4-5-sonnet` - claude 4 5 sonnet * `claude-4-6-sonnet` - claude 4 6 sonnet * `deepseek-chat` - deepseek chat * `deepseek-reasoner` - deepseek reasoner * `deepseek-v3.2-maas` - deepseek v3.2 maas * `perplexity-sonar` - perplexity sonar * `rufus` - rufus * `google-ai-mode` - google ai mode x-spec-enum-id: 31229724ccbe9afa domain: type: string url: type: string intention: enum: - Product Purchase - Information Request - Media Retrieval type: string description: |- * `Product Purchase` - Product Purchase * `Information Request` - Information Request * `Media Retrieval` - Media Retrieval x-spec-enum-id: d4c26cc35aed8548 required: - analysis_id - collection_date - domain - id - position - response_id - source - url - workspace_id securitySchemes: Bearer: type: apiKey in: header name: Authorization ````