THE SOCIAL URL TOOLKIT

Every profile link,
handled.

Detect, validate, and normalize social profile URLs with one tiny, TypeScript-first library.

15 built-in platforms  ·  React ready
PACKAGEnpm i sociurl
AGENT SKILLnpx skills add https://github.com/ahmadshah49/sociurl --skill sociurl
Platform detected
n
natgeoInstagram profile
↗instagram.com/natgeo
CANONICAL PROFILEhttps://instagram.com/natgeo
Valid profile URL in milliseconds
Clean canonical URL
A clean path from any URL to a usable profile.
BUILT FOR THE SOCIAL WEB
InstagramFacebookLinkedInGitHubX (Twitter)YouTubeTikTokPinterest
+ 7 more
SMALL API, BIG RELIEF

Links come in messy.
Your data doesn’t have to.

Sociurl handles the tricky edge cases, so your product can focus on people and their profiles.

01

Detect the platform

Recognize supported social networks from a URL, even when users leave off the protocol.

detectPlatform(url)
02

Validate profiles

Check profile paths and usernames structurally without making a network request.

validateSocialUrl(url)
03

Normalize the URL

Turn accepted variations into one clean, secure canonical profile link.

normalizeSocialUrl(url)
04

Render with React

Drop in accessible inputs, platform icons, and safe social link lists.

import from "sociurl/react"
LIVE PLAYGROUND

Give it a URL.

See what Sociurl finds. Try an example or paste your own.

15platforms
and counting
01

URL validator

validateSocialUrl()
Valid
TRY:
Profile URL recognizedSociurl found a supported profile format.
PLATFORMinstagram
USERNAMEnatgeo
NORMALIZED URLhttps://www.instagram.com/natgeo

Results use detectPlatform, extractUsername and normalizeSocialUrl.

02

Just a few lines

TYPESCRIPT

Use the helpers anywhere in your app.

import { validateSocialUrl } from "sociurl";

const result = validateSocialUrl(url);

// {
{result.valid ? "valid" : "invalid"}
// }
No network calls. No surprises.
MADE FOR REACT

Useful UI, ready to go.

Accessible components with flexible styling and optional brand-color icons.

SocialInput

Platform-aware input with built-in validation

LIVE COMPONENTbuilt-in validation
BROAD COVERAGE

All your favorite
corners of the web.

Built-in profiles for creators, communities, and professional networks.

Instagram
Facebook
LinkedIn
GitHub
X (Twitter)
YouTube
TikTok
Pinterest
Reddit
Twitch
Medium
Dribbble
Behance
Telegram
Threads
✳
READY WHEN YOU ARE

Make profile links
the easy part.

Try Sociurl ↑