Docs
Rechercher dans la documentation...⌘K

Publications

API + MCP
GET/v3/social-media/posts

Les requêtes vers ce point de terminaison sont gratuites et ne consomment aucune unité d’API.

Paramètres de requête

statusstringObligatoire

L’étape du cycle de vie de publication de l’article.

Valeurs autorisées:publishedscheduleddraftfaileddeleted
channel_idsstring

Liste d’identifiants de canaux séparés par des virgules, à utiliser comme filtre.

author_idsstring

Liste d’identifiants d’utilisateurs auteurs séparés par des virgules, à utiliser comme filtre.

search_querystring

Requête de recherche textuelle permettant de filtrer les publications selon leur contenu.

date_fromstring (date)

Date de début de la période historique, au format AAAA-MM-JJ.

date_tostring (date)

Date de fin de la période historique, au format AAAA-MM-JJ.

order_bystring

Champ selon lequel trier les publications. Le tri basé sur des métriques ne s’applique qu’aux publications publiées.

Valeurs autorisées:dateviewsunique_viewscommentslikes
order_directionstring

L’ordre dans lequel les résultats sont renvoyés, par ordre croissant ou décroissant.

Valeurs autorisées:ascdesc
limitinteger

Nombre de résultats à renvoyer.

Par défaut:50
offsetinteger

Le nombre de résultats à ignorer.

Par défaut:0
outputstring

Le format de sortie.

Valeurs autorisées:jsonphp

Réponses

postsarray<object>
author_idstring or null

Identifiant unique de l’auteur.

author_namestring or null

Nom de l’auteur.

auto_commentstring or null

Texte du commentaire automatique publié après la publication du post.

channelsarray<object>

Canaux de réseaux sociaux associés à la publication.

channel_idstring
channel_kindstring
channel_usernamestring
channel_display_namestring
channel_profile_image_urlstring (url) or null
created_atstring (date-time)

Horodatage de la création du post par l’auteur.

external_post_idstring or null

Identifiant de publication spécifique à la plateforme.

permalinkstring or null

URL de la publication publiée sur la plateforme.

post_idinteger

Identifiant unique de la publication.

status_timestampstring

Horodatage associé au statut actuel.

text_contentstring

Contenu textuel de la publication.