RSS to JSON API Reference

API Overview

RSS to JSON is a simple tool for converting RSS feeds into JSON format. It returns the RSS feed in JSON format. To use this API, you need an API key. You can get one by creating a free account and visiting your dashboard.

Important: Ensure that this API is enabled from within your dashboard to use it in your application. If not, you may receive a 403 error

View API in Directory

Client Libaries

To get started with minimal code, most of our APIs are available through client libraries:

run in postman button npm logo pypi logo nuget logo

Convert RSS Feed to JSON

1 Token

	
#POST Request
https://api.apiverve.com/v1/rsstojson	

	
					

x-api-key (required)

This is a required header on every request. Your API Key is found from within your dashboard

accept

This is an optional header. Set the value to application/json, application/xml, or application/yaml


urlstring(required)

The URL of the RSS feed you want converted into JSON format


Sample Request
	
import requests

url = "https://api.apiverve.com/v1/rsstojson"

payload = { "url": "https://www.nasa.gov/rss/dyn/breaking_news.rss" }
headers = {
	"x-api-key": "YOUR_API_KEY",
	"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
	
							
	
using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
	Method = HttpMethod.Post,
	RequestUri = new Uri("https://api.apiverve.com/v1/rsstojson"),
	Headers =
	{
		{ "x-api-key", "YOUR_API_KEY" }
	},
	Content = new StringContent("{ \"url\": \"https://www.nasa.gov/rss/dyn/breaking_news.rss\" }")
	{
		Headers =
		{
			ContentType = new MediaTypeHeaderValue("application/json")
		}
	}
};
using (var response = await client.SendAsync(request))
{
	response.EnsureSuccessStatusCode();
	var body = await response.Content.ReadAsStringAsync();
	Console.WriteLine(body);
}
	
							
	
const data = JSON.stringify({ "url": "https://www.nasa.gov/rss/dyn/breaking_news.rss" });

const xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener('readystatechange', function () {
	if (this.readyState === this.DONE) {
		console.log(this.responseText);
	}
});

xhr.open('POST', 'https://api.apiverve.com/v1/rsstojson');
xhr.setRequestHeader('x-api-key', 'YOUR_API_KEY');
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.setRequestHeader('Accept', 'application/json');

xhr.send(data);
	
							
	
const request = require('request');

const options = {
  method: 'POST',
  url: 'https://api.apiverve.com/v1/rsstojson',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
    Accept: 'application/json'
  },
  body: { "url": "https://www.nasa.gov/rss/dyn/breaking_news.rss" },
  json: true
};

request(options, function (error, response, body) {
	if (error) throw new Error(error);

	console.log(body);
});
	
							
	
HttpRequest request = HttpRequest.newBuilder()
		.uri(URI.create("https://api.apiverve.com/v1/rsstojson"))
		.header("x-api-key", "YOUR_API_KEY")
		.header("Content-Type", "application/json")
		.header("Accept", "application/json")
		.method("POST", HttpRequest.BodyPublishers.ofString("{ \"url\": \"https://www.nasa.gov/rss/dyn/breaking_news.rss\" }"))
		.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
	
							
	
import Foundation

let headers = [
	"x-api-key": "YOUR_API_KEY",
	"Content-Type": "application/json"
]
let parameters = ["url" : "https://www.nasa.gov/rss/dyn/breaking_news.rss",] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.apiverve.com/v1/rsstojson")! as URL,
				cachePolicy: .useProtocolCachePolicy,
                timeoutInterval: 10.0)

request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
	if (error != nil) {
		print(error as Any)
	} else {
		let httpResponse = response as? HTTPURLResponse
		print(httpResponse)
	}
})

dataTask.resume()
	
							
	
curl --request POST \
	--url https://api.apiverve.com/v1/rsstojson \
	--header 'Accept: application/json' \
	--header 'Content-Type: application/json' \
	--header 'x-api-key: YOUR_API_KEY' \
	--data '{ "url": "https://www.nasa.gov/rss/dyn/breaking_news.rss" }'
	
							

Sample Response
	
