SEObserver API v1

API SEO complète couvrant les backlinks (propulsé par Majestic), le suivi SERP, la vérification d'indexation et le monitoring de mots-clés organiques.

Authentification

Toutes les requêtes API nécessitent une clé API. Transmettez-la via le header HTTP X-SEObserver-key (recommandé) ou en paramètre api_key dans l'URL.

curl -H "X-SEObserver-key: YOUR_API_KEY" https://api1.seobserver.com/backlinks/metrics.json

Votre clé API est disponible dans votre tableau de bord SEObserver sous Paramètres > API.

URL de base

Tous les endpoints sont relatifs à : https://api1.seobserver.com/

Toutes les réponses sont en JSON. Ajoutez .json au chemin de l'endpoint.

Limites & Facturation

Chaque appel API consomme des Unités SEObserver depuis le solde de votre compte. Le coût dépend de l'endpoint et de la quantité de données retournées.

Types de coût

Type	Formule	Description
Flat	Montant fixe	Coût identique quel que soit le volume de données
Variable	facteur × lignes	Proportionnel au nombre de lignes retournées, avec minimum
Mixed	base + facteur × lignes	Coût de base fixe plus composante variable, avec minimum
Free	0	Gratuit

Table complète des coûts

Endpoint	Type	Base	Facteur	Min
`backlinks/metrics`	Variable	0	1	—
`backlinks/metrics_archive`	Variable	0	5	—
`backlinks/anchors`	Variable	0	1	10
`backlinks/top`	Mixed	40	1	50
`backlinks/refdomains`	Variable	0	1	10
`backlinks/pages`	Mixed	40	1	50
`backlinks/history`	Variable	0	1	10
`backlinks/newlost_calendar`	Flat	10	—	—
`backlinks/refdomaininfo`	Variable	0	1	10
`backlinks/linkprofile`	Mixed	20	1	30
`backlinks/relatedsites`	Mixed	40	1	50
`backlinks/queryestimate`	Flat	1	—	—
`backlinks/searchbykeyword`	Variable	0	1	10
`backlinks/keywordinfo`	Variable	0	1	10
`backlinks/submitcrawl`	Variable	0	5	10
`serps/add`	Variable	0	1	—
`indexeds/add`	Variable	0	1	—
`organic_keywords/metrics`	Variable	0	1	—
`organic_keywords/index`	Variable	0	1	—
`organic_keywords/urls`	Variable	0	1	—
`organic_keywords/visibility_history`	Mixed	1	2	—

Vérifiez votre solde à tout moment via l'endpoint subscription.

Format d'entrée

La plupart des endpoints Backlinks acceptent les items sous forme de tableau JSON dans le corps de la requête, ou en paramètres d'URL.

Corps JSON (recommandé)

[
  {"item_type": "domain", "item_value": "example.com"},
  {"item_type": "url", "item_value": "https://example.com/page"}
]

Paramètres d'URL

?item_type=domain&item_value=example.com

Valeurs item_type valides

