apyhub
DATA EXTRACTION · DEVELOPER TOOLS

Convert RSS to JSON API

What it does

RSS to JSON Converter turns RSS and Atom feeds into JSON from either an uploaded XML file or a remote feed URL. Send the feed, get back a JSON object you can process in your app, store in a database, or pass into downstream automation.

Use the /file endpoint when you already have an RSS or Atom XML file. It accepts a binary file in the request body and an optional detailed query flag. Use /url when the feed is hosted remotely: provide a url in the request body and the same optional detailed flag.

The response schema is flexible JSON (additionalProperties: true), so the service is built to return the parsed feed structure rather than a fixed, narrow payload. That makes it a good fit for feed ingestion pipelines, content monitoring jobs, newsletter aggregation, and internal tooling that needs to read publication metadata and entries from RSS or Atom sources.

▣ ENDPOINT 01 / 02
POST
Parse uploaded RSS/Atom XML to JSON (FC-05)
https://api.eu.apyverse.com/apyhub/convert-rss-to-json/file

QUICKSTART

GUIDE

Quickstart

Convert an RSS or Atom XML file to JSON by uploading the .xml file with a multipart request.

curl -X POST "https://api.eu.apyverse.com/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 · 10 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

Uploads an RSS or Atom XML file and parses it into JSON. The request includes the file in the body, 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
fileStringYesRSS or Atom XML file (.xml). Binary file upload.

Response

Returns a JSON object with an open-ended structure (additionalProperties: true); the schema does not define any concrete top-level fields.

AttributeTypeMandatoryDescription

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 (FC-05)
https://api.eu.apyverse.com/apyhub/convert-rss-to-json/url

QUICKSTART

GUIDE

Quickstart

Convert an RSS/XML feed from a URL into JSON by sending the feed URL in the request body.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-rss-to-json/url" \
  -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 schema does not declare any fixed top-level fields, so the exact shape may vary.

TRY ITLIVE · 10 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 converted JSON response. The request body provides the feed URL, and the endpoint can optionally include more detailed output when requested.

Query Parameter(s)

AttributeTypeMandatoryDescription
detailedBooleanNoWhen true, returns a more detailed response. Default: false.

Request Body

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

Response

The endpoint returns a JSON object, but the output schema does not define any fixed top-level fields. The detailed response shape is not yet captured in the schema.

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.