{
  "status": "ok",
  "error": null,
  "data": {
    "source": "www.nasa.gov",
    "articles": 10,
    "maxReached": false,
    "feed": [
      {
        "website": "NASA",
        "title": "30 Years Ago: STS-63, First Shuttle and Mir Rendezvous Mission ",
        "pubDate": "Mon, 03 Feb 2025 15:16:04 +0000",
        "description": "The first shuttle mission of 1995, STS-63 included several historic firsts. As part of Phase 1 of the International Space Station program, space shuttle Discovery’s 20th flight conducted the first shuttle rendezvous with the Mir space station, in preparation for future dockings. The six-person crew included Commander James Wetherbee, Pilot Eileen Collins – the first […]",
        "link": "https://www.nasa.gov/history/30-years-ago-sts-63-first-shuttle-and-mir-rendezvous-mission/"
      },
      {
        "website": "NASA",
        "title": "Lagniappe for February 2025",
        "pubDate": "Mon, 03 Feb 2025 14:53:54 +0000",
        "description": "Explore Lagniappe for February 2025 featuring: Gator Speaks Welcome to February, folks! The shortest month of the year is here, but do not let its number of days fool you. The month is full of energy and is welcomed with great enthusiasm. We have dusted ourselves off from a historic snowfall in January. The Super […]",
        "link": "https://www.nasa.gov/centers-and-facilities/stennis/lagniappe-for-february-2025/"
      },
      {
        "website": "NASA",
        "title": "NASA Attends FAN EXPO New Orleans",
        "pubDate": "Mon, 03 Feb 2025 14:52:23 +0000",
        "description": "NASA reached out to inspire members of the Artemis Generation on Jan. 10-12, joining one of the largest comic con producers in the world to host an outreach booth at the 2025 FAN EXPO in New Orleans. Thousands of fans celebrating the best in pop culture such as movies, comics, and video gaming learned about […]",
        "link": "https://www.nasa.gov/image-article/stennis-attends-fan-expo-new-orleans/"
      },
      {
        "website": "NASA",
        "title": "The Drive for Better Fuels NASA Employee",
        "pubDate": "Mon, 03 Feb 2025 14:51:48 +0000",
        "description": "Two words come to Tim Stiglets’ mind when he thinks about NASA’s Stennis Space Center near Bay St. Louis, Mississippi – growth and opportunity. The Waveland, Mississippi, resident has experienced both in his career at the south Mississippi NASA center. He started as a summer intern onsite with Lockheed Martin in 2002. When The University […]",
        "link": "https://www.nasa.gov/image-article/the-drive-for-better-fuels-tim-stiglets/"
      },
      {
        "website": "NASA",
        "title": "Station Nation: Meet Tandra Gill Spain, Computer Resources Senior Project Manager in the Avionics and Software Office ",
        "pubDate": "Mon, 03 Feb 2025 12:00:00 +0000",
        "description": "For astronauts aboard the International Space Station, staying connected to loved ones and maintaining a sense of normalcy is critical. That is where Tandra Gill Spain, a computer resources senior project manager in NASA’s Avionics and Software Office, comes in. Spain leads the integration of applications on Apple devices and the hardware integration on the […]",
        "link": "https://www.nasa.gov/general/station-nation-meet-tandra-gill-spain-computer-resources-senior-project-manager-in-the-avionics-and-software-office/"
      },
      {
        "website": "NASA",
        "title": "NASA to Talk Science, Tech Aboard Next Intuitive Machines Moon Flight",
        "pubDate": "Fri, 31 Jan 2025 21:51:15 +0000",
        "description": "NASA will host a media teleconference at 1 p.m. EST Friday, Feb. 7, to discuss the agency’s science and technology flying aboard Intuitive Machines’ second flight to the Moon. The mission is part of NASA’s CLPS (Commercial Lunar Payload Services) initiative and Artemis campaign to establish a long-term lunar presence. Audio of the call will stream […]",
        "link": "https://www.nasa.gov/news-release/nasa-to-talk-science-tech-aboard-next-intuitive-machines-moon-flight/"
      },
      {
        "website": "NASA",
        "title": "What’s Up: February 2025 Skywatching Tips from NASA",
        "pubDate": "Fri, 31 Jan 2025 19:00:02 +0000",
        "description": "A Month of Bright Planets Venus blazes at its brightest for the year after sunset, then Mars and Jupiter to rule the night amid the menagerie of bright winter stars. Skywatching Highlights All Month – Planet Visibility: Daily Highlights: February 1 – Venus & Moon: The crescent Moon cozies up to brilliant Venus tonight in […]",
        "link": "https://science.nasa.gov/solar-system/skywatching/whats-up-february-2025-skywatching-tips-from-nasa/"
      },
      {
        "website": "NASA",
        "title": "NASA Radar Imagery Reveals Details About Los Angeles-Area Landslides",
        "pubDate": "Fri, 31 Jan 2025 18:31:13 +0000",
        "description": "Analysis of data from NASA radar aboard an airplane shows that the decades-old active landslide area on the Palos Verdes Peninsula has expanded. Researchers at NASA’s Jet Propulsion Laboratory in Southern California used data from an airborne radar to measure the movement of the slow-moving landslides on the Palos Verdes Peninsula in Los Angeles County. […]",
        "link": "https://www.nasa.gov/science-research/earth-science/nasa-radar-imagery-reveals-details-about-los-angeles-area-landslides/"
      },
      {
        "website": "NASA",
        "title": "NASA Flight Tests Wildland Fire Tech Ahead of Demo",
        "pubDate": "Fri, 31 Jan 2025 18:26:46 +0000",
        "description": "NASA is collaborating with the wildfire community to provide tools for some of the most challenging aspects of firefighting – particularly aerial nighttime operations.   In the future, agencies could more efficiently use drones, both remotely piloted and fully autonomous, to help fight wildfires. NASA recently tested technologies with teams across the country that will enable […]",
        "link": "https://www.nasa.gov/aeronautics/nasa-flight-tests-wildland-fire-tech-ahead-of-demonstration/"
      },
      {
        "website": "NASA",
        "title": "Building an Antenna",
        "pubDate": "Fri, 31 Jan 2025 17:15:11 +0000",
        "description": "A crane lowers the 112-foot-wide (34-meter-wide) steel framework for the Deep Space Station 23 (DSS-23) reflector dish into position on Dec. 18, 2024, at the Deep Space Network’s (DSN) Goldstone Space Communications Complex near Barstow, California. Once online in 2026, DSS-23 will be the fifth of six new beam waveguide antennas to be added to […]",
        "link": "https://www.nasa.gov/image-article/building-an-antenna/"
      }
    ]
  },
  "code": 200
}
	
							
	