item_type	Description
`domain`	Domaine racine (ex. example.com)
`subdomain`	Sous-domaine (ex. blog.example.com)
`site`	Requête au niveau du site
`url`	URL exacte
`path`	Chemin d'URL avec correspondance wildcard
`keyword`	Chaîne de mot-clé (uniquement pour l'endpoint keywordinfo)

Cas d'usage

Workflows courants combinant plusieurs endpoints pour résoudre des problèmes SEO concrets.

Analyse de backlinks

Surveiller l'acquisition de backlinks des concurrents

Suivez comment vos concurrents gagnent des liens au fil du temps. Utilisez history pour les tendances et newlost_calendar pour l'activité quotidienne.

history newlost_calendar

Auditer la qualité de votre profil de liens

Évaluez la santé de vos backlinks en combinant les métriques générales, la matrice de distribution CF/TF et l'analyse des ancres.

metrics linkprofile anchors

Trouver des opportunités de link building

Découvrez les sites liés à votre niche et trouvez les domaines positionnés sur vos mots-clés cibles.

relatedsites searchbykeyword

Vérification en masse de l'autorité de domaines

Vérifiez le TrustFlow et CitationFlow de jusqu'à 100 domaines en une seule requête. Utilisez refdomaininfo pour des données détaillées.

metrics refdomaininfo

Détecter les attaques de SEO négatif

Repérez les pics soudains de nouveaux backlinks ou de liens perdus pouvant indiquer une attaque de SEO négatif.

newlost_calendar top

Recherche de mots-clés

Trouver les lacunes de contenu

Obtenez des données de popularité des mots-clés et découvrez quels domaines se positionnent sur les termes que vous manquez.

keywordinfo searchbykeyword

Audit de contenu

Analysez quels mots-clés et URLs génèrent de la visibilité organique pour votre domaine.

organic_keywords/index organic_keywords/urls

Suivi SERP

Suivre les positions sur des termes clés

Soumettez des mots-clés pour le suivi SERP et récupérez les résultats une fois traités.

serps/add serps/view

Surveiller les SERP locaux

Suivez les positions pour des localisations spécifiques en utilisant les paramètres custom base et UULE.

serps/add

Monitoring d'indexation

Vérifier que les nouvelles pages sont indexées

Soumettez les URLs récemment publiées et vérifiez leur statut d'indexation dans Google.

indexeds/add indexeds/view

Audit d'indexation globale du site

Soumettez des URLs par lot pour auditer la couverture d'indexation sur l'ensemble de votre site.

indexeds/add

Endpoints Backlinks

GET /api1/backlinks/metrics.json Variable : 1/ligne

Obtenez les métriques de liens (TrustFlow, CitationFlow, nombre de backlinks, domaines référents, etc.) pour jusqu'à 100 items en une seule requête. Propulsé par Majestic GetIndexItemInfo.

Paramètre	Type	Requis	Défaut	Description
`items`	Corps JSON	Oui	—	Tableau d'items (max 100)
`datasource`	string	Non	fresh	`fresh` ou `historic`

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/metrics.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

$ch = curl_init('https://api1.seobserver.com/backlinks/metrics.json');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'X-SEObserver-key: YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        ['item_type' => 'domain', 'item_value' => 'example.com']
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.post(
    "https://api1.seobserver.com/backlinks/metrics.json",
    headers={"X-SEObserver-key": "YOUR_API_KEY"},
    json=[{"item_type": "domain", "item_value": "example.com"}],
)
data = response.json()

const response = await fetch("https://api1.seobserver.com/backlinks/metrics.json", {
  method: "POST",
  headers: {
    "X-SEObserver-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify([{ item_type: "domain", item_value: "example.com" }]),
});
const data = await response.json();

body, _ := json.Marshal([]map[string]string{
    {"item_type": "domain", "item_value": "example.com"},
})
req, _ := http.NewRequest("POST",
    "https://api1.seobserver.com/backlinks/metrics.json",
    bytes.NewBuffer(body))
req.Header.Set("X-SEObserver-key", "YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

Exemple de réponse

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "Item": "example.com",
      "ResultCode": "OK",
      "Status": "Found",
      "TrustFlow": 72,
      "CitationFlow": 65,
      "ExtBackLinks": 285432,
      "RefDomains": 12847,
      "TopicalTrustFlow_Topic_0": "Computers/Internet",
      "TopicalTrustFlow_Value_0": 48
    }
  ],
  "number_of_rows": 1
}

GET /api1/backlinks/metrics_archive.json Variable : 5/ligne

Obtenez les snapshots historiques des métriques pour un item, stockés mensuellement dans les archives SEObserver. Jusqu'à 12 mois de données.

Paramètre	Type	Requis	Défaut	Description
`item`	Corps JSON	Oui	—	Item unique
`count`	integer	Non	12	Nombre de mois (max 12)

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/metrics_archive.json?count=6 \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

Exemple de réponse

{
  "status": "ok",
  "data": [
    {
      "date": "2025-01-15",
      "TrustFlow": 72,
      "CitationFlow": 65,
      "ExtBackLinks": 285432
    }
  ],
  "number_of_rows": 6
}

GET /api1/backlinks/top.json Mixed : 40 + 1/ligne (min 50)

Obtenez les meilleurs backlinks pointant vers un item, classés par force du lien. Propulsé par Majestic GetBackLinkData.

Paramètre	Type	Requis	Défaut	Description
`item`	Corps JSON	Oui	—	Item unique
`datasource`	string	Non	fresh	`fresh` ou `historic`
`limit`	integer	Non	10	Nombre de résultats (max 50 000)

Exemple de requête

curl "https://api1.seobserver.com/backlinks/top.json?datasource=fresh&limit=20&item_type=domain&item_value=example.com" \
  -H "X-SEObserver-key: YOUR_API_KEY"

