marketing

referer-parser: Unlock Attribution Data

Name: referer-parser: Unlock Attribution Data
Author: snowplow-referer-parser

Extract valuable marketing insights with referer-parser, a library for startup founders to optimize their marketing strategies.

384 stars150 forksQuality 8/10Updated 6/5/2026100% free · open source

What it does

Referer-parser extracts valuable marketing insights from referrer URLs to help startup founders optimize their marketing strategies.

Install / run

pip install snowplow-referer-parser

When to use it

•When analyzing website traffic to understand how users arrive at your site
•When trying to attribute conversions to specific marketing campaigns or channels
•When seeking to refine marketing strategies based on referral data

Quick start

1Import the library in your Python script with 'from snowplow_referer_parser import parse_referer'
2Use the 'parse_referer' function to parse a referrer URL, such as 'parse_referer("https://www.example.com/referrer")'
3Configure the parser with a custom 'medium' or 'source' using the 'parse_referer' function's keyword arguments, e.g. 'parse_referer("https://www.example.com/referrer", medium="social")'
4Test the parser with a sample referrer URL and print the parsed result, e.g. 'print(parse_referer("https://www.example.com/referrer"))'
5Integrate the parser into your existing analytics pipeline to automatically process referrer URLs

Ready-to-paste prompt

print(parse_referer("https://www.google.com?url=https://www.example.com"))

Heads up: The referer-parser library requires Python 3.6 or higher to run, so ensure you have a compatible Python version installed before attempting to use the library

Saves to your device

What's inside — free to inspect

No purchase needed

Read the entire source before you build — unlike paid marketplaces that hide it behind a buy button.

top-level files

folders

1.7M

repo size

—

license

Key files

README.md