Managing your API keys

Connect your systems to SERP360 and pull data directly into your reports, dashboards, or workflows.

What is an API key?

An API key is a unique code that identifies your account when external systems request data from SERP360. Think of it as a password that lets your tools talk to ours securely.

You'll need an API key if you want to export SERP rankings, AI visibility data, or conversion attribution into your own reporting tools.

Create your first API key

Follow these steps to generate a new key:

1. Go to Settings > API Access in your SERP360 dashboard.
2. Click Generate New Key.
3. Enter a friendly name (e.g. "Looker Studio" or "Internal Dashboard"). This helps you remember what each key is for.
4. Click Generate Key.
5. Copy the key immediately and store it somewhere safe. You won't see it again.

Important: For security, we only show your full API key once. If you lose it, delete the key and create a new one.

Find your Workspace ID

Every API request requires a workspace ID. This tells the API which workspace's data you want to access.

Workspace IDs can be found in the table in the API Key page:

Copy the workspace ID (e.g. ws_d04ae5a1f833 ) for the workspace you want to query.

Each workspace has its own ID. If you have multiple workspaces, make sure you're using the correct one for your request.

How the API works

The API uses a simple two-step flow:

1. Register your request – Call the endpoint with a pingback URL. If data exists, you're notified immediately. If not, we'll notify you when it's ready.
2. Retrieve your data – Once notified, call the endpoint again without the pingback URL to get your data.

Credits are only charged when you retrieve data, not when you register a request.

Tip: If you're calling the API after your daily data collection has run, you'll usually be notified immediately—no waiting required.

Manage your keys

The API Access page shows all your active keys. You'll see:

• Name – the friendly name you gave it
• Key preview – the first few characters (e.g. sk_live_abc... )
• Created – when the key was generated
• Last used – when the key was last used to fetch data

Delete a key

If a key is compromised or no longer needed, delete it straight away.

1. Find the key in your list.
2. Click Delete.
3. Confirm when prompted.

Any system using that key will stop working immediately. Generate a new key and update your integration.

Best practices

• Use separate keys for each integration – if one is compromised, you only revoke that one.
• Never share keys in emails or chat – use a password manager or secure vault.
• Rotate keys periodically – delete old keys and create fresh ones every few months.
• Check "Last used" regularly – if a key hasn't been used in months, consider deleting it.

How credits work

API requests use the same credits as your regular SERP360 usage. There's no separate API quota.

Credits are only charged when you successfully retrieve data – not when you register a request or get an error.

Need help?

If you're stuck or have questions about connecting your systems:

• Check the Quick Start and endpoint documentation on the API Access page
• Contact support at help@serp360.ai