Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/chenyuan99/swelist/llms.txt

Use this file to discover all available pages before exploring further.

​
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:
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:
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
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!

Build docs developers (and LLMs) love

Get started for freeTalk to us