API documentation

Identity Resolver REST API

Resolve public Facebook, Instagram, and LinkedIn profiles into a consistent identity object. Profile and available cover images are cached and served from stable ai.mihajlo.mk URLs.

Access Free No token or checkout required

Endpoint

Resolve one public identity

GET

https://ai.mihajlo.mk/api/identity-resolver/v1/resolve?platform=facebook&username=zuck

platformRequired. One of facebook, instagram, or linkedin. Aliases fb, ig, and li are accepted.

usernameOptional identity handle. Recommended for Instagram and LinkedIn.

idOptional numeric profile id. Mainly useful for Facebook personal profiles.

identifierOptional generic value. Can be username or numeric Facebook id.

urlOptional public profile URL. Useful when the original input is a copied profile link.

refreshOptional boolean. Pass 1 to bypass the saved profile and refresh its locally archived images.

Live tester

Test a public profile

JSON response

Required output fields

{
  "ok": true,
  "service": "identity-resolver",
  "version": "v1",
  "platform": "facebook",
  "id": "100066876685166",
  "name": "Angelina Kotsios",
  "username": "angelina.kotsios",
  "avatar": "https://ai.mihajlo.mk/storage/identity-resolver/facebook/12/100066876685166/profile-picture.jpg?v=b9c10afac68dbf35",
  "picture": "https://ai.mihajlo.mk/storage/identity-resolver/facebook/12/100066876685166/profile-picture.jpg?v=b9c10afac68dbf35",
  "cover": "https://ai.mihajlo.mk/storage/identity-resolver/facebook/12/100066876685166/cover-photo.jpg?v=4adf4900434ebe43",
  "verified": false,
  "profile_url": "https://www.facebook.com/100066876685166"
}

Examples

Facebook username and id

https://ai.mihajlo.mk/api/identity-resolver/v1/resolve?platform=facebook&username=zuck
https://ai.mihajlo.mk/api/identity-resolver/v1/resolve?platform=facebook&id=4
https://ai.mihajlo.mk/api/identity-resolver/v1/resolve?platform=facebook&url=https%3A%2F%2Fwww.facebook.com%2Fzuck

Other platforms

Instagram and LinkedIn

https://ai.mihajlo.mk/api/identity-resolver/v1/resolve?platform=instagram&username=instagram
https://ai.mihajlo.mk/api/identity-resolver/v1/resolve?platform=linkedin&identifier=company%2Fmicrosoft

X-Cache: MISSThe identity was resolved and its images were archived locally.

X-Cache: HITThe saved profile and local images were reused without contacting the platform.

Important behavior

Public metadata with persistent media cache

Identity Resolver does not bypass private profiles or platform login walls. It accepts only supported public profile hosts, validates image hosts and image contents, then archives profile and available cover images locally. Media responses use immutable browser caching; API responses expose X-Cache: HIT or MISS. Instagram has no profile-cover concept, so its cover is normally null.

400 invalid_identifierThe identifier or URL is not a supported public profile target.

422 profile_not_resolvedThe public source did not expose both required fields: name and picture.