$url = 'https://api1.seobserver.com/backlinks/top.json?' . http_build_query([
    'datasource' => 'fresh', 'limit' => 20,
    'item_type' => 'domain', 'item_value' => 'example.com',
]);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-SEObserver-key: YOUR_API_KEY'],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.get(
    "https://api1.seobserver.com/backlinks/top.json",
    headers={"X-SEObserver-key": "YOUR_API_KEY"},
    params={"datasource": "fresh", "limit": 20,
            "item_type": "domain", "item_value": "example.com"},
)
data = response.json()

const params = new URLSearchParams({
  datasource: "fresh", limit: 20,
  item_type: "domain", item_value: "example.com",
});
const response = await fetch(
  `https://api1.seobserver.com/backlinks/top.json?${params}`,
  { headers: { "X-SEObserver-key": "YOUR_API_KEY" } }
);
const data = await response.json();

req, _ := http.NewRequest("GET",
    "https://api1.seobserver.com/backlinks/top.json?datasource=fresh&limit=20&item_type=domain&item_value=example.com",
    nil)
req.Header.Set("X-SEObserver-key", "YOUR_API_KEY")
resp, _ := http.DefaultClient.Do(req)

Exemple de réponse

{
  "status": "ok",
  "data": [
    {
      "SourceURL": "https://referrer.com/page",
      "SourceTrustFlow": 85,
      "SourceCitationFlow": 71,
      "AnchorText": "example link",
      "TargetURL": "https://example.com",
      "FlagRedirect": 0
    }
  ],
  "number_of_rows": 20
}

GET /api1/backlinks/anchors.json Variable : 1/ligne (min 10)

Obtenez la distribution des textes d'ancre pour un item. Propulsé par Majestic GetAnchorText.

Paramètre	Type	Requis	Défaut	Description
`item`	Corps JSON	Oui	—	Item unique
`datasource`	string	Non	fresh	`fresh` ou `historic`
`limit`	integer	Non	10	Nombre de résultats (max 1 000)

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/anchors.json?limit=50 \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

Exemple de réponse

{
  "status": "ok",
  "meta": {
    "countAll": 5432,
    "totalRefDomains": 892
  },
  "data": [
    {
      "AnchorText": "example",
      "TotalLinks": 1234,
      "DeletedLinks": 56,
      "RefDomains": 320
    }
  ],
  "number_of_rows": 50
}

GET /api1/backlinks/refdomains.json Variable : 1/ligne (min 10)

Obtenez la liste des domaines référents pointant vers un item. Propulsé par Majestic GetRefDomains.

Paramètre	Type	Requis	Défaut	Description
`item`	Corps JSON	Oui	—	Item unique
`datasource`	string	Non	fresh	`fresh` ou `historic`
`limit`	integer	Non	10	Nombre de résultats

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/refdomains.json?limit=20 \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

GET /api1/backlinks/pages.json Mixed : 40 + 1/ligne (min 50)

Obtenez les pages les plus populaires d'un domaine par nombre de backlinks. Propulsé par Majestic GetTopPages.

Paramètre	Type	Requis	Défaut	Description
`item`	Corps JSON	Oui	—	Item unique
`datasource`	string	Non	fresh	`fresh` ou `historic`
`limit`	integer	Non	10	Nombre de résultats (max 10 000)

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/pages.json?limit=100 \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

GET /api1/backlinks/history.json Variable : 1/ligne (min 10)

Obtenez l'historique du nombre de backlinks au fil du temps pour un item. Retourne des lignes mensuelles (index historic) ou quotidiennes (index fresh). Propulsé par Majestic GetBackLinksHistory.

Paramètre	Type	Requis	Défaut	Description
`item`	Corps JSON	Oui	—	Item unique
`datasource`	string	Non	fresh	`fresh` ou `historic`

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/history.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

Exemple de réponse

{
  "status": "ok",
  "data": [
    {
      "Date": "2025-01-15",
      "ExtBackLinks": 285432,
      "RefDomains": 12847,
      "IndexedURLs": 54321,
      "ExtBackLinksEDU": 23,
      "ExtBackLinksGOV": 12,
      "RefDomainsEDU": 5,
      "RefDomainsGOV": 3
    }
  ],
  "number_of_rows": 365
}

GET /api1/backlinks/newlost_calendar.json Flat : 10 unités

Obtenez un calendrier quotidien des backlinks nouveaux et perdus pour un item. Propulsé par Majestic GetNewLostBackLinkCalendar.

