Skip to content

Latest commit

 

History

History
238 lines (180 loc) · 5.61 KB

PERFORMANCE_BASELINE.md

File metadata and controls

238 lines (180 loc) · 5.61 KB

Python SDK Performance Baseline

Date: 2025-11-25 Purpose: Track SDK growth before Reddit marketing campaign

📊 Current Metrics (Baseline)

PyPI Downloads

Source: https://pypistats.org/packages/oilpriceapi

Last 24 hours:     2 downloads
Last 7 days:       4 downloads
Last 30 days:      20 downloads (direct)
Last 30 days:      213 downloads (with mirrors)
All time:          1,019 downloads (with mirrors)

Peak day:          October 2, 2025 - 164 downloads
Recent average:    7 downloads/day (last 7 days)

GitHub Engagement

Repository: https://github.com/OilpriceAPI/python-sdk

Stars:             0
Forks:             0
Watchers:          0
Open Issues:       1
Contributors:      1
Created:           2025-09-29
Last Push:         2025-11-25

PyPI Package Info

Package:           oilpriceapi
Version:           1.0.1
Published:         2025-09-29
Python Support:    3.8, 3.9, 3.10, 3.11, 3.12
License:           MIT
Classifiers:       Production/Stable

Community Presence

Blog Posts:        0
Video Tutorials:   0
Example Projects:  0
Reddit Mentions:   0 (about to change!)
Podcast Features:  0
Awesome Lists:     0

📈 Historical Download Trend

September 2025 (Launch Month)

  • Sep 29: 128 downloads (launch day spike)
  • Sep 30: 58 downloads
  • Total: ~200 downloads

October 2025

  • Oct 2: 164 downloads (peak day - marketing push?)
  • Oct 3: 61 downloads
  • Oct 4-31: Average ~10-15/day
  • Total: ~400 downloads

November 2025 (Current)

  • Nov 1-25: Average ~7/day
  • Total (so far): ~175 downloads
  • Trending: Slight decline from October

Overall Trend: Declining from launch spike, stabilizing at 5-10/day organic

🎯 Growth Targets

30-Day Target (After Reddit)

  • Daily downloads: 15/day (2x current)
  • Monthly total: 450 downloads (2x current 30-day)
  • GitHub stars: 5+
  • Reddit upvotes: 50+

90-Day Target (After Full Campaign)

  • Daily downloads: 50/day (7x current)
  • Monthly total: 1,500 downloads (7x current)
  • GitHub stars: 20+
  • Blog post views: 1,000+
  • Video views: 500+

180-Day Target

  • Daily downloads: 100/day (14x current)
  • Monthly total: 3,000 downloads
  • GitHub stars: 50+
  • Contributors: 3+
  • Awesome list features: 3+

📅 Tracking Schedule

Daily:

Weekly:

  • Update this file with new metrics
  • Calculate growth rates
  • Adjust marketing strategy based on performance

Monthly:

  • Generate comprehensive report
  • Compare to targets
  • Plan next month's marketing activities

🔍 Metrics to Track After Reddit Post

Immediate (First 24 Hours):

  • Reddit upvotes
  • Reddit comments
  • GitHub stars increase
  • PyPI downloads spike
  • GitHub traffic spike

Short-term (First Week):

  • Sustained download increase
  • GitHub issues/questions
  • Follow-up Reddit discussions
  • Referral traffic to docs

Long-term (First Month):

  • Download trend stabilization
  • Community contributions
  • Word-of-mouth spread
  • Organic search traffic

📊 Download Attribution

To track Reddit impact, we'll compare:

Pre-Reddit Baseline:

  • 7 downloads/day average
  • ~210 downloads/month pace

Post-Reddit Day 1:

  • Expected: 20-50 downloads (3-7x spike)

Post-Reddit Week 1:

  • Expected: 15-25 downloads/day average (2-3x sustained)

Post-Reddit Month 1:

  • Expected: 450+ downloads total (2x baseline)

🎨 Reddit Post Performance Targets

Success Criteria

  • ✅ Good: 50+ upvotes, 10+ comments, 20+ downloads/day spike
  • 🎯 Great: 100+ upvotes, 25+ comments, 50+ downloads/day spike
  • 🔥 Amazing: 500+ upvotes, 50+ comments, 100+ downloads/day spike, trending

Engagement Targets

  • Upvote ratio: >80% positive
  • Comment quality: Technical questions, not just "cool"
  • GitHub stars: 5+ from Reddit
  • PyPI clicks: 100+ (estimate from referrals)

📝 What We'll Learn

If Reddit Post Succeeds:

  • Social proof works (developers trust community recommendations)
  • Python community interested in financial/commodity data
  • Tutorial content drives installs
  • Need to double down on content marketing

If Reddit Post Underperforms:

  • Need better hook/title
  • Wrong subreddit targeting
  • Timing matters (post on weekdays, morning US time)
  • May need paid promotion or different channels

Either Way:

  • Baseline metrics = control group
  • Reddit metrics = treatment group
  • Clear A/B test for future marketing

🔗 Monitoring Links

PyPI Stats:

GitHub Stats:

Package Pages:

📈 Next Update

Date: 2025-11-26 (24 hours after Reddit post) What to check:

  • PyPI downloads spike
  • GitHub stars increase
  • Reddit post karma
  • GitHub traffic analytics

Date: 2025-12-02 (7 days after Reddit post) What to check:

  • Sustained download increase
  • New issues/PRs on GitHub
  • Community discussions
  • Follow-up marketing opportunities

Baseline Captured: 2025-11-25 Next Milestone: Reddit post publication Expected Impact: 2-3x download increase in first week