Skip to main content
GET
/
visibility
/
trends
Time-series visibility for a brand or all competitors
curl --request GET \
  --url https://openlens.com/api/visibility/trends \
  --header 'Authorization: Bearer <token>'
{
  "series": [
    {
      "date": "2023-12-25",
      "visibilityScore": 123,
      "avgPosition": 123,
      "mentionCount": 123,
      "citationCount": 123,
      "shareOfVoice": 123,
      "sentimentScore": 123
    }
  ],
  "summary": {
    "currentScore": 123,
    "previousScore": 123,
    "changePercent": 123
  },
  "competitorSeries": [
    {
      "brandId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "brandName": "<string>",
      "series": [
        {
          "date": "2023-12-25",
          "visibilityScore": 123,
          "avgPosition": 123,
          "mentionCount": 123,
          "citationCount": 123,
          "shareOfVoice": 123,
          "sentimentScore": 123
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.openlens.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Clerk API key. Create one from your account settings under API Keys.

Query Parameters

projectId
string<uuid>
required

Project id. Required on all data endpoints.

brandId
string<uuid>
topicId
string<uuid>
platform
enum<string>

LLM platform identifier. Newer scraper-backed ids end in _app; chatgpt, perplexity, and gemini are legacy and not returned by current runs.

Available options:
chatgpt,
chatgpt_app,
claude,
gemini,
gemini_app,
grok_app,
perplexity,
perplexity_app,
google_app,
deepseek
compare
boolean
default:false

When true, include competitorSeries for every non-own brand in the project.

days
integer
default:30
Required range: 1 <= x <= 90
promptAttributes
string

Comma-separated list of attribute filters. Accepts both built-in attributes (e.g. pricing, comparisons) and project-specific custom attributes.

Response

Successful response

series
object[]
required
summary
object
required
competitorSeries
object[]