Paramètre	Type	Requis	Défaut	Description
`item`	Corps JSON	Oui	—	Item unique
`datasource`	string	Non	fresh	`fresh` ou `historic`

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/newlost_calendar.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

Exemple de réponse

{
  "status": "ok",
  "data": [
    {
      "Date": "2025-01-15",
      "NewLinks": 142,
      "LostLinks": 38
    }
  ],
  "number_of_rows": 90
}

GET /api1/backlinks/refdomaininfo.json Variable : 1/ligne (min 10)

Obtenez des informations détaillées sur les domaines référents (TF, CF, backlinks, refdomains, IPs, géolocalisation, TopicalTF). Accepte des requêtes batch jusqu'à 100 domaines racine. Propulsé par Majestic GetRefDomainInfo.

Paramètre	Type	Requis	Défaut	Description
`items`	Corps JSON	Oui	—	Tableau d'items (max 100, domaines racine)
`datasource`	string	Non	fresh	`fresh` ou `historic`

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/refdomaininfo.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {"item_type":"domain","item_value":"referrer1.com"},
    {"item_type":"domain","item_value":"referrer2.com"}
  ]'

Exemple de réponse

{
  "status": "ok",
  "data": [
    {
      "Domain": "referrer1.com",
      "TrustFlow": 45,
      "CitationFlow": 38,
      "ExtBackLinks": 12500,
      "RefDomains": 890,
      "CountryCode": "US",
      "TopicalTrustFlow_Topic_0": "Business"
    }
  ],
  "number_of_rows": 2
}

GET /api1/backlinks/linkprofile.json Mixed : 20 + 1/ligne (min 30)

Obtenez la matrice de distribution du profil de liens (CitationFlow × TrustFlow) pour un item. Retourne une matrice 2D montrant le nombre de backlinks dans chaque bucket CF/TF. Propulsé par Majestic GetLinkProfile.

Paramètre	Type	Requis	Défaut	Description
`item`	Corps JSON	Oui	—	Item unique
`datasource`	string	Non	fresh	`fresh` ou `historic`

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/linkprofile.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

Exemple de réponse

{
  "status": "ok",
  "data": [
    {
      "CitationFlow": 0,
      "TrustFlow": 0,
      "Count": 54321
    },
    {
      "CitationFlow": 10,
      "TrustFlow": 5,
      "Count": 1234
    }
  ],
  "number_of_rows": 150
}

GET /api1/backlinks/relatedsites.json Mixed : 40 + 1/ligne (min 50)

Trouvez les sites liés à un domaine par analyse de co-citation. Retourne les domaines concurrents/liés avec leur TF, CF et pertinence thématique. Propulsé par Majestic GetRelatedSites.

Cet endpoint est en Beta. Index fresh uniquement. Le comportement peut changer.

Paramètre	Type	Requis	Défaut	Description
`item`	Corps JSON	Oui	—	Item unique
`limit`	integer	Non	10	Nombre de résultats (max 100)

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/relatedsites.json?limit=20 \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

GET /api1/backlinks/queryestimate.json Flat : 1 unité

Estimez rapidement le nombre de backlinks pour un item avant de lancer une requête plus lourde. Retourne si la requête en temps réel est autorisée et les comptages estimés. Propulsé par Majestic GetPrefixQueryEstimate.

Paramètre	Type	Requis	Défaut	Description
`item`	Corps JSON	Oui	—	Item unique

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/queryestimate.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

Exemple de réponse

{
  "status": "ok",
  "data": {
    "RealTimeQueryAllowed": "True",
    "ActualExtBackLinks": 285432,
    "EstimatedExtBacklinks": 290000
  },
  "number_of_rows": 1
}

Endpoints Mots-clés

GET /api1/backlinks/searchbykeyword.json Variable : 1/ligne (min 10)

Recherchez des URLs ou domaines par mot-clé dans l'index Majestic. Retourne des résultats classés par SearchScore avec TF, CF et nombre de domaines référents. Propulsé par Majestic SearchByKeyword.

Cet endpoint utilise un rate limit partagé. Les appels excessifs peuvent être ralentis.

Paramètre	Type	Requis	Défaut	Description
`query`	string	Oui	—	Mot-clé à rechercher
`datasource`	string	Non	fresh	`fresh` ou `historic`
`limit`	integer	Non	10	Nombre de résultats (max 100)
`scope`	integer	Non	2	`0` = domaines uniquement, `2` = URLs

