API Reference

Authentifizierung

Alle API-Requests erfordern einen API-Key im Header.

API-Key erstellen

1. Gehe zu "Einstellungen" → "API"
2. Klick auf "Neuen API-Key erstellen"
3. Name eingeben (zur Identifikation)
4. Key wird einmalig angezeigt – sicher speichern!

Header

Authorization: Bearer YOUR_API_KEY

Base URL

https://api.search-console.pro/v1

Endpoints

Properties

Performance-Daten

SCI Index

URL-Inspektion

Reports

Rate Limits

Um faire Nutzung zu gewährleisten, gelten folgende Limits:

Rate Limit Headers

Jede Response enthält:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 950
X-RateLimit-Reset: 1704067200

Bei Überschreitung

Status 429 Too Many Requests mit Retry-After Header.

Code-Beispiele

cURL

curl -X GET "https://api.search-console.pro/v1/properties" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import requests

API_KEY = "your_api_key"
BASE_URL = "https://api.search-console.pro/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}"
}

# Properties abrufen
response = requests.get(f"{BASE_URL}/properties", headers=headers)
properties = response.json()

# Performance-Daten
property_id = properties[0]["id"]
params = {
    "start_date": "2026-01-01",
    "end_date": "2026-01-07"
}
response = requests.get(
    f"{BASE_URL}/properties/{property_id}/performance",
    headers=headers,
    params=params
)
performance = response.json()

JavaScript (Node.js)

const axios = require('axios');

const API_KEY = 'your_api_key';
const BASE_URL = 'https://api.search-console.pro/v1';

const client = axios.create({
  baseURL: BASE_URL,
  headers: {
    'Authorization': `Bearer ${API_KEY}`
  }
});

// Properties abrufen
const { data: properties } = await client.get('/properties');

// Keywords abrufen
const { data: keywords } = await client.get(
  `/properties/${properties[0].id}/keywords`,
  {
    params: {
      start_date: '2026-01-01',
      end_date: '2026-01-07',
      limit: 100,
      sort: '-clicks'
    }
  }
);

PHP

$api_key = 'your_api_key';
$base_url = 'https://api.search-console.pro/v1';

$ch = curl_init();
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $api_key
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Properties abrufen
curl_setopt($ch, CURLOPT_URL, $base_url . '/properties');
$response = curl_exec($ch);
$properties = json_decode($response, true);

curl_close($ch);