AtlasSERP
Sign in

AtlasSERP API Documentation

The high-speed, cost-effective Google SERP API designed for AI agents, LLMs, and SEO workflows. 100% compatible with Serper.dev payloads.

Base URL

All API requests must be made over HTTPS to the following root domain:

https://atlasserp.com

Authentication

AtlasSERP authenticates all API requests using an API Key. Include your key in the X-API-KEY HTTP header. 

X-API-KEY: your_api_key_here

Don't have an API key yet? Create an account to receive 2,500 free queries immediately.

Quickstart Examples

Query Google Search using your preferred language:

Python

import requests
import json

url = "https://atlasserp.com/search"

payload = json.dumps({
  "q": "best coffee beans",
  "gl": "us",
  "hl": "en",
  "num": 10
})

headers = {
  "X-API-KEY": "YOUR_API_KEY",
  "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, data=payload)
print(response.json())

Node.js / JavaScript

const axios = require('axios');

async function searchGoogle() {
  const res = await axios.post('https://atlasserp.com/search', {
    q: 'best coffee beans',
    gl: 'us',
    hl: 'en',
    num: 10
  }, {
    headers: {
      'X-API-KEY': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  });

  console.log(res.data);
}

searchGoogle();

cURL

curl -X POST "https://atlasserp.com/search" \
     -H "X-API-KEY: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"q": "best coffee beans", "gl": "us", "hl": "en"}'

Request Parameters

Field Type Required Description
q string Required The query string you wish to search for on Google.
gl string Optional Two-letter country code for geographical localization (e.g. us, uk, fr, ma). Default: us.
hl string Optional Two-letter language code for interface results (e.g. en, fr, es, ar). Default: en.
page number Optional Result page number to retrieve. Default: 1.
num number Optional Number of organic results to return (10 to 100). Default: 10.

Response Structure

All endpoints return clean, structured JSON matching Serper.dev schemas:

{
  "searchParameters": {
    "q": "best coffee beans",
    "gl": "us",
    "hl": "en",
    "num": 10,
    "type": "search"
  },
  "organic": [
    {
      "title": "The 12 Best Coffee Beans of 2026, Tested and Reviewed",
      "link": "https://www.thespruceeats.com/best-coffee-beans-...",
      "snippet": "We tested dozens of coffee beans from top roasters to find the best light, medium, and dark roast picks.",
      "position": 1
    },
    {
      "title": "Best Coffee Beans 2026: Top Roasts for Every Palate",
      "link": "https://www.seriouseats.com/best-coffee-beans-...",
      "snippet": "Our expert team sampled fresh roasts from across the globe. Here are the standout beans.",
      "position": 2
    }
  ],
  "credits": 1
}

HTTP Status Codes

Code Status Description
200 OK Success Request was successful, results returned in response body.
400 Bad Request Validation Error Missing required parameters (e.g. q query field).
401 Unauthorized Invalid API Key Missing or invalid X-API-KEY header.
402 Payment Required Insufficient Credits Your account has depleted its query quota. Top up via dashboard.
429 Too Many Requests Rate Limited Request concurrency limit exceeded. Please back off and retry.

Start querying in under 2 minutes

Get 2,500 free queries instantly with no credit card required.