Skip to main content

Creating a Pipes2 Search endpoint

A Pipes2 search endpoint should output a regular Pipes2 feed. The only difference is that the endpoint gets a query param (q) of the search term the end user is typing on her mobile/TV device.

Create an endpoint on your server that expects q as a query param. Bellow you can see an expressjs example but you can implement it on whatever server infrastructure you are using.

const express = require('express')
const app = express()
const port = 3000

app.get('/search', async (req, res) => {
const searchTerm = req.query.q;
// Create a fetchItemsBySearchTerm function that calls your API and fetches items according to the given search term.
const items = await fetchItemsBySearchTerm(searchTerm);
// Create a renderItemsAsFeed function that renders items to the Pipes2 schema (
const feed = renderItemsAsFeed(items)

To integrate the endpoint you just created just add it as feed inside Zapp according to the instructions written here.

For the example above your feed URL will be{{q}} The device will dynamically replace {{q}} with the user's typed search term.