A profile API answers a narrow question: given a handle, what does the public profile behind it look like? Metrika answers it with numbers. Send an identifier for a profile on any of eighteen platforms and get back its public counts and verified status as JSON, plus an honest answer when the profile does not exist.
Identifiers are just handles
You address a profile the way the platform itself does, with the
name from the profile URL. No numeric IDs to resolve first, no
URL encoding. For Instagram, X, and Facebook that is the
username; TikTok, Threads, and YouTube use the handle without
the @; Bluesky uses the full handle including its domain, such
as bsky.app; GitHub takes a username or an organization name;
Twitch and Kick take the channel name; Pinterest, Snapchat, and
SoundCloud take the name from the profile URL; Reddit takes the
username without the u/; Telegram takes the name from the
t.me link; Spotify takes the artist id from the artist URL.
$ curl -X POST https://metrika.run/api/v1/resources/search \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"resources": [{"platform": "x", "type": "account", "identifier": "nasa"}]}'People and companies
Most platforms give every profile one kind of address, so
account is the type they accept. LinkedIn keeps people and
companies in separate places, and the same name can belong to
both, so it takes a second type: organization for pages under
/company/, which also unlocks the employee
count datapoint. Pairing a platform
with a type it does not accept fails validation with a clear
error.
Bluesky, Threads, X, YouTube, Reddit, SoundCloud, and GitHub
accept a third type, post, which tracks an individual post,
track, or repository instead of the whole profile. Telegram,
Reddit, and Discord accept community for groups, subreddits,
and servers.
When a profile does not exist
Ask for a handle with a typo in it and the response says so:
the resource comes back with a not_found status once we
have confirmed the profile is missing on that platform. That
makes profile lookups usable as a validation step, checking
handles that users type into your product, or cleaning a CRM
column of creator names, without treating an HTTP error as
an answer.
What a lookup returns, and what it does not
Profiles come back as datapoints: follower and following counts, post counts, and verified status, with coverage varying by platform. Metrika does not return bios, display names, avatars, or anything the profile has posted. If you need profile content rather than profile numbers, a platform's official API is the right place.
Getting started
Create an account, generate an API key from your dashboard, and you can look up profiles on the free tier with 500 requests per month, no credit card required. The docs list identifier formats and datapoint coverage for every platform.
Get started with Metrika
Create a free account and start pulling social media datapoints in minutes. The free tier includes 500 requests per month, no credit card required.