How it actually works

A Telegram bot that drives real organic visits to your site

Graphref operates a pool of real devices. When you submit a job, those devices perform an actual Google search for your keyword, locate your domain in the results, and click through. Google registers it as genuine organic traffic — which you can verify in Search Console.

Job pipeline

From your command to a click in Google — every step in the process.

You send /run keyword domain

via Telegram bot

↓

Job enqueued in Redis queue

10 credits deducted

↓

Worker picks up and executes

run.py subprocess on real device

↓

Google search performed

Finds your domain, clicks it

↓

Bot notifies you with result

Appears in Google Search Console

Queue & workers

Jobs are stored in a Redis-backed queue (RQ). Workers continuously pull jobs in order and execute them. Multiple workers can run in parallel, which is why server load affects queue time.

queue jobs
position 3 of 14
timeout 30 min max
on timeout auto-refund

Auto-refund policy

Credits are refunded automatically for any job that doesn't complete successfully — network errors, invalid domain, worker interruption, or timeout. No manual request needed.

+10failed (non-zero exit)
+10stopped (worker restart)
+10canceled by user
+10timeout after 30 min

Job lifecycle

Every job moves through these states. The bot notifies you when a job leaves the active states.

⏳queued

Job is waiting in the Redis queue. Position depends on server load.

🚀started

A worker has picked up the job and is executing the search + click process.

✅finished

Job completed successfully. Visit will appear in Google Search Console.

❌failed

Execution returned a non-zero exit code. 10 credits are automatically refunded.

🛑canceled

User cancelled the job before it started. 10 credits refunded immediately.

⚠️stopped

Worker was interrupted mid-execution (e.g. server restart). Credits refunded.

State transitions

queuedstartedfinishedfailed /stoppedworker picks upexit 0exit ≠ 0 → refund/cancel → refund

All commands

Every command the bot supports, with real examples of what you send and what you get back.

/run <keyword> <domain>10 credits

Enqueues a new search job. Graphref searches for your keyword on Google and clicks your domain in the results.

/run best coffee grinder mycoffeeshop.com
✅ Job Queued! Keyword: best coffee grinder Domain: mycoffeeshop.com Credits remaining: 40 Job ID: a3f9-bc12 Track: /status a3f9-bc12
/status [job_id]Free

Returns the current state of a job. Omit job_id to check your most recent active job.

/status a3f9-bc12
🚀 Job Status Status: Running Keyword: best coffee grinder Domain: mycoffeeshop.com Queue position: 2 Job ID: a3f9-bc12
/jobs [n]Free

Lists your last N jobs (1–10) with their status, keyword, domain, and timestamps.

/jobs 5
Your last 5 jobs: 1. ✅ best coffee grinder → mycoffeeshop.com 2. ✅ coffee grinder reviews → mycoffeeshop.com 3. ❌ espresso machine → mycoffeeshop.com 4. ✅ pour over coffee → mycoffeeshop.com 5. ⏳ drip coffee maker → mycoffeeshop.com
/cancel [job_id]Refunds 10 credits

Cancels a queued job before it starts. Credits are refunded immediately. Cannot cancel a job that has already started.

/cancel a3f9-bc12
🛑 Job Cancelled Job a3f9-bc12 has been cancelled. 10 credits refunded. New balance: 50 credits
/queueFree

Shows current server load: how many jobs are queued globally and how many of yours are active.

/queue
📊 Queue Status Queue: jobs Total queued: 14 Your active jobs: 2
/creditsFree

Shows your current credit balance and how many /run calls you can make with remaining credits.

/credits
💳 Credit Balance Balance: 80 credits Runs remaining: 8 Need more? Use /buy
/buyFree

Displays available credit packages with PayPal checkout links. Credits are added instantly after payment.

/buy
Choose a package: [100 credits — $1.99] [500 credits — $8.99] [1000 credits — $15.99]
/referralFree

Generates your unique referral link. When someone signs up through your link and completes their first run, you earn 30 bonus credits.

/referral
🔗 Your referral link: t.me/graphrefbot?start=ref_a3f9bc Earn 30 credits for each person who runs their first job through your link.

Credit system

Credits never expire. Every transaction is logged and visible via /credits.

EventCreditsNote
New account signup+50One-time welcome bonus
/run command−10Deducted when job is enqueued
Job fails (any reason)+10Automatic refund, no action needed
/cancel before start+10Instant refund if job hasn't started
Referral: their first run+30Credited to referrer after completion
Buy 100-credit pack+100$1.99 via PayPal
Buy 500-credit pack+500$8.99 via PayPal
Buy 1000-credit pack+1000$15.99 via PayPal

Referral bonus

A

You share your link

t.me/graphrefbot?start=ref_xxx

B

Friend signs up + runs first job

triggers bonus

+30

You receive 30 credits

added to your balance

Ready to try it?

New accounts start with 50 free credits — no card required.

Open on Telegram