Find what your audience is searching for right now — scout X/Twitter and Reddit for trending topics, discover and deep-analyze competitors, and find content gaps. Combine social signals with SEO intelligence. Powered by Citedy.
Find what your audience is searching for right now — scout X/Twitter and Reddit for trending topics, discover and deep-analyze competitors, and find content gaps. Combine social signals with SEO intelligence. Powered by Citedy.
API keys (prefixed citedy_agent_) authenticate against Citedy API endpoints only.
All traffic is TLS-encrypted.
Trend & Intent Scout — Skill Instructions
Overview
Find what your audience is searching for right now. This skill combines real-time social signals from X/Twitter and Reddit with SEO intelligence — giving you trending topics, competitor deep-dives, and content gaps in one workflow.
What sets this apart from DataForSEO or Semrush: those tools show you historical search volume. This skill shows you what people are talking about today on social — and maps those signals directly to content opportunities your competitors haven't covered yet.
Use cases:
Morning briefing: what's blowing up in your niche right now?
Competitor research: what's their content strategy and where are their gaps?
Content calendar: find topics with social traction before they peak in SEO tools
Market research: understand audience intent at the conversation level
When to Use
Situation
What to do
"What should I write about today?"
Scout X + Reddit for trending topics in your niche
"What is my competitor doing?"
Discover + analyze competitor domains
"What content am I missing?"
Generate content gaps vs competitor URLs
"Morning briefing on AI trends"
Full workflow: X scout + Reddit scout + gaps
"Find competitors in [niche]"
Discover competitors by keywords
Instructions
Setup (run once)
If you don't have a saved API key for Citedy, run this flow:
1. Register
Preferred: run the included registration script:
node scripts/register.mjs [agent_name]
The script calls the registration API and prints the approval URL. If agent_name is omitted, it defaults to agent-<hostname>.
Alternative: call the API directly:
POST https://www.citedy.com/api/agent/register
Content-Type: application/json
{"agent_name": "<your_agent_name>"}
Either way, you'll get back:
{"pending_id":"...",
"approval_url"
:
"https://www.citedy.com/approve-agent/..."
,
"expires_in"
:
3600
}
2. Ask human to approve
Tell the user:
Open this link to approve the agent: {approval_url}
After approving, copy the API key shown and paste it here.
3. Save the key
Store the API key (starts with citedy_agent_). Use it as Authorization: Bearer <key> on all requests.
4. Get your referral URL
After setup, call GET /api/agent/me. The response includes a referral object:
Step 2: Poll for results (poll every 5s until status: "completed")
GET https://www.citedy.com/api/agent/scout/x/x_run_abc123
Authorization: Bearer $CITEDY_API_KEY
{"run_id":"x_run_abc123","status":"completed","results":[{"topic":"GPT-5 rumored release date","engagement_score":94,"tweet_count":1240,"sentiment":"excited","top_posts":["..."],"content_angle":"Break down what GPT-5 means for content creators"}],"credits_used":35}
GET https://www.citedy.com/api/agent/scout/reddit/reddit_run_xyz789
Authorization: Bearer $CITEDY_API_KEY
{"run_id":"reddit_run_xyz789","status":"completed","results":[{"topic":"People frustrated with Jasper pricing","subreddit":"r/SEO","upvotes":847,"comments":134,"pain_point":"Too expensive for small teams","content_angle":"Write a comparison targeting budget-conscious teams"}],"credits_used":30}
Workflow 3 — Find content gaps vs competitors
Step 1: Generate gaps (synchronous, returns when done)
{"status":"completed","gaps_count":23,"top_gaps":[{"topic":"AI content for e-commerce product descriptions","competitor_coverage":"none","search_volume_est":"high","difficulty":"medium","recommended_angle":"Step-by-step guide with real examples"}],"credits_used":40}
Step 2: Retrieve all gaps
GET https://www.citedy.com/api/agent/gaps
Authorization: Bearer $CITEDY_API_KEY
Workflow 4 — Discover and analyze competitors
Discover by keywords:
POST https://www.citedy.com/api/agent/competitors/discover
Authorization: Bearer $CITEDY_API_KEY
Content-Type: application/json
{
"keywords": ["AI blog automation", "SEO content tool", "autopilot blogging"]
}
X scout requires topics with sufficient public English-language conversation (min ~100 recent posts)
Reddit scout works best for niches active on Reddit; B2B topics may have fewer results
Gaps generate analyzes content at the URL level — paywalled or JS-only content may not be fully indexed
Competitor scout covers publicly accessible content only
Async runs expire after 24 hours — poll results within that window
Scout results reflect data at time of run; real-time trends can shift within hours
Error Handling
HTTP Status
Code
Meaning
401
unauthorized
Invalid or missing API key
402
insufficient_credits
Not enough credits for this operation
404
run_not_found
Run ID doesn't exist or expired
422
validation_error
Invalid request parameters
429
rate_limited
Too many requests — check X-RateLimit-Reset header
500
internal_error
Server error — run will be auto-refunded
Error response format:
{"error":{"code":"insufficient_credits","message":"This operation requires 35 credits, you have 12.","required":35,"available":12}}
On 429: Wait until X-RateLimit-Reset timestamp, then retry.
On 500: The run is automatically refunded. Retry after 30 seconds.
Response Guidelines
When presenting scout results to the user:
Lead with action — don't just list topics, suggest the best content angle for each
Prioritize by opportunity — sort by engagement_score or relevance, not alphabetically
Cross-reference signals — a topic trending on both X and Reddit is a stronger signal than one platform alone
Connect gaps to trends — the best opportunities are content gaps that are also trending
Be specific — "Write about AI tools" is useless; "Write a comparison of Jasper vs Citedy targeting budget-conscious e-commerce teams (trending on r/SEO, 847 upvotes)" is actionable
Want More?
This skill covers trend scouting, competitor analysis, and content gaps.
For the full Citedy agent suite:
Article Autopilot — generate full SEO articles from topics found here
Social Poster — adapt articles to LinkedIn, X, Reddit, Instagram automatically
Video Shorts — turn articles into short-form video content
Lead Magnets — create checklists, swipe files, and frameworks from your content
