curl --request GET \
--url https://api.buttercms.com/v2/feeds/atom/ \
--header 'Authorization: <api-key>'import requests
url = "https://api.buttercms.com/v2/feeds/atom/"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.buttercms.com/v2/feeds/atom/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.buttercms.com/v2/feeds/atom/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.buttercms.com/v2/feeds/atom/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.buttercms.com/v2/feeds/atom/")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.buttercms.com/v2/feeds/atom/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<feed xmlns=\"http://www.w3.org/2005/Atom\" xml:lang=\"en-us\">\n <title>Latest blog posts</title>\n <link href=\"https://example.buttercms.com/blog/rss/\" rel=\"alternate\" />\n <link href=\"https://example.buttercms.com/blog/atom/\" rel=\"self\" />\n <id>https://example.buttercms.com/blog/rss/</id>\n <updated>2024-01-15T10:00:00Z</updated>\n <entry>\n <title>API Development Best Practices for 2024</title>\n <link href=\"https://example.buttercms.com/blog/api-development-best-practices\" rel=\"alternate\" />\n <published>2024-01-15T10:00:00Z</published>\n <updated>2024-01-15T10:00:00Z</updated>\n <author>\n <name>John Developer</name>\n </author>\n <id>https://example.buttercms.com/blog/api-development-best-practices</id>\n <summary type=\"html\">Learn the essential best practices for building scalable and maintainable APIs in 2024.</summary>\n </entry>\n <entry>\n <title>RESTful API Design Principles</title>\n <link href=\"https://example.buttercms.com/blog/restful-api-design-principles\" rel=\"alternate\" />\n <published>2024-01-12T09:00:00Z</published>\n <updated>2024-01-12T09:00:00Z</updated>\n <author>\n <name>Sarah Architect</name>\n </author>\n <id>https://example.buttercms.com/blog/restful-api-design-principles</id>\n <summary type=\"html\">Master the fundamental principles of RESTful API design for better developer experience.</summary>\n </entry>\n</feed>\n"Atom Feed
Generate a compliant Atom 1.0 XML feed for blog content with filtering capabilities for content syndication.
curl --request GET \
--url https://api.buttercms.com/v2/feeds/atom/ \
--header 'Authorization: <api-key>'import requests
url = "https://api.buttercms.com/v2/feeds/atom/"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.buttercms.com/v2/feeds/atom/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.buttercms.com/v2/feeds/atom/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.buttercms.com/v2/feeds/atom/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.buttercms.com/v2/feeds/atom/")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.buttercms.com/v2/feeds/atom/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<feed xmlns=\"http://www.w3.org/2005/Atom\" xml:lang=\"en-us\">\n <title>Latest blog posts</title>\n <link href=\"https://example.buttercms.com/blog/rss/\" rel=\"alternate\" />\n <link href=\"https://example.buttercms.com/blog/atom/\" rel=\"self\" />\n <id>https://example.buttercms.com/blog/rss/</id>\n <updated>2024-01-15T10:00:00Z</updated>\n <entry>\n <title>API Development Best Practices for 2024</title>\n <link href=\"https://example.buttercms.com/blog/api-development-best-practices\" rel=\"alternate\" />\n <published>2024-01-15T10:00:00Z</published>\n <updated>2024-01-15T10:00:00Z</updated>\n <author>\n <name>John Developer</name>\n </author>\n <id>https://example.buttercms.com/blog/api-development-best-practices</id>\n <summary type=\"html\">Learn the essential best practices for building scalable and maintainable APIs in 2024.</summary>\n </entry>\n <entry>\n <title>RESTful API Design Principles</title>\n <link href=\"https://example.buttercms.com/blog/restful-api-design-principles\" rel=\"alternate\" />\n <published>2024-01-12T09:00:00Z</published>\n <updated>2024-01-12T09:00:00Z</updated>\n <author>\n <name>Sarah Architect</name>\n </author>\n <id>https://example.buttercms.com/blog/restful-api-design-principles</id>\n <summary type=\"html\">Master the fundamental principles of RESTful API design for better developer experience.</summary>\n </entry>\n</feed>\n"Authorizations
Set the Authorization header to Token your_read_api_token.
Example: Authorization: Token abc123def456
Note: The header value includes the Token prefix.
You can access your API token from your settings page.
Query Parameters
Your ButterCMS read API token
Filter the Atom feed to include only posts from a specific category.
Provide the URL-friendly slug of the category. When specified, only blog posts assigned to this category will be included in the Atom feed.
Filter the Atom feed to include only posts with a specific tag.
Provide the URL-friendly slug of the tag. When specified, only blog posts tagged with this tag will be included in the Atom feed.
Return only posts in the given locale (e.g. en, es) in the feed. When omitted, defaults to your organization's default locale.
Returns 400 if the value is not a locale configured on your organization.
10Response
Atom feed generated successfully
Complete Atom 1.0 XML feed with blog posts
Was this page helpful?