SceniqDevelopers

get_profile

The creator's public profile.

GET/v1/profile
MCP tool get_profileScope: readStableSince 2026-09-17
Markdown

Display name, real name, bio, avatar, socials, the URL slug (read-only).

curl "https://sceniq.earth/api/v1/profile" \
  -H "Authorization: Bearer $SCENIQ_API_KEY"

Returns

200 OK with Profile: The creator's public profile.

  • creatorIdstring · creator idrequired

    The creator's id.

  • slugstringrequired

    The creator's URL slug (read-only).

  • displayNamestringrequired

    The public brand name.

  • realNamestring or nullrequired

    The legal name on the studio profile.

  • biostring or nullrequired

    The bio.

  • emailstringrequired

    The login email (read-only).

  • avatarUrlstring or nullrequired

    The avatar.

  • socialsarray of SocialLinkrequired

    Social links.

    Show 4 fieldsof SocialLink
    • platformstringrequired

      instagram, tiktok or youtube.

      instagramtiktokyoutube
    • handlestringrequired

      The account name (@name). Required on the profile; the link pill shows it when there is no follower count.

    • urlstringrequired

      The profile page (https; set_profile_socials refuses other links). An empty url on a sales page falls back to the link built from platform and handle.

    • followerCountnumberoptional

      Followers as the creator states them, a whole number from 0, shown on the pill (12K) instead of the handle.

  • rolestringrequired

    The key owner's role on the creator account.

    ownereditor
Response 200
{
  "creatorId": "k97c2m4vx8r1q0d6s5t3n9p2w7y4h8b1",
  "slug": "mara-lindgren",
  "displayName": "Mara Lindgren",
  "realName": null,
  "bio": "Landscape photographer. I plan every trip around the light and share the exact spots, times and parking so you can do the same.",
  "email": "mara@example.com",
  "avatarUrl": "https://quiet-heron-512.convex.cloud/api/storage/mara-lindgren-avatar.webp",
  "socials": [
    {
      "platform": "instagram",
      "handle": "mara.firstlight",
      "url": "https://www.instagram.com/mara.firstlight/",
      "followerCount": 184000
    },
    {
      "platform": "youtube",
      "handle": "marafirstlight",
      "url": "https://www.youtube.com/@marafirstlight",
      "followerCount": 52300
    },
    {
      "platform": "tiktok",
      "handle": "mara.firstlight",
      "url": "https://www.tiktok.com/@mara.firstlight"
    }
  ],
  "role": "owner"
}

Errors

Every error is { error: { code, message } }. Act on the code.

  • 401unauthenticatedThe request carries no key. Send it as Authorization: Bearer sk_sceniq_... (or X-Api-Key).
  • 401invalid_api_keyThe key is unknown, revoked or expired.
  • 403forbiddenThe key belongs to a creator account that is no longer active.
  • 429rate_limitedOver a limit: requests per key per minute, per creator per hour, uploads per key per minute, or check_links per guide per hour.
  • 500internal_errorAn unexpected failure. The message is hidden on purpose.