Articles

Using the Univision Articles API, anybody is capable of constructing their own custom feeds for Univision  stories . Stories may be retrieved a number of ways, including pulling  content by site, employing either basic search or tag search. All article feeds are available in both RSS and JSON formatting. Please refer to our documentation below which describes in detail how data can be requested and returned.

Supported Parameters

* Note that parameters are case-sensitive and must be entered exactly as specified below.

count - The number of items to retrieve. If no count is specified, the default number of items will be set to 20. The maximum setting allowed it 100.

site - Filter items to a specific Univision site. The site value should correspond to the word before the first period in a Univision domain. For example, to retrieve content from futbol.univision.com, use site=futbol. Click here to see a list of all available sites. 

source - Filter items to a specific source. (List of available source parameters coming soon)

fromDate - Filter items from a specific date of the format YYYY-MM-DD. For example, to retrieve content from August 1, 2010, use fromDate=2010-08-01

toDate - Filter items until a specific date of the format YYYY-MM-DD. For example, to retrieve content until October 1, 2011, use fromDate=2011-10-01

tags - Filter items to the tags specified. Spaces are allowed, and multiple tags are delimited by commas. For example, to retrieve content relevant to Jennifer Lopez and Marc Anthony, use tags=Jennifer Lopez,Marc Anthony

text - Filter items using a full-text search - this parameter is recommended for basic search as it conducts a more thourough search of our content.

Wirefeed Parameters

The following wirefeed parameters can also be specified

wf_slug - Filter items to a wirefeed slug

wf_country - Filter items to a wirefeed country

wf_city - Filter items to a wirefeed city

wf_geocode - Filter items to a wirefeed geocode

wf_category - Filter items to a wirefeed category

wf_subcategory - Filter items to a wirefeed subcategory

wf_service - Filter items to a wirefeed service

 

Sample Search URL

Get the latest 3 Shakira articles from the musica.univision.com website

/search/articles?count=3&site=musica&tags=shakira

 

Sample Final Request

http://apiservice.univision.com/rest/feed/getFeed?url=%2Fsearch%2Farticles%3Fcount%3D3%26site%3Dmusica%26tags%3Dshakira&api_key=<your api key>	  											

Sample Json Output

{    "uimJson": {        
	 "image":{           
		 "url": "http://u.univision.com/contentroot/uol/art/systemimages/v2/Portal/search_box_interum_header/portal_uol_logo_flat.gif",            
		 "title": "Articles Search",            
		 "description": "Articles Search",            
		 "link": []        
		 },
         "title": "Articles Search",        
	 "description": "Articles Search",        
	 "link": [],        
	 "pubDate": "Tue, 05 Jun 2012 17:16:33 EDT",        
	 "item": {            
		 "title": "Siguen dando de qué hablar los 'Vatileaks'",            
		 "description": "El Vaticano sustituyó temporalmente a Paolo Gabriele, el mayordomo papal sospechoso de robar documentos confidenciales de Benedicto XVI y filtrarlos.",            
		 "link": "http://noticias.univision.com/mundo/noticias/article/2012-06-05/los-vatileaks-declaraciones-mayordomo",            
		 "pubDate": "Tue, 05 Jun 2012 16:35:00 EDT",            
		 "guid": "article-1082996-1338928500",            
		 "uol_id": "article1082996",            
		 "uol_xmlUrl": "http://feedsyn.univision.com/contentXml?cid=1082996&contentType=article&ts=20120605165613&partner=test&outputMode=json",            
		 "uol_modifiedAt": "2012-06-05 16:56:13 EDT",            
		 "uol_contentType": "article",            
		 "uol_thumbnail": "http://s0.uvnimg.com/noticias/mundo/fotos/photo/2012-05-26/el-vaticano-confirma-que-el_88x59.jpg",            
		 "media_thumbnail": {                
			 "@attributes": {                    
					 "url": "http://s0.uvnimg.com/noticias/mundo/fotos/photo/2012-05-26/el-vaticano-confirma-que-el_88x59.jpg"
	                		}            
		 },            
		 "uol_largeImage": "http://hres.univision.com/noticias/mundo/fotos/photo/2012-05-26/el-vaticano-confirma-que-el_1024x768.jpg",            
		 "uol_largeThumbnail": "http://s0.uvnimg.com/noticias/mundo/fotos/photo/2012-05-26/el-vaticano-confirma-que-el_164x110.jpg",            
		 "uol_regularImage": "http://s0.uvnimg.com/noticias/mundo/fotos/photo/2012-05-26/el-vaticano-confirma-que-el_323x216.jpg",            
		 "uol_mobileUrl": "http://m.noticias.univision.com/mundo/noticias/article/2012-06-05/los-vatileaks-declaraciones-mayordomo?id=1082996&ts=20120605165613"        
		 }    
	   }
 }
                 											

 Note: Mobile developers could use the uol_mobileUrl to the article on the movil site.