Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

JSON / XML API

Connect an XML or JSON feed to Feedotter and map its data to the fields used in your curated newsletters.

Add an XML or JSON Feed

Navigate to Content > Content Sources from the left sidebar.

Click Add Content Source in the upper-right corner.

Under the Details tab:

  1. Enter a Name for your content source.

  2. Select XML or JSON as the Source Type.

  3. Select any Groups you'd like the source to appear in.

  4. Enter the XML URL or JSON URL for your feed.

  5. Click Load Feed.

Once the feed has loaded, navigate to the Fields tab to map your content.

Map Your Content Fields

Under the Fields tab, select the appropriate Data Structure for the items in your feed.

Then, use Field Mapping to tell Feedotter which data from your feed should be used for each content field.

Map the appropriate element path for:

  • Title

  • Description

  • URL

  • Date

  • Image URL

You can also select the appropriate Type for each mapped field.

Add Custom Data Mapping

If your feed contains additional information you'd like to use in Feedotter, click Add new custom data mapping.

This allows you to map additional fields from your XML or JSON data beyond the standard content fields.

Read more about this here:

Custom Data Fields

Add a Search Parameter

If your XML or JSON source supports search, you can add a Search Parameter to allow users to search the source directly from Feedotter.

Under Search parameter, enter the parameter name your API uses for search, such as query or q.

For example, if your API uses:

?query=YOURSEARCHTERM

enter query as the Search Parameter.

Once configured, your users can now:

  • Select the content source within your curated newsletter

  • Type any keyword into the search box

  • Instantly view filtered results from the JSON feed.

If your source does not support search, you can leave this field blank.

Preview Your Content

Once your fields are mapped, select the Preview tab and click Generate Preview.

Review the sample content to make sure Feedotter is pulling the correct title, description, URL, date, image, and any custom data you've mapped.

Once everything looks correct, click Add Source.

Your XML or JSON feed will now be available as a Content Source when adding content to a curated newsletter.

Last updated