Skip to main content

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.

The Share Of Model API exposes the same AI visibility and perception data available in the platform, so you can integrate it into your tools, dashboards and workflows. Rather than relying solely on the UI, the API lets you operationalise insights at scale, automate reporting, and connect AI signals to your internal analytics and activation systems.

​
Modules currently exposed

Search Visibility

AI-driven visibility signals across answer engines — how brands, products and categories surface in AI-generated answers, and which sources contribute to that visibility.

Brand Perception

How AI models describe and interpret a brand — attributes, narratives and associations inferred by AI systems.

​
Who the API is for

  • Product and data teams building internal dashboards.
  • Marketing and brand teams centralising AI signals in BI tools.
  • Technical teams integrating Share Of Model into proprietary platforms.

​
What you can do with the API

  • Access visibility and citation data across AI answer engines.
  • Retrieve brand-perception signals generated by AI models.
  • Extract insights at product and category level for reporting or analysis.
All responses are structured for programmatic consumption.

​
Prerequisites

Generate an API key with the appropriate access privileges before calling the API.

Creating and Managing API Keys

Step-by-step guide for user, workspace and organisation keys.
API keys are scoped to your workspace and must be treated as confidential credentials.

​
Making your first call

The API documentation is split between two distinct APIs. Switch between them using the dropdown in the docs site header:
  • Brand Analysis Module
  • Search Visibility Module

​
Authentication flow

1

Generate your API key

See Creating and Managing API Keys.
2

Exchange the key for a JWT

Use the API key to request a JWT token through the authentication endpoints.
3

Authenticate every request

Pass the JWT as a Bearer token in the Authorization header on every subsequent request.

​
First test call

A quick way to validate your setup is to call the endpoint that lists organisations you have access to. For other endpoints, follow the parameters described in the API Reference.

​
How the Search API works

The Search Visibility API is structured around Projects and Collects.

​
Projects

Projects can only be created through the UI. During setup you define:
  • a website,
  • a brand,
  • a locale (country and language),
  • a list of thematics and sub-topics,
  • a list of search queries (prompts) — each can include funnel stage, thematic, topic, persona and more,
  • a collection frequency (once, weekly, or monthly),
  • a list of LLM sources to monitor.

​
Collects

A collect is automatically created and associated with a project each time the platform gathers metrics.
FrequencyBehaviour
OnceOne collect total.
WeeklyOne collect per week.
MonthlyOne collect per month.
When a collect’s status is FINISHED, its ID can be used to retrieve metrics through the API.

​
Aggregations and evolutions

Most endpoints support aggregation and comparison across multiple collects.
  • Single-collect metrics — provide one ID in collect_ids.
  • Aggregated metrics — provide multiple IDs in collect_ids.
  • Evolution / comparison — provide one or more IDs in prev_collect_ids to compare against a previous set.
This structure supports performance snapshots, trends and evolutions over time.

​
Support

Our support team is available — reach out from the in-app chat for any API question.

​
What’s next

Quickstart

From zero to your first authenticated call in minutes.

MCP Server Setup

Connect AI assistants to your data.