Search Atlas Help Center

🔌 Search Atlas API authentication and endpoint configuration for Google Apps Script

Open in
View as Markdown Open in ChatGPT Open in Claude
Camilo Aponte

Camilo Aponte

Last updated on Sep 30, 2026

Overview

You can connect Google Apps Script to Search Atlas by making authenticated HTTP requests to the Search Atlas API. This requires your API key and the correct endpoint URL.

Step 1: Locate your Search Atlas API key

  1. Log in to your Search Atlas account.
  2. Navigate to your account settings or profile area to find your API key.
  3. Copy the API key — you will use this to authenticate all requests.

Step 2: Configure authentication in Google Apps Script

Search Atlas uses API key-based authentication. In your Google Apps Script project, pass your API key as a header in each request:

  • Header name: X-API-KEY
  • Header value: YOUR_API_KEY (the key itself, with no "Bearer" prefix)

Example setup in Google Apps Script:

  1. Open your Google Apps Script project at script.google.com.
  2. Use the UrlFetchApp.fetch() method to make HTTP requests.
  3. Set the headers option to include your X-API-KEY header with your API key.
  4. Set the method option to match the required HTTP method for your endpoint (e.g., GET or POST).

Step 3: Use the correct API endpoint

Use the base API URL provided in your Search Atlas account documentation or onboarding materials. Append the specific endpoint path for the data or action you need (for example, keyword data, project data, or backlink data).

Troubleshooting common issues

  • 401 Unauthorized: Double-check that your API key is correct and that it is sent in the X-API-KEY header with no "Bearer" prefix and no extra spaces.
  • 403 Forbidden: Most often the API key was missing, invalid, or revoked. Check that the key is sent in the X-API-KEY header (not as a Bearer token), that you copied the full key, and that it has not been regenerated or revoked in Settings → API Keys. If the response is a Cloudflare error page (for example Error 1010), the request was blocked by our security layer before reaching Search Atlas — contact support with the Cloudflare Ray ID, the time of the request, and the endpoint you called. Your plan does not cause this error.
  • Endpoint not found: Verify the endpoint path matches what is documented in your Search Atlas account — check for typos or version mismatches in the URL.

When to contact support

If you are unable to resolve your authentication or endpoint issue, please have the following ready before reaching out: your project name, the exact error message returned by the API, the endpoint URL you are calling, and a timestamp of when the error occurred.

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.