Atualizar post

Somente API

PATCH/v3/social-media/post

As solicitações para este endpoint são gratuitas e não consomem unidades da API.

Parâmetros de consulta

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Corpo da solicitação

post_idintegerRequired

Identificador único da postagem.

channel_idsarray<string>

Lista não vazia de IDs de canais para publicar a postagem.

text_contentstring

Conteúdo de texto da publicação.

timingstring

Quando publicar o post.

Allowed values:publish_nowscheduleddraft

scheduled_atstring

Registro de data e hora para posts agendados (obrigatório quando o timing for "scheduled") no formato ISO 8601. Os valores retornados estão em UTC.

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

auto_commentstring

Texto do comentário automático publicado após a publicação.

Respostas

postobject

author_idstring or null

Identificador único do autor.

author_namestring or null

Nome do autor.

auto_commentstring or null

Texto do comentário automático publicado após a publicação.

channelsarray<object>

Canais de mídia social associados à publicação.

channel_idstring

channel_kindstring

channel_usernamestring

channel_display_namestring

channel_profile_image_urlstring or null

created_atstring

Carimbo de data/hora em que o autor criou a publicação.

external_post_idstring or null

Identificador da postagem específico da plataforma.

permalinkstring or null

URL da publicação na plataforma.

post_idinteger

Identificador único da postagem.

status_timestampstring

Registro de data e hora associado ao status atual.

text_contentstring

Conteúdo de texto da publicação.

curl "https://api.ahrefs.com/v3/social-media/post" \ -X PATCH \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "post_id": 0, "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" } }