Accepte les paramètres en query string ou en corps JSON :

Exemple de requête (GET)

curl "https://api1.seobserver.com/backlinks/searchbykeyword.json?query=seo+tools&limit=20" \
  -H "X-SEObserver-key: YOUR_API_KEY"

Exemple de requête (POST JSON)

curl -X POST https://api1.seobserver.com/backlinks/searchbykeyword.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "seo tools", "limit": 50, "scope": 0}'

Exemple de réponse

{
  "status": "ok",
  "data": [
    {
      "Item": "https://example.com/seo-tools",
      "SearchScore": 95.4,
      "TrustFlow": 62,
      "CitationFlow": 55,
      "RefDomains": 3400
    }
  ],
  "number_of_rows": 20
}

GET /api1/backlinks/keywordinfo.json Variable : 1/mot-clé (min 10)

Obtenez les données d'occurrence de mots-clés Majestic (nombre de correspondances exactes et larges) pour jusqu'à 100 mots-clés en batch. Propulsé par Majestic GetKeywordInfo.

Paramètre	Type	Requis	Défaut	Description
`items`	Corps JSON	Oui	—	Tableau d'items mot-clé (max 100). Utiliser `item_type: "keyword"`

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/keywordinfo.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {"item_type":"keyword","item_value":"seo"},
    {"item_type":"keyword","item_value":"backlinks"},
    {"item_type":"keyword","item_value":"link building"}
  ]'

Exemple de réponse

{
  "status": "ok",
  "data": [
    {
      "Keyword": "seo",
      "PhraseMatchCount": 4523100,
      "BroadMatchCount": 12500000
    },
    {
      "Keyword": "backlinks",
      "PhraseMatchCount": 892000,
      "BroadMatchCount": 3200000
    }
  ],
  "number_of_rows": 3
}

Endpoints Outils

POST /api1/backlinks/submitcrawl.json Variable : 5/URL (min 10)

Soumettez des URLs au crawler Majestic pour un crawl prioritaire. Utilisez ceci pour garantir que des données fraîches sont disponibles pour des pages spécifiques. POST uniquement. Propulsé par Majestic SubmitURLsToCrawl.

Chaque URL soumise coûte 5 unités SEObserver. Planifiez votre budget lors de soumissions en masse.

Paramètre	Type	Requis	Défaut	Description
`body`	Tableau JSON	Oui	—	Tableau de chaînes d'URLs (max 100)
`datasource`	string	Non	fresh	`fresh` ou `historic`

Exemple de requête

curl -X POST https://api1.seobserver.com/backlinks/submitcrawl.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '["https://example.com/new-page","https://example.com/updated-page"]'

$ch = curl_init('https://api1.seobserver.com/backlinks/submitcrawl.json');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'X-SEObserver-key: YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'https://example.com/new-page',
        'https://example.com/updated-page',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.post(
    "https://api1.seobserver.com/backlinks/submitcrawl.json",
    headers={"X-SEObserver-key": "YOUR_API_KEY"},
    json=["https://example.com/new-page", "https://example.com/updated-page"],
)
data = response.json()

const response = await fetch("https://api1.seobserver.com/backlinks/submitcrawl.json", {
  method: "POST",
  headers: {
    "X-SEObserver-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify([
    "https://example.com/new-page",
    "https://example.com/updated-page",
  ]),
});
const data = await response.json();

urls := []string{
    "https://example.com/new-page",
    "https://example.com/updated-page",
}
body, _ := json.Marshal(urls)
req, _ := http.NewRequest("POST",
    "https://api1.seobserver.com/backlinks/submitcrawl.json",
    bytes.NewBuffer(body))
