Do you provide an API for OtterlyAI?

Yes, we do. The OtterlyAI API lets you access your AI search visibility data programmatically, without logging into the dashboard. Pull brand mentions, domain citations, prompt monitoring results, share of voice, and more directly into your own tools, dashboards, or workflows.

📖 Read the full API introduction on our blog (with video illustration)

What can you do with the API?

Here are the most common use cases:

Pull brand visibility data into your own dashboards Feed OtterlyAI data directly into Looker Studio, Tableau, Power BI, or any BI tool, without manual exports.
Automate client reporting Build automated weekly or monthly reports for clients using live data from OtterlyAI, without touching the platform manually.
Integrate with your data stack Push AI search visibility data into your data warehouse (BigQuery, Snowflake, etc.) alongside your other marketing and analytics data.
Trigger alerts and workflows Connect OtterlyAI data to tools like Zapier, Make, or Slack to get notified automatically when brand coverage drops or a competitor surges.

What data can you access via the API?

The OtterlyAI API provides access to the core data types available in your dashboard, including:

✅ Brand mentions: per prompt, per engine, per time period
✅ Brand coverage: across your tracked prompt set
✅ Domain citations: which URLs are being referenced and by which engine
✅ Share of Voice: your brand vs. competitors
✅ Brand sentiment: positive, neutral, or negative tone per prompt
✅ Prompt-level results: data for each tracked prompt and engine

📄 Full endpoint reference, request formats, and response examples are available in the API Documentation →

How to get your API key?

Your API key is available directly in your OtterlyAI account:

Log in to your OtterlyAI account
Go to Admin → API Keys
Create a new API key, name it, choose a workspace and assign the appropriate access level (read/read&write)
Copy it immediately, you will only see your API key once
Use it to authenticate your API requests

⚠️ Keep your API key private. Do not share it publicly or commit it to version control. If a key is ever compromised, revoke it immediately from the same page and generate a new one.

API key permissions and access level

Only Admins can create, revoke, rotate, and manage API keys.

When creating a key, Admins choose one of two permission levels:

Read-only The key can retrieve data from OtterlyAI, pulling reports, brand mention results, citations, and visibility metrics, but cannot make any changes to your account.

Read and write The key can both retrieve data and make changes. Write access currently only allows you to create and run GEO Audits (Crawlability checks and Content checks) on demand.

Pricing and API access

API access is available on Standard, Premium, and Custom plans.

Plan	Monthly API requests
Standard	2,000 requests/month
Premium	5,000 requests/month

👉 See full pricing and plan details

How to set up Claude skill once I have my API key?

The OtterlyAI Claude skill is designed for Claude. Instead of configuring a server, you install a .skill file once and OtterlyAI data is available in every Claude session automatically.

Installation

Download the otterly.skill file
Open Claude
Go to Customize → Skills → + → Create Skill → Upload Skill and select the file
Go to Claude Settings → Capabilities and add data.otterly.ai to the domain allowlist (⚠️ Please make sure data.otterly.ai is allowed in your settings. Follow the instructions here.)

For full setup instructions including API key configuration, see the official Claude skill documentation →

Alternatively, you can check the walkthrough video on how to set it up.

Frequently asked questions

Is the API available during the trial period? Yes, API access is available to trial users as well. You can generate a key and start testing straight away.

Can I purchase more API requests on top of my plan? Not currently. If you need more API requests, upgrade to a higher plan. You can compare limits on the pricing page.

What if I forget or lose my API key? No problem. Go to Admin → API Keys and either rotate your existing key to generate a new one, or revoke it and create a fresh key. Just remember, you'll only see the key once when it's created, so make sure to copy it and store it somewhere secure straight away.

Why can't I see the API Keys section? API key management is only available to Admins. If you're a workspace Member, you won't see this option. Reach out to your account Admin to get a key issued for you.

Where can I check my API usage and how many requests I have left? Go to Admin → API Keys and look at the Usage section. You'll see your current consumption and remaining requests for the billing period. You can also see your usage in the Billing tab under Plan usage.

Where can I find prompt ID? First fetch List prompts for a brand report and you'll have prompts ID there.

Where can I find brand report ID? You'll see the ID in the URL once you are on the brand report page. Example: https://app.otterly.ai/ws/workspaceID/reports/reportID

Is the MCP server available? Yes, you can find more information and setup steps in the documentation.

Where can I find the full API reference? All available endpoints, request formats, parameters, and response schemas are documented here: docs.otterly.ai/api-reference

Where can I find OtterlyAI Marketplace? You can access it via this direct link https://otterly.ai/marketplace/

If you run into any issues, reach out at hello@otterly.ai — we're happy to help. 🦦