Skip to content

colly

18,958 5 160 Apache-2.0
v2.1.0 (8 Jun 2020) May 14 2018

Colly is a popular web scraping library for the Go programming language. It's designed to be fast and easy to use, and it provides a simple and flexible API for traversing and extracting information from websites.

Colly supports:

  • Concurrent scraping with a simple API
  • Automatic handling of cookies and sessions
  • Automatic handling of redirects
  • Support for parsing HTML and XML
  • Support for parsing JSON and binary data
  • Support for custom storage (e.g. scraping results to a database)
  • Simple JavaScript rendering with Colly's built-in rendering engine.

Colly also provides several optional features, such as support for user-agents, delay between requests, rate-limiting and proxy usage.

Colly's API is quite simple, and it is easy to get started with basic web scraping tasks. It's a good choice for scraping moderate to heavy sites, and it can be useful for a wide range of use cases, such as data mining, content extraction, and more.

Additionally, you can use it together with Goquery, a library that allow you to make jquery like queries on HTML documents and it is often used together with Colly to ease the way of parsing the HTML.

Highlights


popularcss-selectorsxpath-selectorscommunity-toolsoutput-pipelinesmiddlewaresasyncproductionlarge-scale

Example Use


package main

import (
  "fmt"

  "github.com/gocolly/colly/v2"
)

func main() {
  // Instantiate default collector
  c := colly.NewCollector(
    // Visit only domains: hackerspaces.org, wiki.hackerspaces.org
    colly.AllowedDomains("hackerspaces.org", "wiki.hackerspaces.org"),
  )

  // On every a element which has href attribute call callback
  c.OnHTML("a[href]", func(e *colly.HTMLElement) {
    link := e.Attr("href")
    // Print link
    fmt.Printf("Link found: %q -> %s\n", e.Text, link)
    // Visit link found on page
    // Only those links are visited which are in AllowedDomains
    c.Visit(e.Request.AbsoluteURL(link))
  })

  // Before making a request print "Visiting ..."
  c.OnRequest(func(r *colly.Request) {
    fmt.Println("Visiting", r.URL.String())
  })

  // Start scraping on https://hackerspaces.org
  c.Visit("https://hackerspaces.org/")
}

Alternatives / Similar


7,284 v1.3.4 (3 years ago) Feb 15 2020 compare
1,857 2023-02-23 (22 hours ago) Jun 06 2019 compare
571 2023-02-22 (2 days ago) Feb 09 2017 compare
5,227 v0.17.0 (16 days ago) Jul 27 2019 compare
2,008 (1 year, 9 months ago) Nov 20 2016 compare

Other Languages

46,263 2.8.0 (22 days ago) Jul 26 2019 compare
1,387 1.0.3 (1 year, 4 months ago) Nov 22 2014 compare
6,334 1.4.0 (a month ago) Sep 10 2012 compare
2,598 1.4.1 (14 days ago) Sep 04 2013 compare
2,691 v2.0.1 (1 year, 2 months ago) Jul 17 2018 compare
4,911 1.1.14 (7 months ago) Jul 26 2019 compare
156 1.11.1 (9 hours ago) Feb 05 compare
2,671 1.4.0 (3 years ago) Sep 30 2018 compare
1,281 3.0.0 (6 months ago) Dec 27 2011 compare
744 0.7.0 (a month ago) Jul 25 2009 compare
145 2.2.4 (2 years ago) Dec 22 2019 compare
1,642 0.8.5 (5 months ago) Oct 17 2018 compare
9,417 1.1.9 (4 years ago) Aug 24 2018 compare
2,914 0.9.12 (a month ago) Jul 04 2017 compare
160 1.0.0-beta8.3 (4 months ago) Apr 18 2019 compare
1,121 2.0.1 (6 days ago) Dec 27 2021 compare
355 1.0.2 (2 months ago) May 04 2020 compare
1,286 v0.6.3 (10 months ago) Mar 16 2013 compare
341 0.1.2 (2 years ago) Feb 20 2022 compare
128 v1.0.0 (15 days ago) Apr 18 2022 compare