apyhub
DATA EXTRACTION · DEVELOPER TOOLS

Convert RSS to JSON API

Hosted on ApyHub

What it does

RSS to JSON converts RSS and Atom feeds into JSON you can work with in your app. Send either an uploaded XML file or a remote feed URL, and get the parsed feed content back as JSON.

Use the /file endpoint when you already have the feed as a local .xml upload. Use /url when you want to fetch and parse a remote feed directly. Both endpoints accept an optional detailed query parameter, which lets you request a more detailed parsed result when you need extra structure.

This is useful when you need to ingest blog feeds, news updates, podcast feeds, or partner content into a pipeline, database, or CMS. JSON is easier to filter, store, and transform than raw RSS or Atom XML, especially when you are polling feeds on a schedule or normalizing multiple sources into one format.

RSS to JSON is a straightforward parsing utility: give it feed XML or a feed URL, and it returns a JSON response shaped for downstream processing.

▣ ENDPOINT 01 / 02
POST
Parse uploaded RSS/Atom XML to JSON
http://localhost:8080/apyhub/convert-rss-to-json/file
QUICKSTARTGUIDE

Quickstart

Upload an RSS or Atom XML file to convert it into JSON.

curl -X POST "http://localhost:8080/apyhub/convert-rss-to-json/file" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/feed.xml"

What you'll get back

Returns a JSON object. The output schema does not declare any specific top-level fields, so the exact response shape may vary.

TRY ITLIVE · 150 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*
RSS or Atom XML file (.xml). Mandatory.

About this endpoint

What it does

Parses an uploaded RSS or Atom XML file and converts it to JSON. The request sends a binary .xml file, and the response is a JSON object whose detailed shape is not defined in the schema.

Query Parameter(s)

AttributeTypeMandatoryDescription
detailedBooleanNoDefault: false

Request Body

ParameterTypeMandatoryDescription
fileStringYesBinary RSS or Atom XML file (.xml). Mandatory.

Response

Returns a JSON object, but the output schema does not define a fixed set of top-level fields; additional properties are allowed.

ParameterTypeMandatoryDescription

Query parameters

Name
Type
Description
detailedOPTIONAL
boolean
DEFAULT false

Body

Name
Type
Description
bodyREQUIRED
object

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 02 / 02
POST
Parse remote RSS/Atom feed URL to JSON
http://localhost:8080/apyhub/convert-rss-to-json/url
QUICKSTARTGUIDE

Quickstart

Convert an RSS feed URL to JSON by sending the feed link in the request body.

curl -X POST "http://localhost:8080/apyhub/convert-rss-to-json/url?detailed=false" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://apyhub.com/api/rss"}'

What you'll get back

Returns a JSON object. The output schema does not declare any specific top-level fields, so the exact response shape can vary.

TRY ITLIVE · 150 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*

About this endpoint

What it does

Parses a remote RSS or Atom feed from a URL and returns the feed data as JSON. The request sends the feed URL in the body, and the response schema does not define a fixed JSON shape beyond returning an object.

Query Parameter(s)

AttributeTypeMandatoryDescription
detailedBooleanNoDefault: false

Request Body

ParameterTypeMandatoryDescription
urlStringYesThe remote feed URL to parse. Must be a URI.

Response

Returns a JSON object. The output schema does not define specific top-level fields; it allows additional properties, so the exact response shape is not fixed.

ParameterTypeMandatoryDescription

Query parameters

Name
Type
Description
detailedOPTIONAL
boolean
DEFAULT false

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.