Add RSS Feed

Add a new RSS feed for automated posting of new articles

POST /feed

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"url": "https://www.nytimes.com"}' \
-X POST https://api.ayrshare.com/api/feed

const API_KEY = "API_KEY";
const url = "https:///www.nytimes.com";

fetch("https://api.ayrshare.com/api/feed", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${API_KEY}`
  },
  body: JSON.stringify({ url })
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

import requests

payload = {'url': 'https://www.nytimes.com'}
headers = {'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'}

r = requests.post('https://api.ayrshare.com/api/feed',
    json=payload,
    headers=headers)

print(r.json())

$curl = curl_init();

$data = array (
    'url' => 'https://www.nytimes.com'
);

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.ayrshare.com/api/feed',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => http_build_query($data),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer API_KEY'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

200: Success

{
  "status": "success",
  "id": "4HZhptaD5",
  "title": "Pulte's Money and Life Thoughts",
  "websiteLink": "https://pulte.substack.com",
  "rssURL": "https://pulte.substack.com/feed"
}

{
  "action": "create",
  "status": "error",
  "code": 303,
  "message": "The feed https://ruthreichl.substack.com/feed already exists.",
  "id": "TDW3oMDoI"
}

{
  "action": "create",
  "status": "error",
  "code": 130,
  "message": "Something is wrong with the RSS feed URL. Please verify it."
}

Add a new RSS feed for automated posting of new articles. Posts will be automatically sent to your linked social accounts: Facebook, LinkedIn, and Telegram. Also Instagram and Pinterest if a valid image can be found in the article.

X/Twitter is no longer supported for RSS feeds. As of March 31, 2026, X requires your own API credentials for each request, which is incompatible with automated RSS posting. Use scheduled posts or direct API calls with your BYO credentials instead.

Header Parameters

Body Parameters

url · string · required

URL of the RSS feed to add.

useFirstImage · boolean · default: false

Attempt to get the first or top image in the article and add it to the post.

autoHashtag · boolean · default: false

Automatically add up to 3 hashtags to the post text based on the most relevant keywords.

type · string · default: "rss"

Value: rss, substack, or youtube.

platforms · array

Social network platforms to publish the article. If not provided, defaults to all connected platforms. Available platforms:

{
  "platforms": ["facebook", "instagram", 
    "linkedin", "pinterest"]
}

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"url": "https://www.nytimes.com"}' \
-X POST https://api.ayrshare.com/api/feed

const API_KEY = "API_KEY";
const url = "https:///www.nytimes.com";

fetch("https://api.ayrshare.com/api/feed", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${API_KEY}`
  },
  body: JSON.stringify({ url })
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

import requests

payload = {'url': 'https://www.nytimes.com'}
headers = {'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'}

r = requests.post('https://api.ayrshare.com/api/feed',
    json=payload,
    headers=headers)

print(r.json())

$curl = curl_init();

$data = array (
    'url' => 'https://www.nytimes.com'
);

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.ayrshare.com/api/feed',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => http_build_query($data),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer API_KEY'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

200: Success

{
  "status": "success",
  "id": "4HZhptaD5",
  "title": "Pulte's Money and Life Thoughts",
  "websiteLink": "https://pulte.substack.com",
  "rssURL": "https://pulte.substack.com/feed"
}

{
  "action": "create",
  "status": "error",
  "code": 303,
  "message": "The feed https://ruthreichl.substack.com/feed already exists.",
  "id": "TDW3oMDoI"
}

{
  "action": "create",
  "status": "error",
  "code": 130,
  "message": "Something is wrong with the RSS feed URL. Please verify it."
}