Changeflow provides feeds of your monitored changes in multiple formats. You can subscribe to these feeds in RSS readers, import them into spreadsheets, or consume them programmatically.

Feed Formats

All feeds are available in three formats:

Format Use Case
RSS Subscribe in any RSS reader (Feedly, Inoreader, etc.)
JSON Consume programmatically or import into tools
CSV Import into spreadsheets (Excel, Google Sheets)

Getting Your Feed URL

  1. Go to Settings > Integrations
  2. Find the feed URLs in the API Details section
  3. Copy the URL for the format you need

Your feed URL includes your API token, so keep it private.

Feed Types

All Changes Feed

Get all recent changes across all your monitored sources.

https://changeflow.com/api/v3/{token}/changes
https://changeflow.com/api/v3/{token}/changes?format=rss
https://changeflow.com/api/v3/{token}/changes?format=csv

Filter by Tag

Get changes only from sources with a specific tag.

https://changeflow.com/api/v3/{token}/changes?tag=competitors
https://changeflow.com/api/v3/{token}/changes?tag=competitors&format=rss

Filter by Source

Get changes from a specific source using its ID.

https://changeflow.com/api/v3/{token}/changes?source_id=abc123
https://changeflow.com/api/v3/{token}/changes?source_id=abc123&format=rss

You can find a source's ID in the URL when viewing it, or via the API.

Search by Keyword

Get changes from sources matching a search term (searches source title and URL).

https://changeflow.com/api/v3/{token}/changes?q=pricing
https://changeflow.com/api/v3/{token}/changes?search=competitor.com&format=rss

Limit Results

Control how many changes are returned (default: 100).

https://changeflow.com/api/v3/{token}/changes?limit=50
https://changeflow.com/api/v3/{token}/changes?limit=25&format=rss

Combine Filters

You can combine multiple filters in a single feed.

https://changeflow.com/api/v3/{token}/changes?tag=competitors&limit=50&format=rss
https://changeflow.com/api/v3/{token}/changes?q=pricing&tag=high-priority&format=csv

Using RSS Feeds

Popular RSS Readers

Adding to an RSS Reader

  1. Copy your RSS feed URL (with ?format=rss)
  2. In your RSS reader, look for "Add Feed" or "Subscribe"
  3. Paste the URL
  4. Your changes will appear as new items in your reader

RSS Feed Contents

Each item in the RSS feed includes:

  • Title - Summary of the change
  • Description - Details about what changed
  • Link - URL to view the change (or the actual link for new link items)
  • Image - Thumbnail of the change for versions, or thumbnail of the linked page for new links
  • Date - When the change was detected

Extended RSS Content

For link-type changes, the RSS feed includes additional content using standard and custom namespaces. The feed declares these namespaces in the root element:

<rss version="2.0"
     xmlns:atom="http://www.w3.org/2005/Atom"
     xmlns:content="http://purl.org/rss/1.0/modules/content/"
     xmlns:markdown="http://changeflow.com/rss/1.0/markdown">
Element Namespace Description
content:encoded Standard Full HTML content for display in RSS readers
markdown:clean Changeflow Clean markdown version of the linked page
markdown:rich Changeflow Rich markdown with metadata (LD+JSON, meta tags)

The content:encoded element is widely supported by RSS readers and will display formatted HTML content. The markdown namespaces (http://changeflow.com/rss/1.0/markdown) are useful for programmatic access to the raw content.

Example RSS Item:

<item>
  <title>New Product Launch</title>
  <description>Competitor announces new product line</description>
  <content:encoded><![CDATA[
    <h1>New Product Launch</h1>
    <p>Full article content in HTML...</p>
  ]]></content:encoded>
  <markdown:clean><![CDATA[
# New Product Launch

Full article content in markdown...
  ]]></markdown:clean>
  <markdown:rich><![CDATA[
# New Product Launch

Full article content with metadata...

---
{"@type": "Article", "headline": "New Product Launch"}
  ]]></markdown:rich>
  <link>https://competitor.com/blog/new-product</link>
  <pubDate>Wed, 15 Jan 2025 14:30:00 +0000</pubDate>
</item>

These extended fields are only present when the linked page content is available. Standard RSS readers will display the content:encoded HTML, while custom integrations can parse the markdown namespaces for raw content.

Using JSON Feeds

JSON feeds return an array of change objects, perfect for programmatic access.

[
  {
    "type": "link",
    "title": "New Product Launch",
    "description": "Competitor announces new product line",
    "thumbnail": "https://...",
    "diff_image": "https://...",
    "diff_url": "https://changeflow.com/tracks/abc123/versions/456",
    "url": "https://competitor.com/blog/new-product",
    "track_id": "abc123",
    "version_id": 456,
    "change_id": "l_789",
    "source_name": "Competitor Blog",
    "source_url": "https://competitor.com/blog",
    "timestamp": "2025-01-15T14:30:00Z",
    "markdown": {
      "clean": "# New Product Launch\n\nFull article content...",
      "rich": "# New Product Launch\n\nContent with metadata...\n\n---\n{\"@type\": \"Article\"}"
    }
  }
]

For link-type changes, the JSON response includes a markdown object with:

  • clean - Clean markdown version of the linked page content
  • rich - Rich markdown including metadata like LD+JSON and meta descriptions

See the API documentation for full field descriptions.

Using CSV Feeds

CSV feeds are perfect for importing into spreadsheets or databases.

Import into Google Sheets

  1. Open a new Google Sheet
  2. In cell A1, enter: =IMPORTDATA("your-feed-url?format=csv")
  3. The sheet will automatically populate with your changes
  4. Data refreshes periodically (Google's cache timing)

Import into Excel

  1. Go to Data > Get Data > From Web
  2. Paste your CSV feed URL
  3. Excel will import and format the data
  4. Set up refresh schedules as needed

CSV Columns

The CSV feed includes these columns:

  • type, title, description, thumbnail, diff_image, diff_url, url, track_id, version_id, change_id, source_name, source_url, timestamp

Feed Best Practices

Use Tags for Organization

Create tags for different types of sources, then subscribe to tag-specific feeds:

  • competitors - Competitor monitoring feed
  • regulatory - Regulatory changes feed
  • high-priority - Critical changes only

Set Appropriate Limits

  • For RSS readers: 50-100 items is usually enough
  • For spreadsheets: Consider higher limits for historical data
  • For automation: Use smaller limits with more frequent polling

Combine with Webhooks

For real-time notifications, use webhooks alongside feeds. Feeds are great for catching up or reviewing history, while webhooks provide instant alerts.

Plan Requirements

Feeds are available on Business plans and above. If you don't see feed URLs on your integrations page, you may need to upgrade your plan.

Getting Help

If you need assistance with feeds: