Skip to main content
GET
/
brand-mentions-summary
Top topics where your own brand was mentioned, with the URLs cited
curl --request GET \
  --url https://openlens.com/api/brand-mentions-summary \
  --header 'Authorization: Bearer <token>'
[
  {
    "topicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "topicName": "<string>",
    "count": 123,
    "platforms": [
      "<string>"
    ],
    "urls": [
      {
        "url": "<string>",
        "domain": "<string>",
        "count": 123,
        "title": "<string>"
      }
    ],
    "bestPosition": 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.

​
limit
integer
default:20
Required range: 1 <= x <= 200
​
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

​
topicId
string<uuid>
required
​
topicName
string
required
​
count
integer
required
​
platforms
string[]
required
​
urls
object[]
required
​
bestPosition
integer | null
​
dominantSentiment
enum<string> | null
Available options:
positive,
neutral,
negative