Explore SE Ranking Tool Solutions

Reporting & integrations

SE Visible API overview

The SE Visible API lets you pull your AI visibility data into your own tools, like dashboards, spreadsheets, BI reports, or internal apps. You can also create and manage projects without opening SE Visible.

This article explains what the API can do, how to get your API key, and where to find the full documentation.

What you can do with the API

The API gives you the same data you see in SE Visible for ChatGPT, Google Gemini, Google AI Mode, and Google AI Overview. You can work with:

  • Projects — list, create, view, and delete projects.
  • Brands — your brand and competitors, their aliases, and metrics like visibility score, share of voice, sentiment, and position.
  • Topics and prompts — add, rename, move, and delete them, and get the AI answers for each prompt with brand mentions and sentiment.
  • Citations — the websites and pages AI engines cite in their answers.
  • Subscription — how many projects and prompts you've used and have left.
Changes made through the API are real. Creating, editing, or deleting projects, brands, topics, or prompts changes your data in SE Visible and counts toward your plan limits — the same as doing it in the app.

Create an API key

Your API key is like a password: it tells SE Visible that the request comes from you. To create one:

1
Open the API Dashboard. In the left menu, go to Reporting → API Dashboard.
2
Click Create API key in the top-right corner.
3
Name your key. Use the name of the tool or task it's for, for example Looker Studio or Weekly report. Then click Create key.
4
Copy the key. Click the key in the table to copy it, then paste it into the tool you're connecting.
se_visible_api_dashboard_annotated_v2.pngse_visible_create_api_key_annotated_v2.pngse_visible_click_key_to_copy.png

Manage your API keys

The API keys table shows each key's name, the key itself, when it was last used, and when it was created. Click ⋯ next to a key to:

  • Copy — copy the key to paste it into another tool.
  • Regenerate — replace the key with a new one. Do this if you think the key was shared by mistake. The old key stops working right away, so update it in every tool that uses it.
  • Delete — remove the key for good. Any tool that uses it will stop getting data.
se_visible_copy_api_key_annotated.png
What is the gray agents-integration key? SE Visible creates it automatically so Agents can read your data. You can't regenerate or delete it, and it counts toward your limit of 10 keys.

Try the API in Postman

You don't need to write code to try the API. The easiest way to start is our ready-made Postman collection. You'll need a free Postman account.

1
Open the collection. In the API Dashboard, click Postman workspace under Quick links.
2
Make your own copy. Click Use, select Fork, and click Use Collection.
3
Add your key. In your copy, open the Variables tab and paste your API key into secret_key.
4
Send a request. In the left panel, open a GET request, such as List projects, and click Send.
postman_fork_collection_annotated.pngpostman_fork_secret_key_annotated.png
Are you a developer? You'll find the base URL, authentication details, and request examples in the API documentation.

Limits and errors

API requests don't use credits. What you can do through the API depends on your plan limits for projects and prompts — the same limits as in the app. To see how much you've used, run the Get subscription request.

There's also a limit on how many requests you can send per second. If you send too many, you'll get a 429 error — wait a moment and try again. See Rate limits for details.

Common errors and how to fix them:

  • 401 Unauthenticated — the key is missing, mistyped, deleted, or regenerated. Copy it again from the API Dashboard.
  • 403 Unauthorized — your plan doesn't allow this action. Check your plan in Settings → Subscription.
  • 404 Not found — the project, brand, topic, or prompt doesn't exist or was deleted.
  • 422 Validation error — a setting in the request is missing or wrong, for example the dates. The response tells you which one.

Documentation and tools

You'll find these links under Quick links in the API Dashboard:

se_visible_quick_links_annotated.png

New to SE Visible? Start with Get Started with SE Visible. Have a question about the API? Contact our support team.