{"openapi":"3.1.0","info":{"title":"Rising Trends API","version":"1.0.0","description":"Read-only access to Rising Trends data for Pro subscribers.\n\n**Getting your API key**\n\nSign in to your Rising Trends account and visit [risingtrends.co/dashboard/api](https://www.risingtrends.co/dashboard/api) to generate your personal API key. The full key is shown **only once** at creation — copy it somewhere safe. You can revoke and regenerate at any time from the same page.\n\n**Authenticating requests**\n\nPass your key as a Bearer token in the `Authorization` header:\n\n```\nAuthorization: Bearer rt_live_...\n```\n\n**Limits**\n\n30 requests per minute, 100 requests per month per key. Limits reset on the 1st of each month (UTC). Rate limit headers (`X-RateLimit-Remaining-Minute`, `X-RateLimit-Remaining-Month`) are returned on every response.","contact":{"name":"Rising Trends","url":"https://risingtrends.co"}},"servers":[{"url":"https://www.risingtrends.co/api/v1"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Trends database","description":"Search-trend data: keyword growth, monthly search volume history, categories, brand and product flags."},{"name":"Trending products","description":"Trending product keywords on Amazon, with average price, monthly sales, revenue, rating, and the top Amazon listings under each one — linked back to the underlying search trend."},{"name":"Trending websites","description":"Fast-growing websites with traffic history, growth percentages, SEO metrics (backlinks, referring domains, organic keywords), top pages, and a screenshot."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"rt_live_*"}},"schemas":{"Trend":{"type":"object","required":["id","slug","name","categories","is_brand","is_ecom","search_volume","growth_pct"],"properties":{"id":{"type":"string","example":"rt_trend_12345"},"slug":{"type":"string","example":"magnesium-glycinate"},"name":{"type":["string","null"],"example":"magnesium glycinate"},"definition":{"type":["string","null"]},"categories":{"type":"array","items":{"type":"string"},"example":["Supplements","Health"]},"is_brand":{"type":"boolean"},"is_ecom":{"type":"boolean"},"search_volume":{"type":"object","properties":{"latest":{"type":["number","null"],"example":165000},"history":{"type":"object","additionalProperties":{"type":"number"},"description":"Map of YYYY-MM → monthly search volume.","example":{"2024-01":90000,"2024-02":110000}}}},"growth_pct":{"type":"object","properties":{"3m":{"type":["number","null"]},"6m":{"type":["number","null"]},"1y":{"type":["number","null"]},"2y":{"type":["number","null"]},"5y":{"type":["number","null"]}}},"dashboard_url":{"type":["string","null"]}}},"TrendList":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Trend"}},"next_cursor":{"type":["string","null"],"description":"Pagination token for the next page. Pass it back as the `cursor` query param to fetch more results. `null` when there are no more pages."}}},"TrendingProduct":{"type":"object","required":["id","keyword"],"description":"A trending product on Amazon — a keyword (e.g. \"magnesium glycinate\", \"cordless drill\") with aggregated metrics across the top Amazon listings for that search, plus the linked Rising Trends search trend.","properties":{"id":{"type":"string","example":"rt_product_4821"},"keyword":{"type":["string","null"],"example":"magnesium glycinate"},"category":{"type":["string","null"],"enum":["Health","Supplements","Beauty & Personal Care","Food & Beverage","Home","Kitchen","Fashion & Accessories","Electronics & Smart Home","Gaming","Fitness","Sports & Outdoors","Pet Supplies","Baby, Kids & Toys","Tools, Garden & DIY",null],"example":"Supplements"},"avg_price":{"type":["number","null"],"example":24.99},"avg_monthly_sales":{"type":["number","null"],"example":1200},"avg_revenue":{"type":["number","null"],"example":30000},"avg_rating":{"type":["number","null"],"example":4.5},"avg_review_count":{"type":["number","null"],"example":850},"listings_count":{"type":["number","null"],"example":30},"listings_with_sales":{"type":["number","null"],"example":24},"trend":{"type":["object","null"],"description":"The Rising Trends search trend linked to this trending product.","properties":{"id":{"type":"string","example":"rt_trend_12345"},"slug":{"type":["string","null"],"example":"magnesium-glycinate"},"name":{"type":["string","null"]},"definition":{"type":["string","null"]},"categories":{"type":"array","items":{"type":"string"}},"search_volume":{"type":"object","properties":{"latest":{"type":["number","null"]}}},"growth_pct":{"type":"object","properties":{"3m":{"type":["number","null"]},"6m":{"type":["number","null"]},"1y":{"type":["number","null"]},"2y":{"type":["number","null"]},"5y":{"type":["number","null"]}}},"dashboard_url":{"type":["string","null"]}}},"top_listings":{"type":"array","description":"Top Amazon listings for this trending product, ordered by Amazon rank ascending. Length is controlled by the `top_listings_limit` query parameter (default 10, max 30).","items":{"$ref":"#/components/schemas/AmazonListing"}},"dashboard_url":{"type":["string","null"]}}},"TrendingProductList":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TrendingProduct"}},"next_cursor":{"type":["string","null"],"description":"Pagination token for the next page. Pass it back as the `cursor` query param. `null` when there are no more pages."}}},"AmazonListing":{"type":"object","description":"An individual Amazon product listing.","required":["id","title","is_best_seller","is_amazon_choice"],"properties":{"id":{"type":"string","example":"rt_listing_98123"},"rank":{"type":["number","null"],"example":1},"title":{"type":["string","null"]},"image_url":{"type":["string","null"]},"amazon_url":{"type":["string","null"]},"price":{"type":["number","null"],"example":24.99},"monthly_sales":{"type":["number","null"],"example":5400},"estimated_revenue":{"type":["number","null"],"example":134000},"rating":{"type":["number","null"],"example":4.6},"review_count":{"type":["number","null"],"example":12500},"is_best_seller":{"type":"boolean"},"is_amazon_choice":{"type":"boolean"}}},"TrendingWebsite":{"type":"object","required":["id","domain"],"description":"A trending website with its traffic history, growth percentages, SEO metrics, and top-performing pages.","properties":{"id":{"type":"string","example":"rt_website_a1b2c3d4"},"domain":{"type":["string","null"],"example":"chatgpt.com"},"description":{"type":["string","null"]},"website_type":{"type":["string","null"],"enum":["software","content","e-commerce","services",null],"example":"software"},"categories":{"type":"array","items":{"type":"string"},"example":["Artificial Intelligence","Software"]},"domain_registration_date":{"type":["string","null"],"example":"2022-11-30"},"domain_authority":{"type":["number","null"],"example":86},"target_audience":{"type":["string","null"]},"traffic":{"type":"object","properties":{"current_monthly":{"type":["number","null"],"example":63191789},"history":{"type":"object","additionalProperties":{"type":"number"},"description":"Map of YYYY-MM → estimated monthly traffic.","example":{"2024-12":8107422,"2025-01":7802456}}}},"growth_pct":{"type":"object","properties":{"6m":{"type":["number","null"]},"1y":{"type":["number","null"]},"2y":{"type":["number","null"]},"max":{"type":["number","null"]}}},"seo":{"type":"object","properties":{"total_backlinks":{"type":["number","null"]},"referring_domains":{"type":["number","null"]},"organic_keywords":{"type":["number","null"]},"organic_keywords_last_month":{"type":["number","null"]}}},"top_pages":{"type":"array","description":"Top-performing pages on the domain, ordered by traffic. Capped at 10 items per website.","items":{"$ref":"#/components/schemas/WebsiteTopPage"}},"screenshot_url":{"type":["string","null"]},"dashboard_url":{"type":["string","null"]}}},"WebsiteTopPage":{"type":"object","properties":{"url":{"type":["string","null"]},"title":{"type":["string","null"]},"traffic":{"type":["number","null"]},"backlinks":{"type":["number","null"]},"referring_domains":{"type":["number","null"]}}},"TrendingWebsiteList":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TrendingWebsite"}},"next_cursor":{"type":["string","null"],"description":"Pagination token for the next page. Pass it back as the `cursor` query param. `null` when there are no more pages."}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"docs_url":{"type":"string"}}}}}}},"paths":{"/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/trends":{"get":{"tags":["Trends database"],"summary":"Search trends","description":"**What it does**\n\nReturns a paginated list of trends matching your filters. Narrow results by category, brand vs keyword, product vs service, minimum search volume, and minimum growth over a specific timeframe. Sort by growth, search volume, or date added.\n\n**How to use it**\n\nCombine filters to find trends matching specific criteria. The most powerful pattern: set a `timeframe`, sort by `growth`, then add `category` and `min_search_volume` to scope and reduce noise. Walk the full result set using `next_cursor` from each response.\n\nExample — find ecom keywords (not brands) that grew 100%+ in the past year with at least 1,000 monthly searches:\n\n```\nGET /trends?is_ecom=true&is_brand=false&min_growth_pct=100&timeframe=1y&min_search_volume=1000&sort=growth\n```\n\n**What people build with it**\n\n- **Rising-keyword finder for SEO** — schedule a weekly query in your category to surface long-tail keywords before they're saturated.\n- **Product opportunity scanner for ecom** — combine `is_ecom=true&is_brand=false&min_growth_pct=100` to surface generic physical products primed for private label or dropshipping.\n- **Newsletter / content automation** — pull the top 20 rising trends in your beat each Monday and feed them into your CMS as draft topics.","parameters":[{"name":"is_brand","in":"query","schema":{"type":"boolean"},"description":"Filter to brand trends (true) or non-brand (false)."},{"name":"is_ecom","in":"query","schema":{"type":"boolean"},"description":"Filter to physical product trends."},{"name":"category","in":"query","schema":{"type":"string","enum":["Accessories","Activities & Hobbies","Agriculture","Alcohol","Alternative Medicine","Art & Design","Artificial Intelligence","Autos & Vehicles","Banking","Beauty Tools","Beverages","Books & Literature","Clothing","Construction","Consumer Electronics","Cooking & Recipes","Crypto","Cybersecurity","Education","Energy","Entrepreneurship","Family & Relationships","Fitness","Food","Footwear","Gambling","Gaming","Gardening","Haircare","Health Conditions","Home Appliances","Home Improvement","Human Resources","Insurance","Interior Design","Internet of Things (IoT)","Investing","Jewelry","Legal","Logistics & Supply Chain","Luxury","Makeup & Cosmetics","Management","Manufacturing","Marketing","Mental Health","Mining","Movies & Television","Music","Nutrition","Personal Finance","Pets","Pharmacy","Real Estate","Retail","Science","Skincare","Sleep","Social Issues","Software","Sports","Sustainability","Taxation","Travel","VR & AR","Vitamins & Supplements","Workplace"]},"description":"Single category match (case-sensitive). One of the values listed below."},{"name":"min_search_volume","in":"query","schema":{"type":"integer","minimum":0},"description":"Filter trends whose latest monthly search volume ≥ value."},{"name":"timeframe","in":"query","schema":{"type":"string","enum":["3m","6m","1y","2y","5y"],"default":"5y"},"description":"Growth window. Used by `sort=growth` and `min_growth_pct`."},{"name":"min_growth_pct","in":"query","schema":{"type":"number"},"description":"Filter trends whose growth in the selected `timeframe` ≥ value."},{"name":"sort","in":"query","schema":{"type":"string","enum":["growth","search_volume","date_added"],"default":"search_volume"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Pagination token. To get the next page of results, take the `next_cursor` value from the previous response and pass it here. Treat the value as a black box — don't try to construct or modify it."}],"responses":{"200":{"description":"List of trends","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendList"}}}},"400":{"description":"invalid_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_api_key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"subscription_required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limit_exceeded or monthly_quota_exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/trends/{slug}":{"get":{"tags":["Trends database"],"summary":"Trend details","description":"**What it does**\n\nReturns the full profile of a single trend: definition, all categories, complete monthly search volume history (going back to when the trend first appeared), growth percentages across timeframes (3m, 6m, 1y, 2y, 5y), brand and product flags, and a dashboard link.\n\n**How to use it**\n\nPass the trend's `slug`, which you'll typically get from a `Search trends` response or from a dashboard URL like `/dashboard/trend/magnesium-glycinate`. Use this endpoint whenever you need the full search volume time series — for charting, forecasting, or pulling out specific data points.\n\nExample:\n\n```\nGET /trends/magnesium-glycinate\n```\n\n**What people build with it**\n\n- **Pitch / thesis validators** — verify a startup or product claim like \"this market is exploding\" against real growth numbers, in seconds.\n- **Trend trajectory charts** — feed the monthly history into a charting library (Chart.js, Recharts) to visualize the curve — early growth, peak, decline.\n- **Campaign launch timing** — plot the search volume curve to pick the right month to release a product, push content, or send a press pitch.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"magnesium-glycinate"}],"responses":{"200":{"description":"The trend","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Trend"}}}},"401":{"description":"invalid_api_key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"subscription_required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limit_exceeded or monthly_quota_exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/products":{"get":{"tags":["Trending products"],"summary":"Search products","description":"**What it does**\n\nReturns a paginated list of trending products on Amazon. Each result is a keyword (e.g. \"magnesium glycinate\", \"cordless drill\") with aggregated metrics — average price, monthly sales, revenue, rating, review count — across the top Amazon listings for that search. Each trending product is linked to its underlying Rising Trends search trend (with growth and search volume).\n\n**How to use it**\n\nFilter by `category` to scope to a product vertical (Supplements, Kitchen, Pet Supplies, etc. — see the parameter enum), then add price/rating/sales floors and pick a `sort` to surface high-revenue or fast-growing niches. Use `sort=growth` with a `timeframe` to find products whose underlying search trend is accelerating. Walk pages with `next_cursor`. Each response embeds the top Amazon listings — control the count with `top_listings_limit` (or set it to `0` to skip the lookup).\n\nExample — supplements under $50 with rating ≥ 4.0, sorted by underlying trend growth over the past year:\n\n```\nGET /products?category=Supplements&max_price=50&min_rating=4&sort=growth&timeframe=1y\n```\n\n**What people build with it**\n\n- **Private-label opportunity scanner** — combine `sort=revenue` with high `min_growth_pct` to find products with proven demand and accelerating interest.\n- **Niche research dashboards** — pull the top trending products per `category` weekly and chart the leaderboard over time.\n- **Affiliate / content site planning** — surface rising products in your vertical to seed editorial calendars.","parameters":[{"name":"category","in":"query","schema":{"type":"string","enum":["Health","Supplements","Beauty & Personal Care","Food & Beverage","Home","Kitchen","Fashion & Accessories","Electronics & Smart Home","Gaming","Fitness","Sports & Outdoors","Pet Supplies","Baby, Kids & Toys","Tools, Garden & DIY"]},"description":"Filter to a single product category (e.g. `Supplements`, `Beauty & Personal Care`, `Kitchen`). See enum below for the full list."},{"name":"search","in":"query","schema":{"type":"string","maxLength":120},"description":"Case-insensitive substring match against the product keyword."},{"name":"min_search_volume","in":"query","schema":{"type":"integer","minimum":0},"description":"Filter by the linked trend's latest monthly search volume."},{"name":"min_price","in":"query","schema":{"type":"number","minimum":0},"description":"Filter by average listing price (≥)."},{"name":"max_price","in":"query","schema":{"type":"number","minimum":0},"description":"Filter by average listing price (≤)."},{"name":"min_rating","in":"query","schema":{"type":"number","minimum":0,"maximum":5},"description":"Filter by average listing rating (≥)."},{"name":"min_monthly_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Filter by average listing monthly sales (≥)."},{"name":"min_growth_pct","in":"query","schema":{"type":"number"},"description":"Filter by the linked trend's growth in the selected `timeframe` (≥)."},{"name":"timeframe","in":"query","schema":{"type":"string","enum":["3m","6m","1y","2y","5y"],"default":"1y"},"description":"Growth window. Used by `sort=growth` and `min_growth_pct`."},{"name":"sort","in":"query","schema":{"type":"string","enum":["revenue","sales","price","rating","reviews","search_volume","growth"],"default":"revenue"},"description":"`revenue`, `sales`, `price`, `rating`, `reviews` sort by the trending product's own averages. `search_volume` and `growth` sort by the linked trend."},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Pagination token from a previous response's `next_cursor`. Treat as opaque."},{"name":"top_listings_limit","in":"query","schema":{"type":"integer","minimum":0,"maximum":30,"default":10},"description":"Number of top Amazon listings to embed under each returned trending product. Set to `0` to skip the listings lookup if you only need product-level metrics."}],"responses":{"200":{"description":"List of trending products","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendingProductList"}}}},"400":{"description":"invalid_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_api_key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"subscription_required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limit_exceeded or monthly_quota_exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/websites":{"get":{"tags":["Trending websites"],"summary":"Search websites","description":"**What it does**\n\nReturns a paginated list of fast-growing websites. Each result includes the domain's full traffic history (month-by-month), growth percentages across timeframes (6m, 1y, 2y, max), SEO metrics (backlinks, referring domains, organic keywords), the domain's top-performing pages, and a screenshot. Filter by category, website type, domain authority, domain age, traffic floor, referring-domain floor, and growth.\n\n**How to use it**\n\nCombine `website_type` (e.g. `software`) with a `category` (e.g. `Artificial Intelligence`) and `min_growth_pct` over a `timeframe` to surface the fastest-growing sites in a niche. Use `max_domain_age_years` to scope to newer sites. Sort by `traffic`, `growth`, or `domain_authority`. Walk pages with `next_cursor`.\n\nExample — AI software sites under 3 years old that grew 100%+ in the past year, sorted by traffic:\n\n```\nGET /websites?website_type=software&category=Artificial%20Intelligence&max_domain_age_years=3&min_growth_pct=100&timeframe=1y&sort=traffic\n```\n\n**What people build with it**\n\n- **Competitive intelligence dashboards** — track challenger sites in your category and chart their traffic curves over time.\n- **Investment / acquisition scouting** — surface young, high-growth domains with strong SEO foundations.\n- **SEO benchmarking** — pull leaders in your vertical and compare backlinks, referring domains, and top pages against your own.","parameters":[{"name":"category","in":"query","schema":{"type":"string","enum":["Accessories","Activities & Hobbies","Alcohol","Alternative Medicine","Art & Design","Artificial Intelligence","Autos & Vehicles","Beauty Tools","Beverages","Clothing","Consumer Electronics","Cooking & Recipes","Education","Entrepreneurship","Fitness","Food","Footwear","Gaming","Gardening","Haircare","Health Conditions","Home Appliances","Home Improvement","Interior Design","Jewelry","Legal","Logistics & Supply Chain","Luxury","Makeup & Cosmetics","Management","Manufacturing","Marketing","Mental Health","Movies & Television","Music","Nutrition","Pets","Retail","Skincare","Sleep","Software","Sports","Sustainability","VR & AR","Vitamins & Supplements","Workplace"]},"description":"Filter to a single leaf category (e.g. `Skincare`, `Artificial Intelligence`, `Fitness`). See enum below for the full list."},{"name":"search","in":"query","schema":{"type":"string","maxLength":120},"description":"Case-insensitive substring match against the domain or description."},{"name":"website_type","in":"query","schema":{"type":"string","enum":["software","content","e-commerce","services"]}},{"name":"min_domain_authority","in":"query","schema":{"type":"integer","minimum":0,"maximum":100}},{"name":"max_domain_authority","in":"query","schema":{"type":"integer","minimum":0,"maximum":100}},{"name":"max_domain_age_years","in":"query","schema":{"type":"integer","minimum":1},"description":"Filter to domains registered within the past N years."},{"name":"min_traffic","in":"query","schema":{"type":"integer","minimum":0},"description":"Filter by current monthly traffic (≥)."},{"name":"min_referring_domains","in":"query","schema":{"type":"integer","minimum":0}},{"name":"min_growth_pct","in":"query","schema":{"type":"number"},"description":"Filter by traffic growth in the selected `timeframe` (≥)."},{"name":"timeframe","in":"query","schema":{"type":"string","enum":["6m","1y","2y","max"],"default":"1y"},"description":"Growth window. Used by `sort=growth` and `min_growth_pct`."},{"name":"sort","in":"query","schema":{"type":"string","enum":["traffic","growth","domain_authority"],"default":"traffic"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Pagination token from a previous response's `next_cursor`. Treat as opaque."}],"responses":{"200":{"description":"List of trending websites","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendingWebsiteList"}}}},"400":{"description":"invalid_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_api_key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"subscription_required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limit_exceeded or monthly_quota_exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}