LinkedIn Profile Posts
Le fil associé à un profil LinkedIn peut contenir des publications rédigées par le membre, des republications, des articles, des images, des vidéos, des documents et d’autres activités publiques de sa page. Les enregistrements renvoyés constituent un échantillon à la date de collecte pour l’étude de contenus, sans représenter un historique complet d’activité, des statistiques privées ni une visibilité réservée aux relations.
Fonctionnalités de la LinkedIn Profile Posts API
- Découverte à partir d’URL de profilsAcceptez une ou plusieurs URL LinkedIn publiques /in/ et découvrez les publications associées à chaque profil envoyé.
- Filtrage facultatif des publications rédigéesTransmettez only_authored_posts pour réduire l’activité associée aux publications que le fournisseur identifie comme rédigées par le profil ciblé.
- Fenêtres de dates du fournisseurTransmettez les chaînes facultatives start_date et end_date pour un filtrage côté fournisseur, sans imposer de format, d’ordre, d’inclusion des bornes ni de fuseau horaire en local.
- Contexte de contenu normaliséRenvoie le texte de la publication, les champs d’auteur, la date de publication, les médias, les hashtags, les mentions et l’URL source disponibles, dans un schéma de publication stable.
- Instantanés de l’engagement visibleGardez les mentions J’aime, commentaires, partages et vues disponibles avec collected_at, pour que les mesures restent liées à leur date d’observation.
Paramètres de la LinkedIn Profile Posts API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire d’URL de profils LinkedIn publics, sur des hôtes LinkedIn, avec des chemins commençant par /in/. |
start_date | Facultatif | Chaîne facultative et non vide de filtre de date du fournisseur, transmise pour chaque profil d’entrée ; SocQ n’analyse ni ne valide son format ni l’inclusion des bornes. |
end_date | Facultatif | Chaîne facultative et non vide de filtre de date du fournisseur, transmise pour chaque profil d’entrée ; SocQ ne vérifie pas son ordre par rapport à start_date. |
only_authored_posts | Facultatif | Booléen facultatif transmis pour chaque profil ; true demande les publications que le fournisseur identifie comme rédigées, mais ne constitue pas un audit d’identité côté SocQ. |
results_limit | Facultatif | Entier facultatif de 1 à 2 000, appliqué séparément à chaque URL de profil, avec 100 par profil par défaut. |
Comment utiliser la LinkedIn Profile Posts API
Envoyez des URL de profils et des contrôles de découverte, suivez la tâche asynchrone et parcourez page par page les publications normalisées stockées.
- Préparez une ou plusieurs URL de profils LinkedIn publics dont le chemin commence par /in/.
- Choisissez only_authored_posts et un results_limit de 1 à 2 000 pour chaque profil ; ajoutez des chaînes de date du fournisseur seulement si nécessaire.
- Envoyez la requête en POST à /v1/linkedin/profile-posts et interrogez /v1/tasks/{task_id} jusqu’à la réussite ou l’échec.
- Lisez data.results.items et poursuivez avec next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/linkedin/profile-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/in/satyanadella/"],"only_authored_posts":true,"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la LinkedIn Profile Posts API
- Revue de la communication publique : Étudiez sujets, affirmations, liens et formulations récurrentes dans les publications renvoyées, associées à des profils professionnels choisis.
- Échantillonnage de contenus rédigés : Utilisez only_authored_posts pour demander un échantillon plus restreint, puis inspectez les champs d’auteur renvoyés chaque fois que la paternité compte.
- Étude des formats et des médias : Comparez les types d’images, de vidéos, de documents, d’articles, de hashtags et de mentions disponibles dans un ensemble défini d’enregistrements renvoyés.
- Instantanés d’engagement sur une période : Appliquez des chaînes de date du fournisseur et comparez l’engagement visible uniquement au sein de l’échantillon collecté, en conservant published_at et collected_at.
Conseils d’expert pour la LinkedIn Profile Posts API
- Voyez results_limit comme un plafond par profil : cinq URL avec une limite de 20 peuvent stocker jusqu’à 100 publications.
- Gardez les dates comme des chaînes du fournisseur et documentez votre propre convention, car SocQ ne valide ni leur format, ni leur ordre, ni leurs bornes, ni leur fuseau horaire.
- Vérifiez l’auteur renvoyé lorsque only_authored_posts est important ; l’indicateur demande un filtrage au fournisseur, il ne prouve pas l’identité.
- Conservez collected_at à côté des métriques d’engagement, car les nombres visibles peuvent changer d’une exécution à l’autre.
- Distinguez null et zéro pour les horodatages et les métriques, et admettez que médias, hashtags ou mentions soient vides.
- Ne déduisez ni expertise, ni statut professionnel, ni sentiment, ni qualité de prospect, ni influence, ni efficacité d’un contenu à partir du seul échantillon normalisé.
API associées
En complément de la LinkedIn Profile Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques LinkedIn.
- LinkedIn Profiles API — Normalisez l’identité publique d’un profil, ses postes, localisation, nombres d’audience visibles, expérience, formation et compétences à partir d’URL de profils.
- LinkedIn Companies API — Normalisez les descriptions publiques d’entreprises, sites web, logos, nombres visibles d’abonnés et d’employés, secteurs, localisations et spécialités.
- LinkedIn Posts API — Collectez le texte des publications publiques, auteurs, l’engagement visible, médias, date de publication, type et hashtags à partir d’URL prises en charge.
- LinkedIn Company Posts API — Repérez les publications publiques à partir d’URL de pages d’entreprises LinkedIn, avec texte, contexte de l’auteur, médias, hashtags, horodatages et engagement visible.
- LinkedIn Post Comments API — Collectez les commentaires publics exposés avec une publication LinkedIn connue, dont texte, contexte de l’auteur, horodatages, ID de relation et nombres visibles de mentions J’aime et de réponses.
- LinkedIn Video Transcript API — Transformez en texte les sous-titres des vidéos LinkedIn à partir des URL des publications qui les contiennent.