Retail Trends Search Actor

A powerful Apify actor that searches for trending keywords and products using the retailtrends.ai API. Discover what's popular in specific niches, get structured product data with pricing and sales information, and analyze trend growth metrics for market research and e-commerce insights.

🚀 Features

• Comprehensive Trend Search: Find trending keywords and products across various categories
• Product-Specific Data: Get detailed product information including pricing, sales, and reviews
• Advanced Filtering: Filter by search volume, categories, and growth rates
• Multiple Sorting Options: Sort results by volume, growth rate, or alphabetically
• Robust Error Handling: Comprehensive error handling with retry logic and detailed logging
• Flexible Output: Structured JSON output with multiple dataset views
• Performance Optimized: Async processing with configurable timeouts and retry mechanisms

📋 Table of Contents

• Quick Start
• Input Parameters
• Output Format
• Usage Examples
• API Limitations
• Troubleshooting
• Development
• Support

🏃 Quick Start

Running on Apify Platform

1. Visit the Actor Page: Go to Retail Trends Search Actor on Apify Console
2. Configure Input: Set your search parameters (see Input Parameters)
3. Run the Actor: Click "Start" and wait for results
4. Download Results: Export data in JSON, CSV, or Excel format

Basic Example

{
  "q": "wireless headphones",
  "products_only": true
}

🔧 Input Parameters

Parameter	Type	Required	Default	Description
q	string	✅	"ai"	The search query to find trending keywords/products
products_only	boolean	❌	false	If true, returns only product results. If false, returns both trending keywords and products

Parameter Details

q (Query)

• Format: 1-200 characters
• Examples: "wireless headphones", "gaming chair", "organic skincare"
• Tips: Use specific terms for better results; avoid overly broad queries

products_only

• Format: Boolean (true/false)
• Default: false
• Behavior:
  • true: Returns only trending products with detailed product data
  • false: Returns both trending keywords and products

📊 Output Format

The actor outputs structured JSON data with the following format:

Example Product Item (truncated)

