Créer une publication

API uniquement

POST/v3/social-media/post

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

Paramètres de requête

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Corps de la requête

channel_idsarray<string>Required

Liste non vide d'identifiants de canaux dans lesquels publier la publication.

text_contentstringRequired

Contenu textuel de la publication.

timingstringRequired

Quand publier le post.

Allowed values:publish_nowscheduleddraft

scheduled_atstring

Horodatage des posts planifiés (obligatoire lorsque « timing » est défini sur « scheduled ») au format ISO 8601. Les valeurs renvoyées sont en UTC.

Example:2026-01-01T12:00:00Z

auto_commentstring

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

Réponses

postobject

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 or null

created_atstring

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

external_post_idstring or null

Identifiant de publication propre à 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.

curl "https://api.ahrefs.com/v3/social-media/post" \ -X POST \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "channel_ids": ["string"], "text_content": "string", "timing": "publish_now", "scheduled_at": "2026-01-01T12:00:00Z", "auto_comment": "string" }'

{ "post": { "author_id": "string", "author_name": "string", "auto_comment": "string", "channels": [ { "channel_id": "string", "channel_kind": "string", "channel_username": "string", "channel_display_name": "string", "channel_profile_image_url": "string" } ], "created_at": "string", "external_post_id": "string", "permalink": "string", "post_id": 0, "status_timestamp": "string", "text_content": "string" } }