Los feeds de Blogger son archivos que contienen información sobre las entradas, comentarios, etiquetas y demás. Son muy útiles para obtener y procesar información de un blog, ademas de que existe una variedad de parámetros que se pueden utilizar para personalizar la información de respuesta a las consultas.
URL de los feeds
Los feeds se ponen a disposición mediante 4 formas diferentes. La primera se obtiene mediante la url del blog, la segunda corresponde a los archivos xml (rss y atom), la tercera se obtiene desde el dominio de Blogger.com usando la id del blog y la cuarta corresponde a la API v3 de Blogger, la cual no se explicará en este post, pero puedes encontrar información en la documentación oficial.
https://BLOG_URL/feeds/posts/default
https://BLOG_URL/feeds/posts/default/POST_ID
https://BLOG_URL/feeds/pages/default
https://BLOG_URL/feeds/pages/default/PAGE_ID
https://BLOG_URL/feeds/comments/default
https://BLOG_URL/feeds/ITEM_ID/comments/default
https://BLOG_URL/rss.xml
https://BLOG_URL/atom.xml
https://www.blogger.com/feeds/BLOG_ID/posts/default
https://www.blogger.com/feeds/BLOG_ID/posts/default/POST_ID
https://www.blogger.com/feeds/BLOG_ID/pages/default
https://www.blogger.com/feeds/BLOG_ID/pages/default/PAGE_ID
https://www.blogger.com/feeds/BLOG_ID/comments/default
https://www.blogger.com/feeds/BLOG_ID/ITEM_ID/comments/default
https://www.blogger.com/feeds/BLOG_ID/ITEM_ID/comments/default/COMMENT_ID
https://www.googleapis.com/blogger/v3/blogs/BLOG_ID?key=API_KEY
En el tipo Blog y XML no encontraremos diferencias, pero en la API v2 la principal ventaja es que se puede obtener información del feed tipo posts de cualquier blog de Blogger, incluso si este se encuentra en modo privado, además se pueden obtener hasta 500 entradas por consulta, en comparación de las 150 de las demás.
En este post los ejemplos se escribirán usando la url del blog (recomendada), pero se aplican a todas las formas mencionadas. Por otro lado, en la siguiente tabla puede ver con que se reemplaza cada uno de los marcadores de posición de los ejemplos:
Marcador de posición | Descripción |
---|---|
BLOG_URL |
Url del blog |
BLOG_ID |
Id del blog |
POST_ID |
Id de la entrada |
PAGE_ID |
Id de la página estática |
ITEM_ID |
Id de la entrada o página estática |
COMMENT_ID |
Id del comentario |
Tipos de contenido
Independientemente de la url que se utilice, se puede configurar la cantidad de información que se obtiene del contenido de las entradas, páginas y comentarios. Para ello, la ruta de la url se puede modificar:
https://BLOG_URL/feeds/posts/default
https://BLOG_URL/feeds/posts/summary
https://BLOG_URL/feeds/posts/full
default
Este es el tipo de resumen por defecto, el cual está basado en la configuración del blog, ubicado en la sección Configuración en el apartado Feed del sitio. Esta opción siempre estará disponible.
summary
Este tipo de resumen muestra una versión resumida del contenido de la entrada. Independientemente de la configuración del blog este tipo de resumen siempre estará disponible siempre que los feeds no se hayan deshabilitado expresamente.
full
Este tipo de resumen muestra el contenido completo de la entrada. No está disponible si la configuración de los feeds del blog está especificada como Corto.
Parámetros de consulta
Además de los tipos de resumen, se pueden utilizar parámetros de consulta para personalizar la información que se desea obtener. La siguiente tabla muestra los parámetros de consulta que se pueden utilizar:
Parámetro | Descripción |
---|---|
alt |
Formato de la respuesta. |
category |
Etiqueta de una entrada. No disponible si q está presente. |
callback |
Nombre de la función de devolución de llamada. |
max-results |
Cantidad máxima de resultados. (máximo 150 , Api v2 maximo 500 ). |
orderby |
Ordenar los resultados (published o updated ). |
published-min |
Fecha y hora mínima de publicación de las entradas. |
published-max |
Fecha y hora máxima de publicación de las entradas. |
q |
Consulta de búsqueda. No disponible si category está presente. |
updated-min |
Fecha y hora mínima de actualización de las entradas. |
updated-max |
Fecha y hora máxima de actualización de las entradas. |
Nota: Los parámetros explicados en esta tabla son los que se tratan en este post, pero existen otros parámetros que puedes consultar en el artículo Blog Feeds de BloggerCode.
alt
Este parámetro se utiliza para especificar el formato de la respuesta. Es muy útil si se desea obtener la información en un formato diferente al que se obtiene por defecto (atom). Los valores posibles son atom
, rss
, json
, atom-in-script
, rss-in-script
y json-in-script
:
https://BLOG_URL/feeds/posts/default?alt=json
category
Se utiliza para obtener las entradas que contienen una etiqueta específica. Cuando se utiliza este parámetro, no se puede utilizar el parámetro q
. También puedes especificar varias etiquetas separadas por comas, sin embargo, la consulta solo contendrá las entradas que tienen todas las etiquetas especificadas a la vez:
https://BLOG_URL/feeds/posts/default?category=blogger
https://BLOG_URL/feeds/posts/default?category=blogger,code
callback
Este parámetro se utiliza para especificar el nombre de la función de devolución de llamada, lo cual es muy útil si se desea obtener la información en formato JSONP:
https://BLOG_URL/feeds/posts/default?callback=myFunction
function myFunction(data) {
console.log(data);
}
max-results
Se utiliza para especificar el número máximo de resultados a devolver. El valor predeterminado (cuando no se especifica) es 25
y el valor máximo es 150
. Si se desea obtener más de 150
resultados, se debe utilizar en combinación con el parámetro start-index
(ver más adelante):
https://BLOG_URL/feeds/posts/default?max-results=50
orderby
Se utiliza para ordenar los resultados. Los valores posibles son published
y updated
. El valor predeterminado es published
cuando no se especifica:
https://BLOG_URL/feeds/posts/default?orderby=updated
published-min
Se utiliza para especificar la fecha y hora mínima de publicación de las entradas. Cuando se utiliza este parámetro, solo se obtendrán las entradas que se hayan publicado después de la fecha y hora especificadas. El valor debe tener el formato YYYY-MM-DDTHH:MM:SS
:
https://BLOG_URL/feeds/posts/default?published-min=2022-01-01T00:00:00
published-max
Se utiliza para especificar la fecha y hora máxima de publicación de las entradas. Cuando se utiliza este parámetro, solo se obtendrán las entradas que se hayan publicado antes de la fecha y hora especificadas. El valor debe tener el formato YYYY-MM-DDTHH:MM:SS
:
https://BLOG_URL/feeds/posts/default?published-max=2022-12-31T23:59:59
q
Se utiliza para realizar una consulta de búsqueda. Cuando este parámetro está presente, no se puede utilizar el parámetro category
:
https://BLOG_URL/feeds/posts/default?q=feed
updated-min
Se utiliza para especificar la fecha y hora mínima de actualización de las entradas. Cuando se utiliza este parámetro, solo se obtendrán las entradas que se hayan actualizado después de la fecha y hora especificadas. El valor debe tener el formato YYYY-MM-DDTHH:MM:SS
:
https://BLOG_URL/feeds/posts/default?updated-min=2022-01-01T00:00:00
updated-max
Se utiliza para especificar la fecha y hora máxima de actualización de las entradas. Cuando se utiliza este parámetro, solo se obtendrán las entradas que se hayan actualizado antes de la fecha y hora especificadas. El valor debe tener el formato YYYY-MM-DDTHH:MM:SS
:
https://BLOG_URL/feeds/posts/default?updated-max=2022-12-31T23:59:59
start-index
Se utiliza para especificar el índice de inicio de los resultados. El valor predeterminado es 1
:
https://BLOG_URL/feeds/posts/default?start-index=26
Filtros de búsqueda
Además de los parámetros de consulta, se pueden utilizar filtros de búsqueda para personalizar la información que se desea obtener. Estos filtros son exclusivos del parámetro q
y se pueden utilizar en combinación con los parámetros de consulta.
Filtro | Descripción |
---|---|
label |
Nombre de la etiqueta de las entradas. |
title |
Título de las entradas. |
content |
Contenido de las entradas. |
body |
Cuerpo de las entradas. |
label
Este filtro se utiliza para buscar entradas con una o varias etiquetas específicas. Por ejemplo, si se desea buscar entradas con una etiqueta específica:
https://BLOG_URL/feeds/posts/default?q=label:code
Si deseas buscar entradas con todas las etiquetas especificadas, puedes utilizar el filtro label
varias veces con el operador +
o %20
entre ellas:
https://BLOG_URL/feeds/posts/default?q=label:code+label:blogger
Si por el contrario deseas buscar entradas con al menos una de las etiquetas especificadas, puedes utilizar el operador |
o %7C
entre ellas:
https://BLOG_URL/feeds/posts/default?q=label:code|label:blogger
Nota: Si las etiquetas especificadas en los filtros label
contienen espacios, se deben especificar entre comillas dobles en la consulta, por ejemplo label:"web devs"
title
Este filtro se utiliza para buscar entradas con un título específico. Cuando se utiliza este filtro, la consulta solo buscará los términos especificados en el título de las entradas:
https://BLOG_URL/feeds/posts/default?q=title:feed
content
Este filtro se utiliza para buscar entradas con un contenido específico. Los términos especificados se buscarán en el contenido de las entradas, incluyendo en el título:
https://BLOG_URL/feeds/posts/default?q=content:feed
body
Similar al filtro content
, este filtro se utiliza para buscar términos basado en el contenido, con la diferencia de que los términos especificados se buscarán solo en el cuerpo y no tomará en cuenta el título:
https://BLOG_URL/feeds/posts/default?q=body:feed
Feeds de etiquetas
Además de los feeds de entradas, páginas y comentarios, Blogger también proporciona feeds de etiquetas, los cuales se crean automáticamente cuando se asigna una etiqueta a una entrada:
https://BLOG_URL/feeds/posts/default/-/LABEL
https://BLOG_URL/feeds/posts/default/-/LABEL/LABEL/LABEL
Conclusión
Los feeds de Blogger son una excelente forma de obtener información de un blog de forma automática. Además, la variedad de parámetros de consulta y filtros de búsqueda permiten personalizar la información que se desea obtener.
Espero que este artículo te haya sido de utilidad y si tienes alguna duda o sugerencia, no dudes en dejar un comentario. Muchas gracias por leerme.