Retour aux API
Données de recherche IA

AI Search API

Suivez comment AI Overviews, ChatGPT et Google AI Mode répondent aux questions de votre marché : les réponses qui citent votre marque, votre niveau de visibilité, et les domaines et pages qu’ils citent.

API AI Search disponibles

Utilisez LLM Mentions API pour les réponses elles-mêmes, AI Search Visibility API pour les totaux et les ventilations, LLM Top Sources API pour les domaines ou pages les plus cités et Google AI Mode API pour la réponse complète d’AI Mode à une recherche.

Quelles données de recherche IA pouvez-vous récupérer ?

Partez d’un domaine, d’une marque ou d’un mot-clé et voyez comment les réponses IA le traitent.

Réponses IA qui vous mentionnent

La question, la réponse complète en Markdown, les sources citées, les résultats web utilisés, les marques nommées et les recherches complémentaires lancées.

Indicateurs de visibilité

Total des mentions et volume de recherche IA pour un domaine ou un mot-clé, ventilés par domaine cité, domaine des résultats de recherche, marque et catégorie de marque.

Sources les plus citées

Les dix domaines ou pages que les réponses IA citent le plus sur un sujet, avec le nombre de mentions et le volume de recherche IA.

Réponses de Google AI Mode

La réponse complète d’AI Mode à une recherche, dans tout pays et toute langue, avec chaque source citée, son titre, son domaine et son extrait.

Historique des réponses

Dates de première et de dernière observation pour chaque réponse, afin de distinguer les nouvelles mentions des mentions durables.

Suivi des mentions ou réponses de Google AI Mode

Utilisez les API de mentions pour mesurer une marque sur de nombreuses réponses IA, et Google AI Mode pour lire une réponse en entier.

CritèreLLM Mentions, AI Search Visibility et LLM Top SourcesGoogle AI Mode API
EntréeUn domaine dans target ou un mot-clé dans queryUne recherche dans query
Surfaces IAAI Overviews, ou ChatGPT avec platform chat_gptGoogle AI Mode
RésultatRéponses, lignes d’indicateurs ou les dix sources les plus citéesUne réponse complète avec chaque source citée
Idéal pourPart des réponses IA, concurrents et cibles de citationCe qu’AI Mode dit aux internautes sur un marché donné
Tarif40 crédits par requête plus 0,5 par ligne2 crédits par requête

Fonctionnement de l’API AI Search

Toutes les API AI Search suivent le même flux de tâches asynchrones.

  1. 1. Envoyer un domaine ou un mot-clé

    Envoyez en POST un domaine dans target ou un mot-clé dans query à /v1/ai-search/llm-mentions, /v1/ai-search/llm-brand-metrics ou /v1/ai-search/llm-top-mentioned, ou une recherche à /v1/ai-search/google-ai-mode.

  2. 2. Suivre la tâche

    Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.

  3. 3. Lire les résultats

    Lisez les réponses, les lignes d’indicateurs ou les sources dans results.items.

Trouver les réponses IA qui citent un domaine

Authentifiez-vous avec votre clé API SocQ et envoyez le domaine à suivre. Une requête coûte 40 crédits plus 0,5 crédit par réponse renvoyée.

curl -X POST "https://api.socq.ai/v1/ai-search/llm-mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so","platform":"google","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read the AI answers in results.items

Cas d’usage courants de l’API AI Search

Reporting GEO

Suivez chaque mois les mentions et le volume de recherche IA de votre domaine, et rendez compte de l’évolution de votre part des réponses IA.

Benchmark concurrentiel

Comparez les marques qui apparaissent à côté de la vôtre dans les réponses de ChatGPT et la fréquence à laquelle chacune est citée.

Outreach de citations

Repérez les domaines et pages que les réponses IA citent le plus sur votre sujet, puis obtenez une couverture ou des liens sur ces pages.

Planification de contenu

Transformez les questions et les recherches complémentaires derrière les réponses IA en briefs pour des pages que l’IA peut citer.

Contrôles AI Mode

