Pular para o conteúdo

Provedor oEmbed do WordPress.com

Este texto foi traduzido usando IA. Se você deseja ver o texto original em inglês, clique aqui.

Cada post, página, anexo e vídeo do VideoPress hospedado no WordPress.com suporta o formato oEmbed por meio da nossa API pública oEmbed.

O que é o formato oEmbed?

O formato oEmbed permite incorporar uma representação de uma URL em sites de terceiros. A API oEmbed do WordPress.com permite que qualquer site exiba conteúdo incorporado (como fotos ou vídeos) do WordPress.com quando um usuário publica um link para esse recurso, sem precisar analisar o recurso diretamente.

Endpoint oEmbed

O endpoint da API oEmbed do WordPress.com está disponível em: https://public-api.wordpress.com/oembed/

Parâmetros de query string

A API oEmbed do WordPress.com suporta os seguintes parâmetros de query string:

  • for (obrigatório): o domínio solicitante ou nome do domínio ou empresa
  • url (obrigatório): a URL do recurso solicitado. Pode ser qualquer URL hospedada no WordPress.com, incluindo domínios e subdomínios wordpress.com, wp.me, videopress.com, ou qualquer domínio de nível superior hospedado no WordPress.com, por exemplo TechCrunch, CNN Press Room etc.
  • format: json ou xml, o padrão é json.
  • callback: quando usado com json, uma função de callback JavaScript que você deseja envolver ao redor da saída.
  • maxwidth: largura máxima para imagens/miniaturas, o padrão é 440px
  • maxheight: altura máxima para imagens/miniaturas, o padrão é 330px.
  • img_size: alternativa para definir maxwidth e/ou maxheight, passe como [largura]x[altura], o padrão é 440x330px.
  • as_article: true ou false, aciona a extensão não padrão de artigo para posts/páginas.

O parâmetro as_article aciona uma saída oEmbed não padrão do tipo type: article. Quando o conteúdo é servido como as_article, o conteúdo do artigo pode ser encontrado na propriedade body, em vez da propriedade padrão html. Outras propriedades não padrão, como related_topics, também estão disponíveis.

Recursos

  • no modo as_article, o conteúdo é removido de tags e limitado a um trecho de aproximadamente 256 caracteres.
  • no modo padrão (ou seja, as_article=false), o conteúdo é servido como markup completo, ou como trecho, se fornecido e definido pelo autor.
  • suporta posts e páginas como link/html ou article/body (veja o argumento as_article).
  • suporta anexos (imagens/mídia/documentos) como tipo link ou tipo photo para imagens (gif, jpg, jpeg, png).
  • a miniatura de posts e páginas é usada como thumbnail_url se presente; caso contrário, será retornada a primeira imagem do conteúdo.
  • imagens locais e remotas são redimensionadas e/ou recortadas para as dimensões desejadas, para consistência, e então armazenadas em cache (incluindo CDN) para maior velocidade.
  • suporta dados de geolocalização, quando disponibilizados pelo autor, por meio de propriedades personalizadas (geo_latitude, geo_longitude)
  • suporta related_topics no modo as_article (as_article=true).

Exemplos de resposta

Requisição básica, apenas parâmetros obrigatórios informados:

https://public-api.wordpress.com/oembed/?for=develop.wordpress.com&url=https://wordpress.com/pt-br/blog/2025/06/24/wordcamp-europe-2025-recap/

Resposta:

{
  "version": "1.0",
  "provider_name": "WordPress.com News",
  "provider_url": "http://en.blog.wordpress.com",
  "author_name": "Nick Schäferhoff",
  "author_url": "https://en.blog.wordpress.com/author/nschaeferhoff/",
  "title": "WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland",
  "html": "<blockquote class="wp-embedded-content" data-secret="g3Lu0xsMqa"><a href="https://en.blog.wordpress.com/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/">WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland</a></blockquote>https://en.blog.wordpress.com/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/embed/#?secret=g3Lu0xsMqa<script type="text/javascript">n/* <![CDATA[ */n/*! This file is auto-generated */n!function(d,l){"use strict";l.querySelector&&d.addEventListener&&"undefined"!=typeof URL&&(d.wp=d.wp||{},d.wp.receiveEmbedMessage||(d.wp.receiveEmbedMessage=function(e){var t=e.data;if((t||t.secret||t.message||t.value)&&!/[^a-zA-Z0-9]/.test(t.secret)){for(var s,r,n,a=l.querySelectorAll('iframe[data-secret="'+t.secret+'"]'),o=l.querySelectorAll('blockquote[data-secret="'+t.secret+'"]'),c=new RegExp("^https?:$","i"),i=0;i<o.length;i++)o[i].style.display="none";for(i=0;i<a.length;i++)s=a[i],e.source===s.contentWindow&&(s.removeAttribute("style"),"height"===t.message?(1e3<(r=parseInt(t.value,10))?r=1e3:~~r<200&&(r=200),s.height=r):"link"===t.message&&(r=new URL(s.getAttribute("src")),n=new URL(t.value),c.test(n.protocol))&&n.host===r.host&&l.activeElement===s&&(d.top.location.href=t.value))}},d.addEventListener("message",d.wp.receiveEmbedMessage,!1),l.addEventListener("DOMContentLoaded",function(){for(var e,t,s=l.querySelectorAll("iframe.wp-embedded-content"),r=0;r<s.length;r++)(t=(e=s[r]).getAttribute("data-secret"))||(t=Math.random().toString(36).substring(2,12),e.src+="#?secret="+t,e.setAttribute("data-secret",t)),e.contentWindow.postMessage({message:"ready",secret:t},"*")},!1)))}(window,document);n/* ]]> */n</script>n",
  "type": "rich",
  "thumbnail_url": "https://en-blog.files.wordpress.com/2025/06/wceu-2025-recap-header.jpg?fit=440%2C330",
  "thumbnail_width": null,
  "thumbnail_height": null
}

