api/trans/blurb topic

Also known as
  • Add other possible names for this topic
Edit

Name   blurb
Description   Gets a blurbified version of blobs via CDB
Accessible Via   /api/trans/blurb
HTTP GET   Yes
HTTP POST   No
Special Headers   None
Login Required   No
Required Arguments   id: guid of the content that the client wants

maxlength: maximum number of characters in the blurb, default is 200
break_paragraphs: break on paragraphs, default is True

Optional Arguments   None
Extra Arguments Ignored   Yes
Response Format   Same as the content-type or media type of the content object being requested
Notes   Rules
  1. Only content whose content-type and/or media-type is of the form text/.... is processed. In all other cases it will throw an exception.
  2. The service strips all html tags from the text before passing it back to the client.
  3. If the content is an html document only the contents of the <p> tag are processed. Contents of all other tags are discarded.
  4. If the content is a wikipedia document, a pre-rendered blurb is requested. If the blurb is not found an error is returned.
For additional information on using the callback parameter to generate a JSONP response, or using onsucceed and onfail to redirect to a URI template, see Common API Query Parameters.
Examples:

http://www.freebase.com/api/trans/blurb/guid/9202a8c04000641f800000000001daf5?maxlength=1200

http://www.freebase.com/api/trans/blurb/guid/9202a8c04000641f800000000001daf5?maxlength=30&callback=foo

Edit description

-

Freebase

Freebase API service
more options
2 empty fields
Edit
Status
Edit
Accessible via
  • /api/trans/blurb
Edit
Login required
  • No
Edit
Permits HTTP GET
  • Yes
Edit
Permits HTTP POST
  • No
Edit
 
Special headers
Edit
 
Arguments
argument
argument type
format
default value
  • false
  • 200
detail view »
Edit
Extra arguments ignored
  • Yes
Edit
Response type
With the exception of Wikipedia summaries and some images the content on this page is typically distributed under the Creative Commons Attribution license or Public Domain.
skud
Created by skud Dec 17, 2007
philg
Last edited by philg Jul 30, 2008
View topic history »
Gallery add edit
There are no images for this topic yet.

Recent Discussions about api/trans/blurb

There are no conversations on this topic. Would you like to start one?

Start the Discussion »