The Search Atlas API lets you pull audit data programmatically using an MCP (Machine Client Protocol) token. This article explains how to locate your MCP token and where to find the official endpoint mapping for audit data categories such as Holistic SEO Pillars, AI Search Visibility, keywords, geo-distribution, and SERP features.
Before calling any endpoint, you need a valid MCP token tied to your Search Atlas account.
Log in to your Search Atlas account.
Navigate to your account settings area, where API credentials and integrations are managed.
Locate the section for API token generation and copy your MCP token from there.
Store the token securely (for example, as an environment variable), as it is a sensitive credential.
Your token must be included in every API request as a Bearer token in the Authorization header:
Authorization: Bearer <your_mcp_token>
If you cannot locate the token generation option in your account, or if your account does not yet have API access enabled, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with our team for assistance.
The specific endpoint paths and response field names for each audit data category (including Holistic SEO Pillars, AI Search Visibility, keyword data, geo-distribution, and SERP features) are documented in your account's official API reference. To access the correct and up-to-date mapping:
Log in to your Search Atlas account and look for an API Documentation or Developer Reference section within the platform.
Each audit category will have its own dedicated endpoint entry listing the path, required parameters (such as your project ID), and all available response fields.
Use your project ID (visible in the URL or project settings when a project is open) as the identifier when constructing API requests for a specific audit.
If the API documentation section is not visible in your account, your plan may not include API access, or it may need to be enabled β open the chat widget in the bottom-right corner of the platform and type human teammate to confirm your access level with our team.
If you are experiencing an issue with API access or endpoint mapping, please have the following ready when contacting support:
Your Search Atlas account email or username
The name of the project you are trying to pull audit data for
The exact error message or response you are receiving (including any HTTP status codes)
The audit data category you are trying to access (e.g., Holistic SEO, AI Search Visibility)
If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.