req.Header.Set("X-SEObserver-key", "YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

Exemple de réponse

{
  "status": "ok",
  "data": {
    "URLsAdded": 2,
    "Code": "OK",
    "ErrorMessage": ""
  },
  "number_of_rows": 2
}

Endpoints Abonnement

GET /api1/api_users/subscription.json Free

Obtenez le statut actuel de votre abonnement API, y compris les unités restantes.

Exemple de requête

curl https://api1.seobserver.com/api_users/subscription.json \
  -H "X-SEObserver-key: YOUR_API_KEY"

Exemple de réponse

{
  "status": "ok",
  "data": {
    "enabled": true,
    "TotalUnits": 485000,
    "MaxUnits": 500000
  }
}

GET /api1/api_users/costs.json Free

Obtenez la table complète des coûts pour tous les endpoints API. Utile pour construire des estimations de coût dans votre intégration.

Paramètre	Type	Requis	Défaut	Description
`output`	string	Non	standard	`standard` (imbriqué) ou `absolute` (clé-valeur à plat)

Exemple de requête

curl https://api1.seobserver.com/api_users/costs.json \
  -H "X-SEObserver-key: YOUR_API_KEY"

Endpoints SERP

Soumettez des mots-clés pour le suivi SERP (Search Engine Results Page). Les résultats sont traités de manière asynchrone.

POST /api1/serps/add.json Variable : 1/mot-clé

Soumettez des mots-clés pour la vérification SERP. Chaque paire mot-clé+base crée un job SERP traité de manière asynchrone.

Paramètre	Type	Requis	Défaut	Description
`keyword`	string	Oui	—	Mot-clé de recherche
`base`	string	Oui	—	Base du moteur de recherche (ex. `google.fr`)
`priority`	string	Non	low	`low` ou `high` (high coûte 2x)
`type`	string	Non	—	Type de SERP (+2 unités si défini)
`batch`	string	Non	—	Identifiant de batch pour le regroupement
`postback_url`	string	Non	—	URL où POST les résultats quand prêts
`filters`	object	Non	—	Filtres de résultats

Exemple de requête

curl -X POST https://api1.seobserver.com/serps/add.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword":"seo tools","base":"google.fr","priority":"low"}]'

Exemple de réponse (201)

{
  "status": "ok",
  "data": [
    {
      "id": "64a1b2c3d4e5f6a7b8c9d0e1",
      "keyword": "seo tools",
      "base": "google.fr",
      "status": -1,
      "created": "2025-01-15T10:30:00+00:00"
    }
  ]
}

GET /api1/serps/view/{id}.json Free

Obtenez le statut et les résultats d'un job SERP spécifique par son ID.

Paramètre	Type	Requis	Défaut	Description
`id`	string	Oui	—	ID MongoDB du job SERP (dans le chemin URL)

Exemple de requête

curl https://api1.seobserver.com/serps/view/64a1b2c3d4e5f6a7b8c9d0e1.json \
  -H "X-SEObserver-key: YOUR_API_KEY"

GET /api1/serps/index.json Free

Listez tous vos jobs SERP avec pagination et filtrage.

Paramètre	Type	Requis	Défaut	Description
`limit`	integer	Non	100	Résultats par page (max 10 000)
`page`	integer	Non	1	Numéro de page
`keyword`	string	Non	—	Filtrer par mot-clé
`batch`	string	Non	—	Filtrer par batch

Exemple de requête

curl "https://api1.seobserver.com/serps/index.json?limit=50&batch=campaign1" \
  -H "X-SEObserver-key: YOUR_API_KEY"

Endpoints Indexation

Vérifiez si des URLs sont indexées dans Google. Les jobs sont traités de manière asynchrone.

POST /api1/indexeds/add.json Variable : 1/URL

Soumettez des URLs pour la vérification d'indexation. Chaque URL crée un job asynchrone.

Paramètre	Type	Requis	Défaut	Description
`url`	string	Oui	—	URL à vérifier
`priority`	string	Non	low	`low` ou `high` (high coûte 2x)
`level`	string	Non	exact	Correspondance `exact` ou plus large
`batch`	string	Non	—	Identifiant de batch
`postback_url`	string	Non	—	URL où POST les résultats

Exemple de requête

curl -X POST https://api1.seobserver.com/indexeds/add.json \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url":"https://example.com/page","priority":"low"}]'

GET /api1/indexeds/view/{id}.json Free

Obtenez le statut et le résultat d'un job de vérification d'indexation spécifique.

Paramètre	Type	Requis	Défaut	Description
`id`	string	Oui	—	ID MongoDB du job (dans le chemin URL)

Exemple de requête

curl https://api1.seobserver.com/indexeds/view/64a1b2c3d4e5f6a7b8c9d0e1.json \
  -H "X-SEObserver-key: YOUR_API_KEY"

GET /api1/indexeds/index.json Free

Listez tous vos jobs de vérification d'indexation avec pagination et filtrage.

Paramètre	Type	Requis	Défaut	Description
`limit`	integer	Non	100	Résultats par page (max 10 000)
`page`	integer	Non	1	Numéro de page
`url`	string	Non	—	Filtrer par URL
`batch`	string	Non	—	Filtrer par batch
`code`	integer	Non	—	Filtrer par code HTTP

Exemple de requête

curl "https://api1.seobserver.com/indexeds/index.json?limit=50&batch=batch1" \
  -H "X-SEObserver-key: YOUR_API_KEY"

DELETE /api1/indexeds/delete/{id}.json Free

Supprimez un job de vérification d'indexation.

Paramètre	Type	Requis	Défaut	Description
`id`	string	Oui	—	ID MongoDB du job (dans le chemin URL)

Exemple de requête

curl https://api1.seobserver.com/indexeds/delete/64a1b2c3d4e5f6a7b8c9d0e1.json \
  -H "X-SEObserver-key: YOUR_API_KEY"

Endpoints Mots-clés Organiques

Accédez aux données de suivi de mots-clés organiques de SEObserver. Couvre les métriques de visibilité, les classements de mots-clés et les tendances historiques.

GET /api1/organic_keywords/metrics.json Variable : 1/item

Obtenez les métriques de visibilité organique pour jusqu'à 100 domaines. Retourne des scores de visibilité SEO agrégés.

Paramètre	Type	Requis	Défaut	Description
`items`	Corps JSON	Oui	—	Tableau d'items (max 100)
`base`	string	Non	fr_fr	Code marché/locale
`date`	string	Non	latest	Date spécifique

Exemple de requête

curl -X POST https://api1.seobserver.com/organic_keywords/metrics.json?base=fr_fr \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

GET /api1/organic_keywords/index.json Variable : 1/ligne

Listez les classements de mots-clés organiques pour un domaine avec filtrage et tri avancés.

Paramètre	Type	Requis	Défaut	Description
`domain`	string	Oui	—	Domaine à interroger (paramètre d'URL)
`base`	string	Non	fr_fr	Code marché/locale
`limit`	integer	Non	100	Résultats par page (max 10 000)
`offset`	integer	Non	0	Décalage pour la pagination
`date`	string	Non	latest	Date spécifique
`conditions`	object	Non	—	Conditions de filtre (p, url, keyword_title, search_volume, visibility, branded, tags)
`order`	object	Non	—	Ordre de tri (p, url, keyword_title, search_volume, cpc, competition, visibility, branded, tags)

Exemple de requête

curl "https://api1.seobserver.com/organic_keywords/index.json?domain=example.com&base=fr_fr&limit=50" \
  -H "X-SEObserver-key: YOUR_API_KEY"

GET /api1/organic_keywords/urls.json Variable : 1/ligne

Obtenez les URLs d'un domaine regroupées par visibilité agrégée et nombre de mots-clés.

Paramètre	Type	Requis	Défaut	Description
`domain`	string	Oui	—	Domaine à interroger
`base`	string	Non	fr_fr	Code marché/locale
`limit`	integer	Non	100	Résultats par page (max 10 000)
`offset`	integer	Non	0	Décalage pour la pagination

Exemple de requête

curl -X POST "https://api1.seobserver.com/organic_keywords/urls.json?base=fr_fr&limit=100" \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

GET /api1/organic_keywords/visibility_history.json Mixed : 1 + 2/mois

Obtenez l'historique de visibilité mois par mois pour des domaines.

Paramètre	Type	Requis	Défaut	Description
`items`	Corps JSON	Oui	—	Tableau d'items ou paramètre `domain`
`base`	string	Non	fr_fr	Code marché/locale
`months`	integer	Non	12	Nombre de mois
`start_date`	string	Non	—	Date de début (AAAA-MM-JJ)
`end_date`	string	Non	—	Date de fin (AAAA-MM-JJ)

Exemple de requête

curl -X POST "https://api1.seobserver.com/organic_keywords/visibility_history.json?base=fr_fr&months=6" \
  -H "X-SEObserver-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"item_type":"domain","item_value":"example.com"}]'

GET /api1/organic_keywords/list_dates.json Free

Listez toutes les dates de données disponibles pour un marché donné. Utile pour savoir quelles dates interroger dans l'endpoint index.

Paramètre	Type	Requis	Défaut	Description
`base`	string	Non	—	Code marché/locale

Exemple de requête

curl "https://api1.seobserver.com/organic_keywords/list_dates.json?base=fr_fr" \
  -H "X-SEObserver-key: YOUR_API_KEY"