Quick Start

Get your first job listings in minutes with these simple examples

Get Your First Results

Let’s get you up and running with swelist. This guide will walk you through the most common use cases.

1. Run swelist with Default Options

   The simplest way to use swelist is to run it without any flags. This shows internship positions from the last 24 hours:

   swelist
   

   Sample Output:

   Welcome to swelist.com
   Last updated: Sun Feb 23 13:03:45 2025
   Found 1227 tech internships from 2025Summer-Internships
   Found 103 new-grad tech jobs from New-Grad-Positions
   Sign-up below to receive updates when new internships/jobs are added
   
   Found 15 postings for location 'all' in lastday
   
   Company: Example Tech
   Title: Software Engineering Intern
   Location: New York, NY
   Link: https://example.com/apply
   
   Company: Innovation Labs
   Title: Data Science Intern
   Location: San Francisco, CA
   Link: https://innovation-labs.com/careers
   ...
   

   By default, swelist shows internship positions from the last 24 hours. This is equivalent to running swelist --role internship --timeframe lastday.

2. Find New-Grad Positions

   Looking for full-time new-grad roles instead? Use the --role flag:

   swelist --role newgrad
   

   This displays new-graduate positions posted in the last 24 hours.

   Sample Output:

   Welcome to swelist.com
   Last updated: Sun Feb 23 13:05:22 2025
   Found 1227 tech internships from 2025Summer-Internships
   Found 103 new-grad tech jobs from New-Grad-Positions
   Sign-up below to receive updates when new internships/jobs are added
   
   Found 8 postings for location 'all' in lastday
   
   Company: Tech Innovations Inc
   Title: Software Engineer - New Grad
   Location: Seattle, WA
   Link: https://techinnovations.com/apply/newgrad
   ...
   
3. Expand Your Time Window

   Want to see more opportunities? Expand the time window to see postings from the last week or month:

   Last Week

   swelist --role internship --timeframe lastweek
   

   The --timeframe flag accepts three values:

   • lastday (24 hours) - default
   • lastweek (7 days)
   • lastmonth (30 days)
4. Filter by Location

   Focus on specific locations using the --location flag. You can search by city, state code, or country:

   Single City

   swelist --role internship --location Toronto
   

   When specifying multiple locations, separate them with commas and wrap the entire string in quotes. State codes (2 letters) are matched against the end of location strings.

   Sample Output with Location Filter:

   Welcome to swelist.com
   Last updated: Sun Feb 23 13:10:15 2025
   Found 1227 tech internships from 2025Summer-Internships
   Found 103 new-grad tech jobs from New-Grad-Positions
   Sign-up below to receive updates when new internships/jobs are added
   
   Found 5 postings for location 'Toronto' in lastday
   
   Company: FinTech Solutions
   Title: Backend Engineering Intern
   Location: Toronto, ON
   Link: https://fintech-solutions.ca/jobs
   ...
   

Common Use Cases

Daily Internship Check

Check for new internship postings every morning:

swelist --role internship --timeframe lastday

Weekly New-Grad Review

Review all new-grad positions posted this week:

swelist --role newgrad --timeframe lastweek

Location-Specific Search

Find all internships in California from the last month:

swelist --role internship --timeframe lastmonth --location CA

Multi-City New-Grad Hunt

Search for new-grad roles in multiple tech hubs:

swelist --role newgrad --location "San Francisco, Seattle, New York, Boston"

Understanding the Output

Each job posting in the output contains four key pieces of information:

• Company: The hiring company’s name
• Title: The job title or role description
• Location: Geographic location(s) of the position
• Link: Direct URL to the application page

Some postings may display both location (single string) and locations (array of locations) fields depending on the source data format.

No Results?

If swelist returns no results, it could mean:

1. No new postings in the timeframe: Try expanding with --timeframe lastweek or --timeframe lastmonth
2. Location too specific: The location string must match part of the job’s location field
3. No matches for your criteria: Try removing the location filter or changing the role

Example Messages:

No postings found in lastday

or

No postings found for location 'Denver' in lastday

Next Steps

Command Reference

Learn about all available commands and options in detail

Filtering Guide

Master location and timeframe filtering

swelist is designed for repeated execution and automation. Consider setting up a daily cron job to automatically check for new positions matching your criteria!