Simple API with a single endpoint to scrape a website and other pages in the same domain. The response separates the text from the header, footer and body of each page.


Clone this repo and run:

go get
go run .

This will start the API at port 8080.

Running with docker

Get and run the image from Dockerhub:

docker run -p 8080:8080 mtrentz/website_text_scraper:latest


There is a single endpoint at /api/scrape/ that takes in a POST with url, depth, and max_requests. If not provided the default parameters is a depth of 2.

Max requests is supposed to be used to limit the amount of scrapes, but it doesn’t guarantee that no more than the provided calls will be made.


curl -X POST http://localhost:8080/api/scrape -d '{"url":"", "max_requests":5}' -H "Content-Type: application/json"

Result summary:

    "url": "",
    "page_amount": 6,
    "visited_at": "2022-07-27 19:23:55",
    "pages": [
            "url": "",
            "header": "Home\nNews\nSport\nWeather\niPlayer\nSounds\nBitesize\nCBeebies\nCBBC\nFood\nHome\nNews\nSport\nReel\nWorklife ...",
            "text": "BBC Homepage\nGas prices soar as Russia cuts German supply\nThe Nord Stream 1 pipeline is now operating at just ...",
            "footer": "\n\n\n\nHome\nNews\nSport\nWeather\niPlayer\nSounds\nBitesize\nCBeebies\nCBBC\nFood\nHome\nNews\nSport\nReel\n ...",
            "visited_at": "2022-07-27 19:23:56"

With depth, which can lead to a very large amount of requests made to the website:

curl -X POST http://localhost:8080/api/scrape -d '{"url":"", "depth":2}' -H "Content-Type: application/json"


View Github