Modo as_article (as_article=true):

https://public-api.wordpress.com/oembed/?for=develop.wordpress.com&url=https://wordpress.com/pt-br/blog/2025/06/24/wordcamp-europe-2025-recap/&as_article=true

Resposta:

{
  "version": "1.0",
  "provider_name": "WordPress.com News",
  "provider_url": "http://en.blog.wordpress.com",
  "author_name": "Nick Schäferhoff",
  "author_url": "https://en.blog.wordpress.com/author/nschaeferhoff/",
  "title": "WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland",
  "type": "article",
  "body": "Couldn't make it to WordCamp Europe 2025? Don't worry. While nothing beats the experience of actually being there, this post will give you a detailed summary of some of the most important and meaningful presentations held at the conference.",
  "related_topics": "News",
  "thumbnail_url": "https://en-blog.files.wordpress.com/2025/06/wceu-2025-recap-header.jpg?fit=440%2C330",
  "thumbnail_width": null,
  "thumbnail_height": null
}

Solicitando um tamanho de imagem específico e formato xml

https://public-api.wordpress.com/oembed/?for=develop.wordpress.com&url=https://wordpress.com/pt-br/blog/2025/06/24/wordcamp-europe-2025-recap/&as_article=true&img_size=880x660&format=xml

Resposta:

<oembed>
    <version>
        <![CDATA[ 1.0 ]]>
    </version>
    <provider_name>
        <![CDATA[ WordPress.com News ]]>
    </provider_name>
    <provider_url>
        <![CDATA[ https://en.blog.wordpress.com ]]>
    </provider_url>
    <author_name>
        <![CDATA[ Nick Schäferhoff ]]>
    </author_name>
    <author_url>
        <![CDATA[ https://en.blog.wordpress.com/author/nschaeferhoff/ ]]>
    </author_url>
    <title>
        <![CDATA[ WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland ]]>
    </title>
    <type>
        <![CDATA[ article ]]>
    </type>
    <body>
        <![CDATA[ Couldn't make it to WordCamp Europe 2025? Don't worry. While nothing beats the experience of actually being there, this post will give you a detailed summary of some of the most important and meaningful presentations held at the conference. ]]>
    </body>
    <related_topics>
        <![CDATA[ News ]]>
    </related_topics>
    <thumbnail_url>
        <![CDATA[ https://en-blog.files.wordpress.com/2025/06/wceu-2025-recap-header.jpg?fit=880%2C660 ]]>
    </thumbnail_url>
    <thumbnail_width>
        <![CDATA[ ]]>
    </thumbnail_width>
    <thumbnail_height>
        <![CDATA[ ]]>
    </thumbnail_height>
</oembed>

Tags de cabeçalho

O WordPress.com também adiciona as tags de link relacionadas aos cabeçalhos do site, para posts, páginas e anexos (apenas para sites públicos), para que sites de terceiros possam descobrir automaticamente a representação oEmbed equivalente do seu conteúdo:

<link href="http://public-api.wordpress.com/oembed/?format=json&url=http:%2F%2Ftekartist.org%2F2011%2F07%2F13%2Fyourself-truly-by-emma%2F&for=wpcom-auto-discovery" rel="alternate" type="application/json+oembed" />
<link href="http://public-api.wordpress.com/oembed/?format=xml&url=http:%2F%2Ftekartist.org%2F2011%2F07%2F13%2Fyourself-truly-by-emma%2F&for=wpcom-auto-discovery" rel="alternate" type="application/xml+oembed" />

Última atualização: junho 19, 2026

Tudo pronto para começar a usar o WordPress.com?

Comece agora