Search Parameter Support

We’ve improved our JSON content source integration to support searchable feeds!

You can now define a search parameter so that your users can dynamically search an API from within FeedOtter.

What’s New

• When setting up a JSON content source, you specify a search parameter (like query or q).

• Automatically retrieve and display dynamic, filtered JSON content in your newsletters.

How It Works

1. Add a JSON/XML content source

   • Go to Settings > Content Sources > Add New Content Source

   • Choose JSON or XML as the Content Source Type

   • Enter a Name

   • Paste a sample URL with a search term for testing, e.g.:

     • https://api.chucknorris.io/jokes/search?query=beer

1. Define the Repeating Element

• When working with a JSON feed, you need to tell FeedOtter where to find the list of content items. This is called the "Repeating Element".

1. Map Your Fields

Example field mappings:

Label	Mapping	Type
Title	value	Text
URL	url	Text
Date	created_at	Date
Image URL	icon_url	Image

You should customize these to fit your API's structure.

1. Set the Search Parameter

• Under the Search Parameter section (beneath Custom Data Mapping), add the parameter name used in your API query string. This tells FeedOtter to append ?query=YOURSEARCHTERM when a user types into the search box.

Screenshot: Example JSON content source setup with query as the search parameter and mapped fields.

Example In Action

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!