← API reference

Search Medium Reading Lists by Query

Discover curated lists for reading apps and editorial marketplaces

Try it in the playground Browse all endpoints

GET https://api.zenndra.com/search/lists?query={query}

Send your API key as Authorization: Bearer YOUR_API_KEY or x-api-key.

Required query: ?query=your+keywords

What you get back

Search reading lists on Medium — pass your keyword as the required query parameter.

What people build with it

Surface listicles by keyword for newsletter and course builders
Feed recommendation engines with human-curated sequences matched to a topic

Path parameters

Swap the placeholders in the URL for real values.

{query} Replace with a real value

Copy & run

const query = 'startup reading';\nconst res = await fetch(`https://api.zenndra.com/search/lists?query=${encodeURIComponent(query)}`, {\n  headers: { Authorization: 'Bearer YOUR_API_KEY' },\n});\nconst data = await res.json();

import requests\n\nurl = "https://api.zenndra.com/search/lists"\nparams = {"query": "startup reading"}\nheaders = {"Authorization": "Bearer YOUR_API_KEY"}\nr = requests.get(url, headers=headers, params=params)\nprint(r.json())

<?php\n$query = 'startup reading';\n$url = 'https://api.zenndra.com/search/lists?query=' . rawurlencode($query);\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_API_KEY']);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\necho curl_exec($ch);

curl "https://api.zenndra.com/search/lists?query=startup+reading" -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "lists": [
    {"list_id": "abc123", "name": "Essential startup reads", "articles_count": 12}
  ],
  "count": 1
}