Back to APIs

Social Media Profile API

Updated

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 nine 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.

bash 
$ 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 only 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, and YouTube accept a third type, post, which tracks an individual post instead of the whole profile.

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.

Create a free account Read the docs See pricing