Actualizar publicación

Solo API

PATCH/v3/social-media/post

Las solicitudes a este endpoint son gratuitas y no consumen ninguna unidad de API.

Parámetros de consulta

outputstring

El formato de salida.

Valores permitidos:jsoncsvxmlphp

Cuerpo de la solicitud

post_idintegerRequired

Identificador único de la publicación.

channel_idsarray<string>

Lista no vacía de IDs de canales en los que publicar la entrada.

text_contentstring

Contenido de texto de la publicación.

timingstring

Cuándo publicar la publicación.

Allowed values:publish_nowscheduleddraft

scheduled_atstring

Marca de tiempo para publicaciones programadas (obligatoria cuando la programación es "scheduled") en formato ISO 8601. Los valores devueltos están en UTC.

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

auto_commentstring

Texto del comentario automático publicado tras la publicación.

Respuestas

postobject

author_idstring or null

Identificador único del autor.

author_namestring or null

Nombre del autor.

auto_commentstring or null

Texto del comentario automático publicado tras la publicación.

channelsarray<object>

Canales de redes sociales asociados a la publicación.

channel_idstring

channel_kindstring

channel_usernamestring

channel_display_namestring

channel_profile_image_urlstring or null

created_atstring

Marca de tiempo de cuando el autor creó la publicación.

external_post_idstring or null

Identificador de publicación específico de la plataforma.

permalinkstring or null

URL de la publicación en la plataforma.

post_idinteger

Identificador único de la publicación.

status_timestampstring

Marca de tiempo asociada al estado actual.

text_contentstring

Contenido de texto de la publicación.

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" } }