<Root>
  <status>ok</status>
  <error />
  <data>
    <source>www.nasa.gov</source>
    <articles>10</articles>
    <maxReached>false</maxReached>
    <feed>
      <website>NASA</website>
      <title>30 Years Ago: STS-63, First Shuttle and Mir Rendezvous Mission </title>
      <pubDate>Mon, 03 Feb 2025 15:16:04 +0000</pubDate>
      <description>The first shuttle mission of 1995, STS-63 included several historic firsts. As part of Phase 1 of the International Space Station program, space shuttle Discovery’s 20th flight conducted the first shuttle rendezvous with the Mir space station, in preparation for future dockings. The six-person crew included Commander James Wetherbee, Pilot Eileen Collins – the first […]</description>
      <link>https://www.nasa.gov/history/30-years-ago-sts-63-first-shuttle-and-mir-rendezvous-mission/</link>
    </feed>
    <feed>
      <website>NASA</website>
      <title>Lagniappe for February 2025</title>
      <pubDate>Mon, 03 Feb 2025 14:53:54 +0000</pubDate>
      <description>Explore Lagniappe for February 2025 featuring: Gator Speaks Welcome to February, folks! The shortest month of the year is here, but do not let its number of days fool you. The month is full of energy and is welcomed with great enthusiasm. We have dusted ourselves off from a historic snowfall in January. The Super […]</description>
      <link>https://www.nasa.gov/centers-and-facilities/stennis/lagniappe-for-february-2025/</link>
    </feed>
    <feed>
      <website>NASA</website>
      <title>NASA Attends FAN EXPO New Orleans</title>
      <pubDate>Mon, 03 Feb 2025 14:52:23 +0000</pubDate>
      <description>NASA reached out to inspire members of the Artemis Generation on Jan. 10-12, joining one of the largest comic con producers in the world to host an outreach booth at the 2025 FAN EXPO in New Orleans. Thousands of fans celebrating the best in pop culture such as movies, comics, and video gaming learned about […]</description>
      <link>https://www.nasa.gov/image-article/stennis-attends-fan-expo-new-orleans/</link>
    </feed>
    <feed>
      <website>NASA</website>
      <title>The Drive for Better Fuels NASA Employee</title>
      <pubDate>Mon, 03 Feb 2025 14:51:48 +0000</pubDate>
      <description>Two words come to Tim Stiglets’ mind when he thinks about NASA’s Stennis Space Center near Bay St. Louis, Mississippi – growth and opportunity. The Waveland, Mississippi, resident has experienced both in his career at the south Mississippi NASA center. He started as a summer intern onsite with Lockheed Martin in 2002. When The University […]</description>
      <link>https://www.nasa.gov/image-article/the-drive-for-better-fuels-tim-stiglets/</link>
    </feed>
    <feed>
      <website>NASA</website>
      <title>Station Nation: Meet Tandra Gill Spain, Computer Resources Senior Project Manager in the Avionics and Software Office </title>
      <pubDate>Mon, 03 Feb 2025 12:00:00 +0000</pubDate>
      <description>For astronauts aboard the International Space Station, staying connected to loved ones and maintaining a sense of normalcy is critical. That is where Tandra Gill Spain, a computer resources senior project manager in NASA’s Avionics and Software Office, comes in. Spain leads the integration of applications on Apple devices and the hardware integration on the […]</description>
      <link>https://www.nasa.gov/general/station-nation-meet-tandra-gill-spain-computer-resources-senior-project-manager-in-the-avionics-and-software-office/</link>
    </feed>
    <feed>
      <website>NASA</website>
      <title>NASA to Talk Science, Tech Aboard Next Intuitive Machines Moon Flight</title>
      <pubDate>Fri, 31 Jan 2025 21:51:15 +0000</pubDate>
      <description>NASA will host a media teleconference at 1 p.m. EST Friday, Feb. 7, to discuss the agency’s science and technology flying aboard Intuitive Machines’ second flight to the Moon. The mission is part of NASA’s CLPS (Commercial Lunar Payload Services) initiative and Artemis campaign to establish a long-term lunar presence. Audio of the call will stream […]</description>
      <link>https://www.nasa.gov/news-release/nasa-to-talk-science-tech-aboard-next-intuitive-machines-moon-flight/</link>
    </feed>
    <feed>
      <website>NASA</website>
      <title>What’s Up: February 2025 Skywatching Tips from NASA</title>
      <pubDate>Fri, 31 Jan 2025 19:00:02 +0000</pubDate>
      <description>A Month of Bright Planets Venus blazes at its brightest for the year after sunset, then Mars and Jupiter to rule the night amid the menagerie of bright winter stars. Skywatching Highlights All Month – Planet Visibility: Daily Highlights: February 1 – Venus &amp; Moon: The crescent Moon cozies up to brilliant Venus tonight in […]</description>
      <link>https://science.nasa.gov/solar-system/skywatching/whats-up-february-2025-skywatching-tips-from-nasa/</link>
    </feed>
    <feed>
      <website>NASA</website>
      <title>NASA Radar Imagery Reveals Details About Los Angeles-Area Landslides</title>
      <pubDate>Fri, 31 Jan 2025 18:31:13 +0000</pubDate>
      <description>Analysis of data from NASA radar aboard an airplane shows that the decades-old active landslide area on the Palos Verdes Peninsula has expanded. Researchers at NASA’s Jet Propulsion Laboratory in Southern California used data from an airborne radar to measure the movement of the slow-moving landslides on the Palos Verdes Peninsula in Los Angeles County. […]</description>
      <link>https://www.nasa.gov/science-research/earth-science/nasa-radar-imagery-reveals-details-about-los-angeles-area-landslides/</link>
    </feed>
    <feed>
      <website>NASA</website>
      <title>NASA Flight Tests Wildland Fire Tech Ahead of Demo</title>
      <pubDate>Fri, 31 Jan 2025 18:26:46 +0000</pubDate>
      <description>NASA is collaborating with the wildfire community to provide tools for some of the most challenging aspects of firefighting – particularly aerial nighttime operations.   In the future, agencies could more efficiently use drones, both remotely piloted and fully autonomous, to help fight wildfires. NASA recently tested technologies with teams across the country that will enable […]</description>
      <link>https://www.nasa.gov/aeronautics/nasa-flight-tests-wildland-fire-tech-ahead-of-demonstration/</link>
    </feed>
    <feed>
      <website>NASA</website>
      <title>Building an Antenna</title>
      <pubDate>Fri, 31 Jan 2025 17:15:11 +0000</pubDate>
      <description>A crane lowers the 112-foot-wide (34-meter-wide) steel framework for the Deep Space Station 23 (DSS-23) reflector dish into position on Dec. 18, 2024, at the Deep Space Network’s (DSN) Goldstone Space Communications Complex near Barstow, California. Once online in 2026, DSS-23 will be the fifth of six new beam waveguide antennas to be added to […]</description>
      <link>https://www.nasa.gov/image-article/building-an-antenna/</link>
    </feed>
  </data>
  <code>200</code>
