Getting started

Quick start

Get up and running with Scrappy in under five minutes. This guide walks you through creating your first project, adding a source, and running your first scraping job.

Prerequisites

Before you start, you'll need a Scrappy account. If you don't have one yet, sign up for free to get 100 credits to start.

Step 1: Create a project

Projects help you organize your leads by campaign or purpose. Think of them as folders for your data.

  1. Navigate to your Dashboard
  2. Click the "New Project" button in the top right
  3. Give your project a name (e.g., "NYC Real Estate Agents")
  4. Optionally add a description and select a color
  5. Click "Create Project"

Step 2: Add a source

Sources are the websites you want to scrape for leads. You can add sources manually or use AI to discover relevant websites.

Option A: Use AI discovery

  1. In your project, click "Discover Sources"
  2. Describe what you're looking for (e.g., "real estate agents in New York City")
  3. Scrappy will suggest relevant directories and websites
  4. Review the suggestions and click "Add" on the ones you want

Option B: Add manually

  1. Click "Add Source" in your project
  2. Enter the URL of the website you want to scrape
  3. Configure the selectors for the data you want to extract (name, email, phone, etc.)
  4. Choose the scrape type (Static for simple sites, Dynamic for JavaScript-heavy sites)
  5. Click "Save Source"

Step 3: Run your first scrape

Once you have a source configured, you can run a scraping job to extract leads.

  1. Select the source you want to scrape
  2. Click "Run Scrape"
  3. Watch the progress in real time as Scrappy extracts contact information
  4. When complete, your leads will appear in the project's leads list

Step 4: Review and export leads

After your scrape completes, you can review, filter, and export your leads.

  • Filter: Use the filters to narrow down leads by status, company, or tags
  • Validate:Click "Validate Emails" to verify email addresses
  • Export: Download your leads as CSV or JSON

Next steps

Now that you've completed your first scrape, here are some things to explore: