Viral Spy Ai (Discover only viral videos)

ViralSpy.AI — Find Your Next Viral Idea

ViralSpy is a trend discovery and analysis tool for YouTube that helps you identify real audience opportunities and turn ideas into performant content.

Tutorial:
Search the Like Points dashboard for (Register api key Gemini) 
Follow the tutorial button tutorial, register the api key code in the system and access viral spy here on this page then just do your searches in any language

How to get the Gemini API key

- Requirements:
  - An active Google account.
  - Access to Gemini via Google AI Studio. The free version has limits; for intensive use it may be necessary to enable charging.
Step by step (Google AI Studio)

- Access https://aistudio.google.com/app/apikey and sign in with your Google account.
- Click on Create API key and confirm the creation.
- Copy the generated key (format similar to AIza... ).
- Keep the key only in the backend; do not use in browser scripts.
Quick key test

- With curl:
  - curl -s -X POST "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=SEU_API_KEY" -H "Content-Type: application/json" -d "{\"contents\":[{\"parts\":[{\"text\":\"Reply in JSON with {\\\"msg\\\":\\\"Hello\\\"}\"}]}]}"
- Valid response contains candidates[0].content.parts[0].text with text (usually JSON or plain text).
Where to put the key on your system

- Administrative panel:
  - Go to Admin > System > Settings > APIs per system account (quotas).
  - In the Gemini provider, paste the key and save.
  - This allows modules like viral_spy/api.php to use the admin key under “system account” mode and consume quotas correctly.
- Alternatives for development (avoid in production):
  - api_diversas linked to the administrator user ( user_level=3 ) with api_service='Gemini' .
  - Constant Gemini_API_KEY or API_KEYS['Gemini'] in _app/Config.inc.php (not recommended to commit secrets).
Verification within ViralSpy

- AI analysis calls Gemini first:
  - Code uses the list of keys resolved by APIQuota and switches to OpenRouter / OpenAI if necessary.
  - After saving the key, open http://localhost/gc/viral_spy/ , click on “???? AI Analysis” and confirm that the report fields appear filled in.
Good security practices

- Never expose the key in the frontend (index.php /JS).
- Rotate the key periodically and revoke old keys in Manage keys.
- Set usage limits on your system dashboard (quotas) to prevent abuse.
- Log 401/403/429 failures and apply backoff to modules that use AI.
Common errors and solutions

- 401 Unauthorized:
  - Check that the key is correct and has no spaces.
  - Confirm that you are using the route v1beta/models/Gemini-2.5-flash:generateContent .
- 429 Too Many Requests:
  - Reduce frequency, implement retry with wait, use key rotation if applicable.
- Empty response:
  - Check if the text comes in choices/candidates and remove markdown fences (```json) before parsing.
  - On your system, keep fallbacks active (OpenRouter/OpenAI and heuristics).

Key Features
- Search for videos and Shorts with niche filters, period and volume of views
- Guarantee of real links (direct collection from YouTube with fallback via Invidious) and validation of thumbnails
- AI-powered analysis on modal: viral score, suggested hook, strengths and weaknesses, video-specific title ideas, tags/niche, recommended times, suggested CTA and thumbnail prompt
- Recommendations tailored to the niche (prayer, finance, gaming, football, technology/AI, recipes, education, music), including ideal times and audience language
- Automatic Shorts detection for recommendations of fast high consumption times

Architecture and security
- Robust backend with rotation of AI providers (Gemini, OpenRouter Grok 4.1 Fast, OpenAI 4o‑mini) and “on-system” quota system; consumes quota only when necessary
- Requires login and respects user permissions/plan; integrates into the administrative panel
- Responses always in JSON, without unexpected HTML, ensuring stable operation on the frontend

Objective
Make content search and analysis more accurate, with actionable recommendations specific to the selected video, accelerating the creation of titles, thumbnails, CTAs and publishing plans that maximize retention and reach.