Four type values on get_top_trends take a category string. Without it the feed mixes every board. The four types, from the Trends API MCP server in this session, are Amazon Best Sellers by Category, Google Trends by Category, Top Websites, and Substack by Category. Official names for each sit in the tables below. How to call a live feed is on the live feeds page. The full type list is on the feed catalog.
The four types
type |
Matching | Default used on the docs playground |
|---|---|---|
Amazon Best Sellers by Category |
Case-sensitive | Toys Games |
Google Trends by Category |
Case-insensitive | Games |
Top Websites |
Case-insensitive | finance |
Substack by Category |
Case-insensitive | Finance |
POST https://api.trendsapi.ai/api
Authorization: Bearer <api_key>
Content-Type: application/json
{"mode":"get_top_trends","type":"Google Trends by Category","category":"Games","limit":10}
Parse the string body before reading data. Unknown names return an error that lists valid categories.
What an omitted category looks like
This session's MCP pull for Google Trends by Category with no category, limit 1, snapshot 2026-08-27T18:01:38Z, returned:
| Rank | Term | Category path |
|---|---|---|
| 1 | lunar eclipse august 2026 | Science |
That row is a mixed board. Science is one official Google topic. It is not a substitute for passing category.
Amazon Best Sellers by Category
Case-sensitive. These are the official strings.
Appliances, Apps Games, Arts Crafts Sewing, Automotive, Baby, Beauty Personal Care, Books, Camera Photo, Clothing Shoes Jewelry, Computers Accessories, Electronics, Grocery Gourmet Food, Handmade Products, Health Household, Home Kitchen, Industrial Scientific, Kitchen Dining, Musical Instruments, Office Products, Patio Lawn Garden, Pet Supplies, Software, Sports Outdoors, Tools Home Improvement, Toys Games, Video Games.
Google Trends by Category
Google Trending Now topics, not Explore category IDs. There is no Books topic. Matching is case-insensitive.
Autos and Vehicles, Beauty and Fashion, Business and Finance, Climate, Entertainment, Food and Drink, Games, Health, Hobbies and Leisure, Jobs and Education, Law and Government, Other, Pets and Animals, Politics, Science, Shopping, Sports, Technology, Travel and Transportation.
Top Websites
Top-level slugs. Subcategories use parent/child, for example finance/investing. Matching is case-insensitive.
adult, arts-and-entertainment, business-and-consumer-services, community-and-society, computers-electronics-and-technology, e-commerce-and-shopping, finance, food-and-drink, gambling, games, health, heavy-industry-and-engineering, hobbies-and-leisure, home-and-garden, jobs-and-career, law-and-government, lifestyle, news-and-media, pets-and-animals, reference-materials, science-and-education, sports, travel-and-tourism, vehicles.
Substack by Category
The unfiltered newsletter board is the separate type Substack. Matching is case-insensitive.
Art & Illustration, Business, Climate & Environment, Comics, Crypto, Culture, Design, Education, Faith & Spirituality, Fashion & Beauty, Fiction, Film & TV, Finance, Food & Drink, Health & Wellness, Health Politics, History, Home & Garden, Humor, International, Literature, Music, News, Parenting, Philosophy, Science, Sports, Technology, Travel, U.S. Politics, World Politics.
The HTTP contract is on the API reference. Plan names stay on pricing.