pinterest-url-normalizer

Parse, classify, and normalize Pinterest URLs in Ruby without making network requests.

RubyGems · RubyDoc.info · npm · PyPI · crates.io · Packagist · Go

The gem recognizes Pin, pin.it, profile, board, and Ideas URLs across Pinterest country domains. It uses an exact host allow list, rejects HTTP URLs and lookalike domains, and removes query parameters and fragments from normalized output.

The gem deliberately ends at URL normalization. A Ruby CLI can print or open the normalized Pin URL in the Pinterest image downloader while media retrieval stays outside the gem.

gem install pinterest-url-normalizer

require "pinterest_url_normalizer"

parsed = PinterestURLNormalizer.parse(
  "https://de.pinterest.com/pin/987654321/?utm_source=share"
)

parsed.pin_id
# => "987654321"

parsed.normalized_url
# => "https://www.pinterest.com/pin/987654321/"

pinterest-url-normalizer \
  "https://de.pinterest.com/pin/987654321/?utm_source=share" \
  "https://pin.it/AbC123"

Read one URL per line and emit JSON Lines:

printf '%s\n' 'https://www.pinterest.com/pin/123/' | \
  pinterest-url-normalizer --json

The process exits with status 1 when any input is invalid and status 2 for usage errors.

pin.it links are classified and normalized but are not followed. Resolving them requires a network request and belongs in the consuming application.

MIT