</Root>
	
							
	
status: ok
error: 
data:
  source: www.nasa.gov
  articles: 10
  maxReached: false
  feed:
  - website: NASA
    title: '30 Years Ago: STS-63, First Shuttle and Mir Rendezvous Mission '
    pubDate: Mon, 03 Feb 2025 15:16:04 +0000
    description: The first shuttle mission of 1995, STS-63 included several historic firsts. As part of Phase 1 of the International Space Station program, space shuttle Discovery’s 20th flight conducted the first shuttle rendezvous with the Mir space station, in preparation for future dockings. The six-person crew included Commander James Wetherbee, Pilot Eileen Collins – the first […]
    link: https://www.nasa.gov/history/30-years-ago-sts-63-first-shuttle-and-mir-rendezvous-mission/
  - website: NASA
    title: Lagniappe for February 2025
    pubDate: Mon, 03 Feb 2025 14:53:54 +0000
    description: 'Explore Lagniappe for February 2025 featuring: Gator Speaks Welcome to February, folks! The shortest month of the year is here, but do not let its number of days fool you. The month is full of energy and is welcomed with great enthusiasm. We have dusted ourselves off from a historic snowfall in January. The Super […]'
    link: https://www.nasa.gov/centers-and-facilities/stennis/lagniappe-for-february-2025/
  - website: NASA
    title: NASA Attends FAN EXPO New Orleans
    pubDate: Mon, 03 Feb 2025 14:52:23 +0000
    description: NASA reached out to inspire members of the Artemis Generation on Jan. 10-12, joining one of the largest comic con producers in the world to host an outreach booth at the 2025 FAN EXPO in New Orleans. Thousands of fans celebrating the best in pop culture such as movies, comics, and video gaming learned about […]
    link: https://www.nasa.gov/image-article/stennis-attends-fan-expo-new-orleans/
  - website: NASA
    title: The Drive for Better Fuels NASA Employee
    pubDate: Mon, 03 Feb 2025 14:51:48 +0000
    description: Two words come to Tim Stiglets’ mind when he thinks about NASA’s Stennis Space Center near Bay St. Louis, Mississippi – growth and opportunity. The Waveland, Mississippi, resident has experienced both in his career at the south Mississippi NASA center. He started as a summer intern onsite with Lockheed Martin in 2002. When The University […]
    link: https://www.nasa.gov/image-article/the-drive-for-better-fuels-tim-stiglets/
  - website: NASA
    title: 'Station Nation: Meet Tandra Gill Spain, Computer Resources Senior Project Manager in the Avionics and Software Office '
    pubDate: Mon, 03 Feb 2025 12:00:00 +0000
    description: For astronauts aboard the International Space Station, staying connected to loved ones and maintaining a sense of normalcy is critical. That is where Tandra Gill Spain, a computer resources senior project manager in NASA’s Avionics and Software Office, comes in. Spain leads the integration of applications on Apple devices and the hardware integration on the […]
    link: https://www.nasa.gov/general/station-nation-meet-tandra-gill-spain-computer-resources-senior-project-manager-in-the-avionics-and-software-office/
  - website: NASA
    title: NASA to Talk Science, Tech Aboard Next Intuitive Machines Moon Flight
    pubDate: Fri, 31 Jan 2025 21:51:15 +0000
    description: NASA will host a media teleconference at 1 p.m. EST Friday, Feb. 7, to discuss the agency’s science and technology flying aboard Intuitive Machines’ second flight to the Moon. The mission is part of NASA’s CLPS (Commercial Lunar Payload Services) initiative and Artemis campaign to establish a long-term lunar presence. Audio of the call will stream […]
    link: https://www.nasa.gov/news-release/nasa-to-talk-science-tech-aboard-next-intuitive-machines-moon-flight/
  - website: NASA
    title: 'What’s Up: February 2025 Skywatching Tips from NASA'
    pubDate: Fri, 31 Jan 2025 19:00:02 +0000
    description: 'A Month of Bright Planets Venus blazes at its brightest for the year after sunset, then Mars and Jupiter to rule the night amid the menagerie of bright winter stars. Skywatching Highlights All Month – Planet Visibility: Daily Highlights: February 1 – Venus & Moon: The crescent Moon cozies up to brilliant Venus tonight in […]'
    link: https://science.nasa.gov/solar-system/skywatching/whats-up-february-2025-skywatching-tips-from-nasa/
  - website: NASA
    title: NASA Radar Imagery Reveals Details About Los Angeles-Area Landslides
    pubDate: Fri, 31 Jan 2025 18:31:13 +0000
    description: Analysis of data from NASA radar aboard an airplane shows that the decades-old active landslide area on the Palos Verdes Peninsula has expanded. Researchers at NASA’s Jet Propulsion Laboratory in Southern California used data from an airborne radar to measure the movement of the slow-moving landslides on the Palos Verdes Peninsula in Los Angeles County. […]
    link: https://www.nasa.gov/science-research/earth-science/nasa-radar-imagery-reveals-details-about-los-angeles-area-landslides/
  - website: NASA
    title: NASA Flight Tests Wildland Fire Tech Ahead of Demo
    pubDate: Fri, 31 Jan 2025 18:26:46 +0000
    description: NASA is collaborating with the wildfire community to provide tools for some of the most challenging aspects of firefighting – particularly aerial nighttime operations.   In the future, agencies could more efficiently use drones, both remotely piloted and fully autonomous, to help fight wildfires. NASA recently tested technologies with teams across the country that will enable […]
    link: https://www.nasa.gov/aeronautics/nasa-flight-tests-wildland-fire-tech-ahead-of-demonstration/
  - website: NASA
    title: Building an Antenna
    pubDate: Fri, 31 Jan 2025 17:15:11 +0000
    description: A crane lowers the 112-foot-wide (34-meter-wide) steel framework for the Deep Space Station 23 (DSS-23) reflector dish into position on Dec. 18, 2024, at the Deep Space Network’s (DSN) Goldstone Space Communications Complex near Barstow, California. Once online in 2026, DSS-23 will be the fifth of six new beam waveguide antennas to be added to […]
    link: https://www.nasa.gov/image-article/building-an-antenna/
