Les résultats de recherche et Reddit rejoignent l’API

Recevez en JSON les résultats de recherche Google, Bing et Naver et les discussions Reddit, avec la même API que pour les réponses IA.

Ce que vous obtenez

• GOOGLE_SERP : les résultats naturels avec position, titre, lien et extrait, plus les questions associées, les recherches associées et les annonces. Indiquez page de 1 à 10 pour aller plus loin.
• BING_SEARCH : les résultats Bing avec le résumé IA que Bing rédige au-dessus, dans aioverview avec ses sources.
• NAVER_SERP : les documents web de Naver, 15 par page, avec page de 1 à 10.
• REDDIT : une recherche de publications, une publication avec ses commentaires ou les dernières publications d’un subreddit.

Fonctionnement

Les moteurs IA construisent leurs réponses à partir du web : les pages qui se classent en recherche et les fils que les gens écrivent sur Reddit sont la matière première de la visibilité dans l’IA. Ces moteurs intègrent ces données au flux que vous utilisez déjà : même requête, même webhook, même format JSON.

Les positions se comptent d’une page à l’autre : le premier résultat Google de la page 2 a la position 11. Chaque tâche lit les résultats en direct au moment de la collecte.

Cas d’usage

• Comparez les sites qui se classent en recherche et ceux que citent les réponses IA pour la même requête.
• Suivez les fils Reddit qui forgent l’opinion dans votre catégorie.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GOOGLE_SERP",
    "payload": {
      "query": "best project management software for small teams",
      "country": "US"
    }
  }'

Envoyez BING_SEARCH et NAVER_SERP de la même manière, avec query dans le payload.

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.querystringObligatoire

La requête, rédigée comme un utilisateur la tape dans le champ de recherche.

payload.countrystring

Code pays à deux lettres du marché d’où part la question, par exemple US, KR ou JP. Par défaut US.

payload.pageinteger

Page de résultats à lire, de 1 à 10. Par défaut 1. position continue de compter d’une page à l’autre.

webhook.urlstring

Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.

idempotencyKeystring

Votre identifiant pour la requête. Chaque clé crée une seule tâche par compte : un envoi répété reste une seule tâche.

Réponse

Voici une tâche terminée, raccourcie pour la lecture.

{
  "success": true,
  "task": {
    "id": "323287e6-d4ef-4797-a337-f6c3b574b7ab",
    "taskType": "GOOGLE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:45:07.237Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "page": 1,
    "organicResults": [
      {
        "position": 1,
        "title": "8 Easy-to-Use Project Management Software Platforms for ...",
        "link": "https://ones.com/blog/8-easy-to-use-project-management-software-platforms-for-small-teams/?primary_category=knowledge",
        "snippet": "1 day ago — ONES.com came out on top for teams that need Jira-like power without the complexity, while Trello and Asana hold their ground for basic, visual ...",
        "page": 1
      }
    ],
    "peopleAlsoAsk": [
      { "question": "Does Microsoft Teams have a project management tool?" },
      {
        "question": "What is the best project management software for a small construction company?"
      }
    ]
  }
}

task.statusstring

QUEUED, PROCESSING, puis COMPLETED avec la réponse ou FAILED avec error.

credits.creditsChargedinteger

Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.

response.organicResultsarray

Les résultats de recherche de la page : position, title, link, snippet et page.

response.peopleAlsoAskarray

Les questions associées affichées par Google sur la page.

Rechercher sur Reddit

Envoyez REDDIT avec une query pour trouver des publications, ajoutez subreddit pour rester dans une communauté, ou envoyez l’url d’une publication pour la lire avec sa première page de commentaires.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "REDDIT",
    "payload": {
      "query": "best mechanical keyboard for programming",
      "country": "US"
    }
  }'

Voici une tâche terminée, raccourcie pour la lecture.

{
  "success": true,
  "task": {
    "id": "fe0a46a2-7bf1-4cd0-8183-d299dc421c70",
    "taskType": "REDDIT",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:47:44.384Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "results": [
      {
        "url": "https://www.reddit.com/r/MechanicalKeyboardsUK/comments/1qz6da6/best_silent_mechanical_keyboard_for_programming/",
        "title": "Best silent mechanical keyboard for programming?",
        "postId": "1qz6da6",
        "preview": "I currently have a mechanical keyboard but I often wake up in the middle of the night and it is quite loud so I can't use my computer because …",
        "subreddit": "MechanicalKeyboardsUK"
      }
    ]
  }
}

payload.subredditstring

Recherche dans un subreddit ; indiquez le nom qui suit r/.

payload.urlstring

L’adresse d’un post, https://www.reddit.com/r/{subreddit}/comments/{postId}/…. Lit le post et la première page de ses commentaires.

payload.commentSortstring

Ordre des commentaires : top (par défaut), new, controversial, old ou qa.

response.resultsarray

Les posts correspondant à la recherche : postId, title, url, subreddit et preview.

response.postobject

Avec l’url d’un post : titre, contenu, auteur, score et nombre de commentaires.

response.commentsobject

La première page de commentaires, environ 20 à 25, avec auteur, contenu, score et profondeur.

Recevoir le résultat

La requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Tarif

Chaque tâche terminée utilise 1 crédit.