{
  "id": "q3r0310yp7b9exd",
  "keyword": "Wood Headphones",
  "path": "wood-headphones",
  "description": "Wood headphones are audio devices that use wooden components in their ear cups or housing to enhance sound quality and aesthetics. The use of wood, such as walnut, maple, or mahogany, helps create a natural resonance, improving warmth, depth, and acoustics while offering a unique and stylish design. These headphones are primarily targeted at audiophiles, music enthusiasts, and individuals seeking a premium, high-fidelity listening experience with a distinctive, organic aesthetic.",
  "date_added": 0,
  "categories": "[\"technology\",\"design\",\"entertainment\",\"media\"]",
  "absolute_volume": 880,
  "pro": false,
  "branded": false,
  "search_history": "",
  "channel_breakdown": "{\"facebook\":0.28626114844339096,\"instagram\":0.08404466971314399,\"linkedin\":0,\"pinterest\":0.6296631665478175,\"reddit\":0.3723805712703829,\"tiktok\":0.13933605134330057,\"twitter\":0.07525668186780549,\"youtube\":0.4540589832082716}",
  "related_trends": "[{\"keyword\":\"symphonized wood headphones\",\"volume\":40,\"growth\":33,\"search_history_last_12_mo\":[30,40,40,30,30,10,20,70,40,20,30,40]},{\"keyword\":\"wood cup headphones\",\"volume\":20,\"growth\":100,\"search_history_last_12_mo\":[10,10,20,10,10,10,10,10,10,20,20,20]},{\"keyword\":\"wood headset holder\",\"volume\":480,\"growth\":50,\"search_history_last_12_mo\":[320,260,320,320,390,480,480,390,390,390,320,480]},{\"keyword\":\"wood headphone stand diy\",\"volume\":50,\"growth\":25,\"search_history_last_12_mo\":[40,40,50,50,40,40,70,90,50,50,70,50]},{\"keyword\":\"wood headphone holder\",\"volume\":480,\"growth\":50,\"search_history_last_12_mo\":[320,260,320,320,390,480,480,390,390,390,320,480]},{\"keyword\":\"drums with headphones\",\"volume\":880,\"growth\":49,\"search_history_last_12_mo\":[590,590,590,720,1300,1900,1900,720,590,720,720,880]},{\"keyword\":\"b39 wireless headphones\",\"volume\":90,\"growth\":125,\"search_history_last_12_mo\":[40,70,90,50,90,70,140,140,110,110,110,90]},{\"keyword\":\"headphones ideas\",\"volume\":70,\"growth\":40,\"search_history_last_12_mo\":[50,50,50,70,50,50,70,70,70,90,90,70]},{\"keyword\":\"wired headphones near me\",\"volume\":1900,\"growth\":46,\"search_history_last_12_mo\":[1300,1600,1600,1300,1300,1300,1300,1300,1600,1600,1600,1900]},{\"keyword\":\"meze wood headphones\",\"volume\":20,\"growth\":100,\"search_history_last_12_mo\":[10,10,10,0,10,10,10,10,10,10,10,20]},{\"keyword\":\"jvc wood headphones\",\"volume\":20,\"growth\":100,\"search_history_last_12_mo\":[10,30,40,30,30,20,30,20,20,10,10,20]},{\"keyword\":\"k10 headphones\",\"volume\":30,\"growth\":50,\"search_history_last_12_mo\":[20,20,30,30,20,40,50,30,30,30,30,30]},{\"keyword\":\"wood headset stand\",\"volume\":390,\"growth\":22,\"search_history_last_12_mo\":[320,390,390,480,390,480,720,590,390,390,390,390]},{\"keyword\":\"70s headphones\",\"volume\":590,\"growth\":23,\"search_history_last_12_mo\":[480,590,590,590,590,590,480,590,590,720,590,590]},{\"keyword\":\"cool headphones\",\"volume\":3600,\"growth\":24,\"search_history_last_12_mo\":[2900,3600,3600,2900,2900,3600,3600,2900,2400,2900,2900,3600]},{\"keyword\":\"q30 headphones\",\"volume\":1000,\"growth\":14,\"search_history_last_12_mo\":[880,880,2400,1300,1000,1300,1000,880,880,880,1000,1000]},{\"keyword\":\"true wireless headphones\",\"volume\":2900,\"growth\":21,\"search_history_last_12_mo\":[2400,3600,2900,2900,2900,2900,3600,2900,2400,2900,2400,2900]},{\"keyword\":\"sennheiser wooden headphones\",\"volume\":20,\"growth\":100,\"search_history_last_12_mo\":[10,10,10,10,20,20,10,10,20,20,20,20]},{\"keyword\":\"headphones holder diy\",\"volume\":260,\"growth\":24,\"search_history_last_12_mo\":[210,260,260,260,210,260,260,260,170,210,210,260]},{\"keyword\":\"headphone holder wood\",\"volume\":480,\"growth\":50,\"search_history_last_12_mo\":[320,260,320,320,390,480,480,390,390,390,320,480]},{\"keyword\":\"diy waterproof headphones\",\"volume\":10,\"growth\":900,\"search_history_last_12_mo\":[0,10,10,10,10,10,10,10,10,10,10,10]}]",
  "key_indicators": "{\"growth\":\"Regular\",\"speed\":\"Exponential\",\"seasonality\":\"High\",\"volatility\":\"Low\",\"sentiment\":\"Positive\",\"forecast\":\"Stationary\"}",
  "classifications": "{\"3\":\"regular\",\"6\":\"regular\",\"12\":\"regular\",\"24\":\"regular\",\"60\":\"regular\",\"120\":\"peaked\",\"180\":\"peaked\",\"forecast_12\":\"regular\"}",
  "product_data": "{\"bestSellers\":{\"products\":[{\"asinNumber\":\"B00YJRB0C2\",\"brand\":\"Symphonized\",\"monthlyRevenue\":\"$300.00\",\"monthlySales\":\"15\",\"price\":\"$20.00\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574144.png\",\"productTitle\":\"Symphonized ALN Premium Genuine Wood in-Ear Noise-isolating Headphones, Earbuds, Earphones with Mic (Black)\",\"reviewStars\":5,\"seller\":\"Symphonized\"},{\"asinNumber\":\"B09X1R9PMX\",\"brand\":\"FINGERINSPIRE\",\"monthlyRevenue\":\"$66.32\",\"monthlySales\":\"8\",\"price\":\"$8.29\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574154.png\",\"productTitle\":\"FINGERINSPIRE Headphones Stencil for Painting 11.7x8.3inch Reusable Headphones Drawing Stencil Music Theme Stencil Reusable Music Notes Stencils for Painting on Wood Tile Paper Fabric Floor and Wall\",\"reviewStars\":4,\"seller\":\"FINGERINSPIRE US\"},{\"asinNumber\":\"B0899G3JV4\",\"brand\":\"JVC\",\"monthlyRevenue\":\"$499.99\",\"monthlySales\":\"1\",\"price\":\"$499.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574072.png\",\"productTitle\":\"JVC HASW01 Wood Series Hi-Res Over-Ear Headphones, Wood Dome Driver Unit, Multi Layer Natural Wood Housing, HASW01\",\"reviewStars\":5,\"seller\":\"West Peak Retail\"},{\"asinNumber\":\"B0CJMZXZXL\",\"brand\":\"DesignSkinz\",\"monthlyRevenue\":\"$101.70\",\"monthlySales\":\"6\",\"price\":\"$16.95\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574194.png\",\"productTitle\":\"DesignSkinz - Compatible with AirPods Max Headphones - Skin Decal Protective Scratch Resistant Vinyl Wrap - Raw Wood Planks V11\",\"reviewStars\":5,\"seller\":\"DesignSkinz\"},{\"asinNumber\":\"B0DH9N41HD\",\"brand\":\"Audeze\",\"monthlyRevenue\":\"$2,985.00\",\"monthlySales\":\"3\",\"price\":\"$995.00\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574093.png\",\"productTitle\":\"Audeze LCD-2 High Performance Audiophile Open Back Over Ear Headphones (Padauk Wood)\",\"reviewStars\":5,\"seller\":\"ListenUp\"},{\"asinNumber\":\"B01N9BE85S\",\"brand\":\"kalibri\",\"monthlyRevenue\":\"$332.91\",\"monthlySales\":\"9\",\"price\":\"$36.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574219.png\",\"productTitle\":\"kalibri Wooden Omega Headphone Stand - Universal Headset Wood Hanger - Holder for Gaming Headsets DJ Studio Headphones \\u0026 Earphone Display - Walnut\",\"reviewStars\":4,\"seller\":\"KW-Commerce-US\"},{\"asinNumber\":\"B07LH7QWGB\",\"brand\":\"2X Mobile\",\"monthlyRevenue\":\"$116.87\",\"monthlySales\":\"13\",\"price\":\"$8.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574178.png\",\"productTitle\":\"Earth-Budz - Genuine Wood Earbuds, in-Ear Noise-Isolating Headphones, with in-line Microphone. (Earth Diver)\",\"reviewStars\":5,\"seller\":\"Our Amendments\"},{\"asinNumber\":\"B0CB7VQZ7W\",\"brand\":\"COREMINDED\",\"monthlyRevenue\":\"$8,921.43\",\"monthlySales\":\"357\",\"price\":\"$24.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574204.png\",\"productTitle\":\"Universal Headphone Stand for Desk - Solid Wood Headset Stand for Desk - Heavy Duty Headphone Holder Desk Stand Wood, Gaming Headphone Stand, Wood Headphones Stand Compatible with Airpods Max and More\",\"reviewStars\":4,\"seller\":\"COREMINDED\"},{\"asinNumber\":\"B0D6BCFW4M\",\"brand\":\"SWMIUSK\",\"monthlyRevenue\":\"$356.79\",\"monthlySales\":\"21\",\"price\":\"$16.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574209.png\",\"productTitle\":\"Noise Reduction Ear Plug Headphones for Work, Nylon Braided Cord, Lawn Mowing, Wood Sawing, Construction Worker Earbuds (47inch)\",\"reviewStars\":5,\"seller\":\"Outsporter\"},{\"asinNumber\":\"B0D8GDJPFG\",\"brand\":\"NewFantasia\",\"monthlyRevenue\":\"$480.00\",\"monthlySales\":\"5\",\"price\":\"$96.00\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574298.png\",\"productTitle\":\"NewFantasia 6.35mm Audio Cable Replacement Upgrade Audio Cable Compatible with Sennheiser HD800, HD800S, HD820 Headphones 6N OCC Copper Silver Plated Cord Walnut Wood Shell\",\"reviewStars\":4,\"seller\":\"NewFantasiaDirect\"},{\"asinNumber\":\"B0D1XSMYHJ\",\"brand\":\"QWORK\",\"monthlyRevenue\":\"$75.88\",\"monthlySales\":\"4\",\"price\":\"$18.97\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574109.png\",\"productTitle\":\"QWORK Wood Headphone Stand - Headset Holder, Arch Bridge Design - Universal Compatibility, Ear Headphones Hanger Holder, Stylish Desk Headset Holder for Headphones, Cables, Game Pads\",\"reviewStars\":5,\"seller\":\"Qshave\"},{\"asinNumber\":\"B00QM4POIG\",\"brand\":\"SAMDI\",\"monthlyRevenue\":\"$16,485.15\",\"monthlySales\":\"485\",\"price\":\"$33.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574080.png\",\"productTitle\":\"SAMDI Wood Headphone Stand, Headphones Hanger Holder Mount Omega Compatible for Sony, Bose, Shure, Jabra, JBL, AKG Gaming Headphones Display et. (Walnut)\",\"reviewStars\":4,\"seller\":\"SAMDI Direct\"},{\"asinNumber\":\"B0DBSHZC63\",\"brand\":\"RITEVA\",\"monthlyRevenue\":\"$230.93\",\"monthlySales\":\"7\",\"price\":\"$32.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574335.png\",\"productTitle\":\"RITEVA Bamboo Bedside Shelf, College Dorm Room Essentials, Bunk Bed Nighstand, Bamboo Furniture, Floating Nighstand, Wood Furniture, Minimalist Room Decor, Headphones Hook, Sturdy Floating Nighstand.\",\"reviewStars\":5,\"seller\":\"RITEVA\"},{\"asinNumber\":\"B0BDJ6DNXX\",\"brand\":\"eDealz\",\"monthlyRevenue\":\"$55.96\",\"monthlySales\":\"4\",\"price\":\"$13.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574269.png\",\"productTitle\":\"eDealz in-Ear Wireless Bluetooth 5.2 Headphones, Earbuds IPX6 Waterproof with Microphone Rechargeable USB C Case Retro Wood for Smartphones Android iOS (Mahogany)\",\"reviewStars\":5,\"seller\":\"TRONIXPRO\"},{\"asinNumber\":\"B082V4TCZR\",\"brand\":\"Linkidea\",\"monthlyRevenue\":\"$1,781.34\",\"monthlySales\":\"66\",\"price\":\"$26.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574228.png\",\"productTitle\":\"Linkidea Wooden Omega Headphones Stand/Wooden Headphone Hanger/Wood Headset Holder/Omega Earphone Desk Display Hanger - Wooden Headsets Walnut Finish\",\"reviewStars\":4,\"seller\":\"LinkIdea\"},{\"asinNumber\":\"B0CRKT7BXD\",\"brand\":\"Micool\",\"monthlyRevenue\":\"$986.53\",\"monthlySales\":\"47\",\"price\":\"$20.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574255.png\",\"productTitle\":\"Micool Headphone Stand, Aluminium and Wood Gaming Headset Stand Holder for All Size Headphones with Stable Heavy Base, Headphone Holder for Desk\",\"reviewStars\":4,\"seller\":\"Micool\"},{\"asinNumber\":\"B09P8BGDH3\",\"brand\":\"SIKAI CASE\",\"monthlyRevenue\":\"$124.45\",\"monthlySales\":\"5\",\"price\":\"$24.89\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574088.png\",\"productTitle\":\"SIKAI CASE Bamboo Headphones Stand for Desk,U-Shaped Arc Design,Aluminum Alloy Non-Slip Base,Wood Headphones Stand for Desk Compatible with On-Ear Headphones for Study/Bedroom/Office(Grey)\",\"reviewStars\":4,\"seller\":\"SIKAI CASE®\"},{\"asinNumber\":\"B0B5VRKFDT\",\"brand\":\"Sony\",\"monthlyRevenue\":\"$39,129.09\",\"monthlySales\":\"91\",\"price\":\"$429.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574267.png\",\"productTitle\":\"Sony WH-1000XM5 Wireless Industry Leading Noise Canceling Headphones, Black Bundle with Deco Gear Wood Headphone Display Stand and Protective Travel Carry Case\",\"reviewStars\":5,\"seller\":\"Beach Camera Same Day Shipping\"},{\"asinNumber\":\"B0885M8731\",\"brand\":\"Oakywood\",\"monthlyRevenue\":\"$400.00\",\"monthlySales\":\"4\",\"price\":\"$100.00\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574345.png\",\"productTitle\":\"Oakywood 2-in-1 Wooden Headphone Stand with Wireless Charging - Wood Headphone Holder – Stainless-Steel Base – Handcrafted Headphones Stand for Desk - Qi-Compatible Wireless Charging – Walnut\",\"reviewStars\":5,\"seller\":\"Oakywood.shop\"},{\"asinNumber\":\"B0C2MX76NH\",\"brand\":\"NEEDBUY\",\"monthlyRevenue\":\"$11.98\",\"monthlySales\":\"2\",\"price\":\"$5.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574310.png\",\"productTitle\":\"B7000 110ML Adhesive for Rubber, Plastic, Leather, Wood, Paper, Glass, Metal,Glue DIY Handicrafts Rhinestone Ornaments, Borders, Lights, Cloth, Headphones,Phone Screen Repair (B7000 110ML)\",\"reviewStars\":5,\"seller\":\"dayidamaoyi\"},{\"asinNumber\":\"B0CYHDKJHD\",\"brand\":\"HEWYIOS\",\"monthlyRevenue\":\"$149.90\",\"monthlySales\":\"10\",\"price\":\"$14.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574324.png\",\"productTitle\":\"HEWYIOS Wood Headphone Stand Wall Mount Holder, Sticky Headset Hook, Under Desk Headphone Hanger,Foldable Desk Headphone Hanger Earphone Clamp for Audio,Studio \\u0026 Gaming Headphones\",\"reviewStars\":5,\"seller\":\"HongchunMarchStore\"},{\"asinNumber\":\"B0CRKQXK5W\",\"brand\":\"BEVCEFCC\",\"monthlyRevenue\":\"$288.61\",\"monthlySales\":\"19\",\"price\":\"$15.19\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574238.png\",\"productTitle\":\"BEVCEFCC Headphone Stand Headset Holder with Wood and Aluminum Desktop Headphone Stand Headset Stand for Desk with Solid Heavy Base Wood Headphones Stand for All Headphone Sizes (Silver)\",\"reviewStars\":5,\"seller\":\"ITUKDEES\"},{\"asinNumber\":\"B0DLLBMKTW\",\"brand\":\"Generic\",\"monthlyRevenue\":\"$8.00\",\"monthlySales\":\"1\",\"price\":\"$8.00\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574251.png\",\"productTitle\":\"Modern handmade Aspen wood wall hook: minimalist for any interior. A stylish storage solution for headphones, hats, bags, plants, towels – simplicity and convenience for any room (Aspen wood, 1,5In)\",\"reviewStars\":0,\"seller\":\"ecocozy\"},{\"asinNumber\":\"B0B88R9YLQ\",\"brand\":\"Acuvar\",\"monthlyRevenue\":\"$29.98\",\"monthlySales\":\"2\",\"price\":\"$14.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574273.png\",\"productTitle\":\"Acuvar in-Ear Wireless Bluetooth 5.2 Headphones, Earbuds IPX6 Waterproof with Microphone Rechargeable USB C Case Retro Wood for Smartphones Android iOS (Walnut)\",\"reviewStars\":5,\"seller\":\"eCostConnection\"},{\"asinNumber\":\"B07QH5NMPH\",\"brand\":\"Navaris\",\"monthlyRevenue\":\"$1,331.63\",\"monthlySales\":\"37\",\"price\":\"$35.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574236.png\",\"productTitle\":\"Navaris Omega Headphone Stand - Synthetic Leather Headset Hanger with Wood Base - Holder for Wired, Wireless, Gaming, DJ, Studio Headphones - Black\",\"reviewStars\":5,\"seller\":\"KW-Commerce-US\"},{\"asinNumber\":\"B0DGDM7M7V\",\"brand\":\"POCAKE\",\"monthlyRevenue\":\"$161.70\",\"monthlySales\":\"6\",\"price\":\"$26.95\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574225.png\",\"productTitle\":\"POCAKE Headphone Stand Wood, Wooden Headphone Holder, Gaming Headset Stand. Headphone Holder for Desk, Headset Stand Compatible with All Headphones.\",\"reviewStars\":5,\"seller\":\"POCAKE\"},{\"asinNumber\":\"B0B8SS8PK8\",\"brand\":\"lotorasia\",\"monthlyRevenue\":\"$727.87\",\"monthlySales\":\"13\",\"price\":\"$55.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574342.png\",\"productTitle\":\"lotorasia Wired Over Ear Headphones, Studio Headset Music Recording 50mm Drivers 3.5mm/6.35mm Audio Jack for Guitar amp Recording and Music Audiophile（Non Solid Wood）\",\"reviewStars\":5,\"seller\":\"Taihuajinggongshumakeji\"},{\"asinNumber\":\"B078KVKCT7\",\"brand\":\"WraptorSkinz\",\"monthlyRevenue\":\"$29.90\",\"monthlySales\":\"2\",\"price\":\"$14.95\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574090.png\",\"productTitle\":\"Skin Decal Wrap Works with Beats Studio 2 and 3 Wired and Wireless Headphones Wood Grain - Oak 01 Skin Only Headphones NOT Included\",\"reviewStars\":5,\"seller\":\"Matrix Productions, Inc.\"},{\"asinNumber\":\"B0BLH9GKM8\",\"brand\":\"FINGERINSPIRE\",\"monthlyRevenue\":\"$345.06\",\"monthlySales\":\"54\",\"price\":\"$6.39\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574332.png\",\"productTitle\":\"FINGERINSPIRE Banksy Thinking Monkey with Headphones Stencil 11.8x11.8inch Reusable Banksy Chimpanzees Stencil DIY Banksy Decoration Stencil for Painting on Wall, Wood, Furniture, Fabric and Paper\",\"reviewStars\":5,\"seller\":\"FINGERINSPIRE US\"},{\"asinNumber\":\"B0C6GKMD83\",\"brand\":\"FINGERINSPIRE\",\"monthlyRevenue\":\"$352.17\",\"monthlySales\":\"63\",\"price\":\"$5.59\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574328.png\",\"productTitle\":\"FINGERINSPIRE Girl Listening to Music Stencil 8.3x11.7inch Reusable Music Girl Silhouette Painting Template Girl with Headphones Decoration Stencil for Painting on Wood, Wall and Furniture\",\"reviewStars\":4,\"seller\":\"FINGERINSPIRE US\"},{\"asinNumber\":\"B0D64TGKQW\",\"brand\":\"MyGift\",\"monthlyRevenue\":\"$1,203.57\",\"monthlySales\":\"43\",\"price\":\"$27.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574302.png\",\"productTitle\":\"MyGift Premium Acacia Solid Wood and Industrial Black Metal Pipe T-Bar Over Ear Headphones Holder, Tabletop Dual Headphone Display Stand with Accessories Tray\",\"reviewStars\":5,\"seller\":\"MyGift\"},{\"asinNumber\":\"B0CNG7K7RV\",\"brand\":\"Fostex\",\"monthlyRevenue\":\"$629.10\",\"monthlySales\":\"1\",\"price\":\"$629.10\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574069.png\",\"productTitle\":\"Fostex TH616 Premium Open Back Audiophile Headphones, Wood Contruction\",\"reviewStars\":4,\"seller\":\"Amazon\"},{\"asinNumber\":\"B0DFH3XSP7\",\"brand\":\"Slidon\",\"monthlyRevenue\":\"$83.96\",\"monthlySales\":\"4\",\"price\":\"$20.99\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574295.png\",\"productTitle\":\"Slidon Headphone Stand, Headset Stand for Desk, Solid Wood \\u0026 Aviation Aluminum Alloy Headphone Holder Compatible with AirPods Max, Gaming Music Headphones, VR Headset (Grey)\",\"reviewStars\":4,\"seller\":\"WAMDAI\"},{\"asinNumber\":\"B0BF58RZQK\",\"brand\":\"HIFIMAN\",\"monthlyRevenue\":\"$6,192.00\",\"monthlySales\":\"48\",\"price\":\"$129.00\",\"productImage\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738488574312.png\",\"productTitle\":\"HIFIMAN SUNDARA Closed-Back Over-Ear Planar Magnetic Wired Hi-Fi Headphones with Stealth Magnet Design, Detachable Cable, Wood Ear Cups for Home, Studio, Recording\",\"reviewStars\":5,\"seller\":\"HIFIMAN\"}]},\"price\":{\"Value\":\"228.14\"},\"monthlySales\":125,\"monthlyRevenue\":\"$16,724.04\",\"bsr\":{\"Value\":\"119053\"},\"reviewCount\":392,\"reviewRating\":4.4,\"imageUrl\":\"https://explodingtopics.sfo2.digitaloceanspaces.com/1738402019929.png\",\"plainPrice\":{\"Value\":\"228\"},\"plainMonthlyRevenue\":{\"Value\":\"16724\"}}",
  "countries": "[\"BH\",\"CO\",\"ID\",\"JM\",\"KE\",\"SE\",\"UA\",\"CN\",\"SV\",\"IL\",\"LA\",\"LU\",\"BS\",\"US\",\"UZ\",\"CR\",\"DK\",\"FI\",\"DE\",\"MX\",\"PH\",\"TH\",\"AU\",\"BN\",\"CL\",\"MV\",\"MD\",\"NG\",\"PT\",\"CZ\",\"EE\",\"HN\",\"MY\",\"PA\",\"PG\",\"KR\",\"KH\",\"DO\",\"ET\",\"FR\",\"IE\",\"SN\",\"BD\",\"IN\",\"IQ\",\"JP\",\"SA\",\"JO\",\"NZ\",\"TT\",\"TR\",\"BO\",\"BG\",\"KZ\",\"PY\",\"ES\",\"TN\",\"AE\",\"LB\",\"BR\",\"GE\",\"GR\",\"GT\",\"KW\",\"MT\",\"PK\",\"HR\",\"GH\",\"PL\",\"LK\",\"GB\",\"ZM\",\"CY\",\"IT\",\"NP\",\"SK\",\"AZ\",\"HU\",\"ZA\",\"CH\",\"VN\",\"BY\",\"BE\",\"LV\",\"ME\",\"OM\",\"SI\",\"UG\",\"VE\",\"CA\",\"IS\",\"MA\",\"NO\",\"QA\",\"RO\",\"RS\",\"SG\",\"AR\",\"AM\",\"AT\",\"EC\",\"EG\",\"LT\",\"NL\",\"PE\",\"AD\",\"all\"]",
  "country_code": null,
  "country_name": null,
  "avg_monthly_searches": null,
  "competition": null,
  "competition_index": null,
  "low_top_of_page_bid_micros": null,
  "high_top_of_page_bid_micros": null,
  "search_history_data": [],
  "search_history_growth": 0,
  "search_history_data_forecast": [],
  "categories_array": null,
  "product_page_data": null,
  "selected_timeframe": "",
  "channel_breakdown_data": null,
  "key_indicators_data": null,
  "related_trends_data": null,
  "classifications_data": null,
  "countries_array": null,
  "_meta": {
    "query": "headphones",
    "products_only": true,
    "item_type": "product",
    "processed_at": "2025-07-24T16:19:41.994178Z",
    "result_index": 6,
    "total_results": 6
  }

Error Response

{
  "type": "error",
  "error_code": "API_TIMEOUT",
  "message": "Request to retailtrends.ai timed out after 30 seconds",
  "query": "wireless headphones",
  "timestamp": "2025-01-24T10:30:00Z"
}

No Results Response

{
  "type": "no_results",
  "message": "No trending data found for query: 'obscure-term'",
  "query": "obscure-term",
  "products_only": true,
  "filters_applied": {
    "min_volume": 10000,
    "categories": ["Electronics"]
  },
  "suggestions": [
    "Try using a longer, more specific search query",
    "Try reducing the minimum volume threshold",
    "Try a broader search term or remove some filters"
  ],
  "timestamp": "2025-01-24T10:30:00Z"
}

💡 Usage Examples

Example 1: Search for Trending Products Only

{
  "q": "gaming mouse",
  "products_only": true
}

Example 2: Search for Both Keywords and Products

{
  "q": "sustainable fashion",
  "products_only": false
}

Example 3: Search with Default Settings

{
  "q": "home decor"
}

This will use the default products_only: false and return both keywords and products.

Example 4: Minimal Search

{
  "q": "electric vehicles"
}

⚠️ API Limitations

Rate Limits

• Requests per minute: ~60 requests (varies by API plan)
• Concurrent requests: Limited to prevent overload
• Retry behavior: Automatic exponential backoff on rate limit hits

Data Limitations

• Search results: Typically 10-100 results per query
• Historical data: Limited to recent trend data (varies by keyword)
• Category coverage: Not all product categories may be available
• Geographic scope: Primarily US market data

Technical Constraints

• Timeout limits: 5-300 seconds per request
• Query length: 1-200 characters
• Result limits: Maximum 1000 results per run
• Memory usage: Large result sets may impact performance

🔍 Troubleshooting

Common Issues

No Results Found

Symptoms: Actor returns "no_results" response Solutions:

• Try broader search terms
• Check spelling of search query
• Try related or synonymous terms

API Timeout Errors

Symptoms: "API_TIMEOUT" error in results Solutions:

• Increase timeout parameter (up to 300 seconds)
• Increase retry attempts
• Try during off-peak hours
• Use more specific search queries

Validation Errors

Symptoms: "VALIDATION_ERROR" in results Solutions:

• Check parameter types match schema
• Ensure required fields are provided
• Verify numeric ranges are within limits
• Review input schema documentation

Rate Limit Issues

Symptoms: Frequent API errors or slow responses Solutions:

• Reduce concurrent runs
• Increase retry attempts
• Space out actor runs
• Contact support for rate limit increases

Debug Mode

The actor provides detailed logging by default, including:

• API request/response information
• Processing step timing
• Memory usage statistics
• Error context and stack traces

Performance Optimization

For Large Result Sets

• The API automatically handles result pagination
• Monitor memory usage in logs for very large result sets

For Reliability

• The actor includes automatic retry logic with exponential backoff
• Built-in timeout handling for API requests
• Comprehensive error handling and recovery

📞 Support

Getting Help

1. Documentation: Check this README and input schema
2. Logs: Enable debug logging for detailed information
3. Community: Join the Apify Discord
4. Support: Contact Apify Support

Reporting Issues

When reporting issues, please include:

• Input parameters used
• Error messages from logs
• Expected vs actual behavior
• Actor run ID (if available)

---

Happy trending! 📈