Lisez ce que Google AI Mode dit de votre catégorie sur chaque marché et vérifiez si vos pages figurent parmi ses sources.

Règles de requête et tarifs

Ces règles s’appliquent à l’ensemble des API AI Search.

  • LLM Mentions, AI Search Visibility et LLM Top Sources prennent un domaine dans target ou un mot-clé dans query, et lisent AI Overviews par défaut, ou ChatGPT avec platform chat_gpt.
  • Les données ChatGPT couvrent les États-Unis en anglais et ajoutent des lignes de marque ; les données AI Overviews suivent location_code et language_code.
  • LLM Mentions renvoie de 1 à 1 000 réponses, 100 par défaut ; LLM Top Sources renvoie jusqu’à 10 domaines ou pages, selon content_type.
  • Google AI Mode prend une recherche dans query et renvoie une réponse pour le pays et la langue choisis.
  • LLM Mentions, AI Search Visibility et LLM Top Sources coûtent 40 crédits par requête plus 0,5 crédit par ligne ; Google AI Mode coûte 2 crédits par requête.

Questions fréquentes sur l’API AI Search

Qu’est-ce que l’API AI Search ?

L’API AI Search est un ensemble d’endpoints pour l’optimisation pour les moteurs génératifs (GEO) : elle renvoie les réponses d’AI Overviews, de ChatGPT et de Google AI Mode sur un domaine, une marque ou un mot-clé, avec les sources citées et la fréquence d’apparition d’une marque.

Quelles API AI Search sont disponibles ?

LLM Mentions API, AI Search Visibility API, LLM Top Sources API et Google AI Mode API.

Quels assistants IA sont couverts ?

Google AI Overviews et ChatGPT pour les mentions, la visibilité et les sources principales, et Google AI Mode pour les réponses complètes à une recherche.

Faut-il envoyer un domaine ou un mot-clé ?

Envoyez votre domaine dans target pour trouver les réponses qui citent votre site, ou une marque ou un sujet dans query pour trouver celles qui le mentionnent, y compris quand une marque est nommée sans lien vers son site.

Comment les requêtes AI Search sont-elles facturées ?

LLM Mentions, AI Search Visibility et LLM Top Sources coûtent 40 crédits par requête plus 0,5 crédit par ligne renvoyée. Google AI Mode coûte 2 crédits par requête.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.

Instagram API

Recherchez ou trouvez des profils publics et collectez enregistrements de listes d’abonnés, relations d’abonnement, publications publiées, publications où un profil est identifié, résultats par hashtag, Reels, transcriptions, commentaires, nombres de comptes, indicateurs d’engagement et métadonnées de médias dans un seul workflow asynchrone.

TikTok API

Collectez des profils TikTok publics pris en charge, les métadonnées de vidéos directes, les commentaires de premier niveau, des résultats de recherche de vidéos et les vidéos de hashtags précis dans un seul flux asynchrone normalisé.

YouTube API

Collectez les profils de chaînes YouTube publics pris en charge, les détails de vidéos, les vidéos de chaînes, les commentaires, les Shorts, les résultats par mot-clé et par hashtag, ainsi que les transcriptions disponibles, dans un seul flux asynchrone normalisé.

Facebook API

Collectez des profils de Pages Facebook publiques, des publications, des publications de groupes, des commentaires, des événements correspondant à un mot-clé et les transcriptions vidéo disponibles, avec des champs normalisés d’identité, de contenu, de source, de format, de lieu, de médias, de réactions, de participation et d’engagement.

X API

Collectez des profils publics, les relations d’abonnés et d’abonnements, des posts, des réponses, des citations, les comptes qui ont reposté, des résultats de recherche et les tendances actuelles. Des résultats homogènes pour vos recherches et votre veille.

LinkedIn API

Récupérez des données LinkedIn publiques de profils, d’entreprises, de publications et d’offres d’emploi à partir d’URL connues, avec des champs normalisés d’identité, de carrière, d’entreprise, de contenu, d’engagement et d’offre.