Emerging Trends API Guide

This guide explains how to use the Feedly Emerging Trends API to retrieve trends based on specific industries, filters, and sorting criteria.

📘 Use our API Reference page to build your script here:

POST

## **Authentication**
Include your **Bearer Token** in the `Authorization` header:
```json
"Authorization": "Bearer YOUR_ACCESS_TOKEN"

---

Query Parameters

Parameter	Type	Required	Description
count	int	✅	Number of trends to return (supports up to 200).
newOnly	bool	❌	If true, returns only newly discovered trends. Defaults to false.
sort	str	✅	Sorting criteria for ranking trends. (See Sorting Options)

Sorting Options

The sort parameter determines how trends are ranked.

Value	Sort Order
"-size"	Largest trends first
"size"	Smallest trends first
"-growth"	Highest growth first
"growth"	Lowest growth first

💡 Tip:

• A dash (-) means descending order (higher growth first).
• No dash means ascending order (lower growth first).

---

Body Parameters

Parameter	Type	Required	Description
period	str	✅	Time range for trend growth. (See Valid Periods)
searchLayers	array	✅	Defines topic queries.
filters	array	❌	Additional filters to refine results.

Valid Periods

Value	Description
"Last30Days"	Trends growing in the last 30 days
"Last3Months"	Trends growing in the last 3 months
"Last6Months"	Trends growing in the last 6 months
"LastYear"	Trends growing in the last year (most trends)

Filtering Options

Each filter consists of a type and values.

Type	Possible Values
size	"Niche", "Known", "Mainstream"
industry	Industry topic IDs (from Feedly AI library)
growth	"Exploding", "Surging", "Growing"

---

Best Practices

• We recommend copying the JSON from the AI feed query builder and extracting the "layers" part for the searchLayers parameter
• When using the API directly, you can request up to 200 results by setting the appropriate count parameter
• Use appropriate filters to narrow down results for more relevant trend discovery

---

Example Request

{
  "filters": [
    {"type": "growth", "values": ["Exploding", "Surging", "Growing"]},
    {"type": "size", "values": ["Mainstream", "Known", "Niche"]},
    {"type": "industry", "values": []}
  ],
  "period": "Last6Months",
  "searchLayers": [
    {
      "parts": [
        {"id": "nlp/f/entity/gz:no-code-development-platform"}
      ]
    }
  ]
}

---

Example Response

{
  "trends": [
    {
      "label": "trend name",
      "aliases": ["alternative name 1", "alternative name 2"],
      "definition": "A description of what this trend means and represents",
      "growth": 123,
      "growthCategory": "EXPLODING|SURGING|GROWING",
      "size": 42,
      "sizeCategory": "MAINSTREAM|KNOWN|NICHE",
      "isNew": false,
      "mentions": [
        {
          "entryTitle": "Article headline",
          "feedTitle": "Publication name",
          "mention": "The actual text excerpt containing the trend mention"
        }
      ],
      "smallGraphUrl": ""
    }
  ]
}

---

🔍 Troubleshooting

Error Message	Possible Cause	Solution
"bad request"	Incorrect parameters	Check required fields & formats
"unauthorized"	Invalid token	Verify your Authorization header
"empty response"	No matching trends	Try a broader period or different filters