API documentation

Identity Resolver REST API

Resolve public Facebook, Instagram, and LinkedIn profiles into a consistent identity object. Successful responses always include name and picture.

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.

Live tester

Test a public profile

JSON response

Required output fields

{
  "ok": true,
  "service": "identity-resolver",
  "version": "v1",
  "platform": "facebook",
  "id": "4",
  "name": "Mark Zuckerberg",
  "username": "zuck",
  "avatar": "https://...",
  "picture": "https://...",
  "cover": null,
  "verified": false,
  "profile_url": "https://www.facebook.com/zuck"
}

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

Errors

Partial profiles are rejected

400 unsupported_platformThe platform is not facebook, instagram, or linkedin.

400 missing_identifierNo username, id, identifier, profile, or URL was provided.

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

Important behavior

Public metadata only

Identity Resolver does not bypass private profiles or platform login walls. It reads public metadata and returns a stable profile only when the name and picture are available. This keeps the response safe for user-facing identity cards.