ReleaseWire For Publishers

oEmbed

Using oEmbed, publishers can quickly embed press releases distributed by ReleaseWire onto their website.

Using oEmbed, a consumer application, will be able to automatically convert a web link to a press release hosted on ReleaseWire, into embedded content.

Consumer applications and libraries that support oEmbed, can be found for many programming languages including Javascript, PHP, Ruby, Perl and more.

Building An HTTP Request

The consumer who is requesting the embeded content must follow a standardized format while making the request. Requests sent to ReleaseWire's oEmbed API must use the HTTP GET protocol, with all arguments sent as query parameters. All arguments must be urlencoded.

Request Parameters

ParameterDescriptionDefault
urlREQUIRED: This is the URL of the press release to embed. It can either be the foll web address or the short web address.
maxwidthThis parameter will set the maximum width of the embeded content.
maxheightThis parameter will set the maximum height of the embeded content.
formatThis parameter will determine the response format of either "json" or "xml".json
showThis parameter controls how much of the press release is displayed. Valid options are "preview" and "full".preview
themeThis parameter controls what dispaly style is used. Valid options are "light" and "dark".light
nostyleIf this parameter is set to "false", no theme will be applied to the embeded content. Valid options are "true" and "false".false
nostyleIf this parameter is set to "false", no images will be included in the embeded content. Valid options are "true" and "false".false

Request Examples

This example uses the short web address for a press release.

http://publisher.releasewire.com/oembed/?url=http%3A%2F%2Frwire.com%2F536474

This example uses the full web address for a press release.

http://publisher.releasewire.com/oembed/?url=http%3A%2F%2Fwww.releasewire.com%2Fpress-releases%2Fsbwire-is-now-releasewire%2Frelease-536474.htm

Example Output

JSON Output

XML output is used when you pass "format=json" to the query or do not include the "format" option.

{
"version": "1.0",
"type": "rich",
"width": 0,
"height": 0,
"html": "<a rel=\"nofollow\" class=\"rwp-pr\" href=\"http:\/\/rwire.com\/536474\">With Increased Service for Businesses of All Sizes - SBWire Is Now ReleaseWire<\/a>\r\n<script>!function(){var e=\"rwp-platform\";if(!document.getElementById(e)){var t=document.createElement(\"script\");t.id=e,t.src=(\"https:\"===document.location.protocol?\"https\":\"http\")+\":\/\/publisher.releasewire.com\/embed.js\",t.async=!0,document.body.appendChild(t)}}();<\/script>",
"provider_name": "ReleaseWire",
"provider_url": "http:\/\/www.releasewire.com\/",
"title": "With Increased Service for Businesses of All Sizes - SBWire Is Now ReleaseWire",
"author_name": "ReleaseWire",
"author_url": "http:\/\/www.releasewire.com"
}

XML Output

XML output is used when you pass "format=xml" to the query.

<?xml version="1.0" encoding="utf-8"?>
<oembed>
<version>1.0</version>
<type>rich</type>
<width>0</width>
<height>0</height>
<html>&lt;a rel="nofollow" class="rwp-pr" href="http://rwire.com/536474"&gt;With Increased Service for Businesses of All Sizes - SBWire Is Now ReleaseWire&lt;/a&gt;&#13;
&lt;script&gt;!function(){var e="rwp-platform";if(!document.getElementById(e)){var t=document.createElement("script");t.id=e,t.src=("https:"===document.location.protocol?"https":"http")+"://publisher.releasewire.com/embed.js",t.async=!0,document.body.appendChild(t)}}();&lt;/script&gt;</html>
<provider_name>ReleaseWire</provider_name>
<provider_url>http://www.releasewire.com/</provider_url>
<title>With Increased Service for Businesses of All Sizes - SBWire Is Now ReleaseWire</title>
<author_name>ReleaseWire</author_name>
<author_url>http://www.releasewire.com</author_url>
</oembed>

Possible Errors

  • - 404 Not Found - The supplied URL was not found or embeding is not supported.
  • - 501 Not Implemented - The format supplied in the query string is not supported. Valid options are "json" and "xml".
  • - 401 Unauthorized - The URL is currently private or restricted.

A successful request will send a 200 status code.

Press Release - Preview Mode

SBWire Is Now ReleaseWire

Press Release - Full Mode

SBWire Is Now ReleaseWire