Quels champs votre table peut-elle réellement utiliser ?

Examinez une petite réponse PostgreSQL avec Reddit Extract. Distinguez titre et texte, préservez les absences et définissez vos règles locales d’extraction.

Obtenir une clé API

Exemple de requête

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditextract.com/v1/search?q=index&subreddit=PostgreSQL&limit=3"

Extrait de réponse fictif

Démonstration uniquement : il ne s’agit pas de véritables enregistrements de l’archive.

{
  "data": [
    {
      "kind": "post",
      "subreddit": "PostgreSQL",
      "title": "Demo: checking an index",
      "text": "Fictional example for mapping available fields."
    }
  ]
}

Seul le champ data est affiché. Les champs renvoyés peuvent varier ; la réponse n’est pas complète.

Une requête PostgreSQL pour éprouver votre modèle

Votre table PostgreSQL peut exiger un corps de texte alors qu’un enregistrement ne fournit qu’un titre exploitable. Réglez ce cas avant d’élargir l’extraction. La petite recherche index sert à décider quoi copier, quoi laisser absent et quoi mettre de côté pour examen.

Reddit Extract donne accès à une archive historique indépendante de Reddit. L’API renvoie des enregistrements plats que votre application peut examiner, sélectionner et transformer. Elle ne fournit pas de données en direct et n’est pas un service officiel de Reddit. Une réponse ne garantit ni la présence de tous les champs attendus ni une couverture exhaustive de la communauté interrogée.

L’exemple de cette page utilise https://api.redditextract.com/v1/search?q=index&subreddit=PostgreSQL&limit=3. Le terme index délimite la recherche textuelle, subreddit désigne PostgreSQL et limit demande au plus trois enregistrements. Cette petite réponse sert à observer les données disponibles. Elle ne constitue pas un échantillon aléatoire, un classement des meilleures discussions ou une représentation complète du sujet.

Le titre ne remplace pas automatiquement le corps

Examinez title et text séparément lorsqu’ils sont présents. Si vous les réunissez ensuite dans une colonne, signalez qu’il s’agit d’un contenu dérivé et gardez son champ d’origine. Une correspondance avec index dans le titre ne prouve pas sa présence dans le corps. Employer le titre comme solution de repli reste un choix local, pas une reproduction du texte original.

Donner un sens précis aux absences

Un champ absent, une valeur null et une chaîne vide méritent des règles distinctes. Votre application peut choisir de les réunir dans une colonne facultative, à condition de garder la distinction utile à son usage. Vérifiez les types avant de convertir : zéro peut être une valeur de score présente, alors qu’une absence de score n’en est pas une.

Conservez la réponse reçue si vous souhaitez revoir vos choix de normalisation. Une date lisible dérivée de created_utc peut être enregistrée à côté de la valeur d’origine, après validation de celle-ci. De même, une version du texte dont les espaces ont été normalisés doit rester identifiable comme un résultat local. L’API ne certifie pas ce schéma de destination et ne réalise pas ces transformations pour vous.

Garder les références sans inventer la conversation

Les références parent_id et link_id peuvent servir à regrouper localement des éléments lorsqu’elles existent. Elles ne prouvent pas que leurs parents sont présents ni qu’une conversation est complète. Les résultats suivent l’ordre interne _doc, sans classement chronologique, par pertinence ou par score. Parcourir les pages ne supprime pas ces limites et ne garantit pas de reproduire exactement une extraction antérieure.

Aboutir à un contrat d’extraction utilisable

Chaque récupération réussie coûte un crédit, même si elle ne renvoie aucun enregistrement ou si votre validation locale les écarte tous. Le tarif est de 1 $ pour 1000 réussites; une recharge de 50 $ achète 50000 crédits payés. Consultez la documentation pour les filtres, puis le guide pour concevoir un schéma local et la page des tarifs pour dimensionner vos appels.

L’inspection doit produire un contrat bref : source de chaque colonne, états acceptés et traitement des rejets. Le guide permet d’éprouver ces règles sur une réponse enregistrée. La documentation précise les paramètres de récupération; la page de la clé prépare l’accès lorsque vous souhaitez lancer la requête depuis votre serveur. Les recherches de contenu sont limitées à 100 enregistrements par appel et 100 pages par requête, sans garantie de couverture complète.