YepAPI — Référence API

Que fait YepAPI — Référence API ?

URL de base : https://api.yepapi.com Authentification : en-tête x-api-key Réponse : { ok: true, data: {...} } ou { ok: false, error: { code, message } } Limite de débit : 60 requêtes/min

SEO — Mots-clés

Méthode	Chemin	Coût	Obligatoire	Description
POST	/v1/seo/keywords	0,15 $	keywords[], location	Métriques en masse : volume, CPC, difficulté, intention, tendances (jusqu’à 100)
POST	/v1/seo/keywords/ideas	0,03 $	keyword, location	Suggestions de mots-clés à partir d’un terme de départ
POST	/v1/seo/keywords/related	0,03 $	keyword, location	Mots-clés associés pour un terme de départ

Retourne : volume, cpc, difficulty (0-100), intent (informationnelle/commerciale/navigationnelle/transactionnelle), trend (tableau sur 12 mois)

SERP

Méthode	Chemin	Coût	Obligatoire	Description
POST	/v1/serp/google	0,01 $	query, location	Résultats organiques Google
POST	/v1/serp/google/news	0,01 $	query, location	Résultats Google Actualités
POST	/v1/serp/google/maps	0,01 $	query, location	Résultats Google Maps / locaux

Retourne : results[] avec title, url, snippet, position. Maps ajoute rating, reviews, address, phone.

Analyse de domaine

Méthode	Chemin	Coût	Obligatoire	Description
POST	/v1/seo/domain/overview	0,01 $	domain	Trafic, mots-clés, backlinks, classement du domaine
POST	/v1/seo/domain/keywords	0,04 $	domain	Mots-clés pour lesquels un domaine se classe
POST	/v1/seo/domain/backlinks	0,05 $	domain	Profil de backlinks du domaine

Retourne : aperçu donne traffic, keywords_count, backlinks, domain_rank. Mots-clés donne keyword, position, volume, url.

Concurrents

Méthode	Chemin	Coût	Obligatoire	Description
POST	/v1/seo/competitors	0,04 $	domain	Domaines concurrents par chevauchement de mots-clés
POST	/v1/seo/keyword-gap	0,04 $	domain, competitor	Écart de mots-clés entre deux domaines

Retourne : concurrents donne domain, overlap, traffic. Écart donne keyword, your_position, competitor_position, volume.

Backlinks

Méthode	Chemin	Coût	Obligatoire	Description
POST	/v1/seo/backlinks	0,05 $	target	Backlinks individuels vers un domaine/une URL
POST	/v1/seo/backlinks/summary	0,03 $	target	Métriques agrégées + ratio dofollow
POST	/v1/seo/referring-domains	0,03 $	target	Domaines référents avec autorité

Retourne : résumé donne total_backlinks, dofollow_ratio, domain_rank. Backlinks donne source_url, anchor, type, domain_rank.

On-Page et tendances

Méthode	Chemin	Coût	Obligatoire	Description
POST	/v1/seo/page-audit	0,03 $	url	Audit SEO technique (meta, titres, liens, images)
POST	/v1/seo/lighthouse	0,05 $	url	Scores Lighthouse (performance, accessibilité, SEO, bonnes pratiques)
POST	/v1/seo/trends	0,02 $	keywords[]	Évolution Google Trends dans le temps (jusqu’à 5 mots-clés)

Retourne : audit de page donne issues[], meta, headings, links, images. Lighthouse donne performance, accessibility, seo, best_practices (0-100). Tendances donne interest_over_time[].

Visibilité IA

Méthode	Chemin	Coût	Obligatoire	Description
POST	/v1/seo/ai/chatgpt	0,05 $	query	Ce que ChatGPT raconte d’une marque/d’une requête
POST	/v1/seo/ai/gemini	0,05 $	query	Ce que Gemini raconte d’une marque/d’une requête

Retourne : response (texte), mentions[], sentiment.

Scraping Web

Méthode	Chemin	Coût	Obligatoire	Description
POST	/v1/scrape	0,01 $	url	Scraper en markdown/HTML/texte
POST	/v1/scrape/js	0,02 $	url	Scraping avec rendu JS (navigateur headless)
POST	/v1/scrape/stealth	0,03 $	url	Contournement anti-bot (proxies résidentiels)
POST	/v1/scrape/ai-extract	0,03 $	url, prompt	Extraction structurée assistée par IA

Optionnel : format (« markdown »/« html »/« text »), waitFor (sélecteur CSS), timeout (ms). Retourne : content (chaîne), metadata (titre, description, url).

YouTube

Méthode	Chemin	Coût	Obligatoire	Description
POST	/v1/youtube/search	0,01 $	query	Rechercher des vidéos, chaînes, playlists
POST	/v1/youtube/video	0,02 $	videoId	Métadonnées vidéo complètes + formats
POST	/v1/youtube/transcript	0,01 $	videoId	Transcription avec horodatages
POST	/v1/youtube/channel	0,01 $	channelId ou handle	Aperçu de la chaîne
POST	/v1/youtube/comments	0,01 $	videoId	Commentaires et réponses

Retourne : recherche donne results[] avec videoId, title, views, published. Transcription donne segments[] avec text, start, duration.

Chat IA

Méthode	Chemin	Coût	Obligatoire	Description
POST	/v1/ai/chat	variable	model, messages[]	Discuter avec 69 modèles d’IA
GET	/v1/ai/models	gratuit	—	Lister les modèles disponibles + tarifs

Champs optionnels courants

Endpoints SEO : location (défaut « us »), language (défaut « en »), limit, offset. Endpoints de scraping : format, waitFor, timeout.

Codes d’erreur

Code	HTTP	Signification
INVALID_API_KEY	401	Clé manquante ou invalide
REVOKED_API_KEY	401	Clé révoquée
NO_CREDITS	402	Solde insuffisant
RATE_LIMITED	429	60 req/min dépassées
VALIDATION_ERROR	400	Corps de requête incorrect
UPSTREAM_ERROR	502	Erreur du fournisseur
MODEL_NOT_FOUND	400	Modèle IA invalide
AI_UPSTREAM_ERROR	502	Erreur du fournisseur IA
STREAM_ERROR	502	SSE interrompu
NOT_FOUND	404	Endpoint introuvable
INTERNAL_ERROR	500	Erreur serveur

Liens

• Docs : https://docs.yepapi.com
• Tableau de bord : https://yepapi.com/dashboard
• Clés API : https://yepapi.com/dashboard/api-keys
• Référence complète : https://docs.yepapi.com/llms-full.txt
• Serveur MCP : npx -y @yepapi/mcp