code: 200

	
							
Live Test API in Playground

Response Types

The RSS to JSON API supports the following response content types:

application/json, application/xml, application/yaml

You can specify the response content type by setting the Accept header in your request. If you don't specify a content type, the API will default to application/json.

Authentication

The RSS to JSON API uses an API Key to authenticate requests. You can view and manage your API key by visiting your dashboard.

Your API keys carry many privileges. To keep them from being abused, please do not share the keys on client-side code or Github etc. Keep them very secure.

To use any API, you must have it enabled from within your dashboard. Disabled APIs will fail to respond to your requests.

All requests made to the API must contain the header x-api-key in each of your requests. API requests without authentication will fail.

All API requests must also be made over secure HTTPS. Requests made over plain HTTP will fail.

Error Code Meaning
401 Your request was made with invalid credentials. This error also appears when you don't pass the x-api-key header in your request.
403 Typically, this occurs when you are trying to access an API that you have not enabled.

Rate Limits

	
{
    "status": "error",
    "data": null,
    "error": "tokens have been depleted",
    "code": 429
}
	
							

Each subscription has its own monthly token limit. Your token count is based on your subscription plan. If you reach your limits, don't worry. You can always upgrade or downgrade at any time.

When you reach your limit, the service will stop responding and typically return an HTTP 429 response status code. The error will also contain a detailed JSON.

The RSS to JSON API uses the following error code:

Error Code Meaning
429 You have exceeded your rate limit and further requests will be denied until the next cycle.

Error Codes

For reference, the RSS to JSON API uses the following error codes:

Error Code Meaning
Code Message
200 The request was successful. The response will include the requested data.
400 The request was invalid. The response will include a message that explains the error.
401 The request was not authorized. Usually, this means that the API key is missing or invalid.
403 This means that the request was trying to access a resource that it does not have permission to access.
404 This means that the resource you are trying to access does not exist.
429 This means that you have reached the rate limit. The response will include a Retry-After header that indicates how many seconds you need to wait before making a new request.
500 This means that there was an error on the server side. We are alerted when this happens and we will work to fix it as soon as possible.
ON THIS PAGE