API Documentation

Build with our API

Access your profile, links, and appearance settings programmatically

Authentication

All API endpoints require authentication using a Bearer token. You can generate API tokens in your dashboard settings.

Authorization: Bearer your_api_token_here

/{username}/profile

getGet user profile

Parameters

Name	Type	Description
username	string	Username of the profile to retrieve

Examples

cURL

curl -X GET "https://emogir.ls/v1/johndoe/profile" -H "Authorization: Bearer YOUR_API_TOKEN"

JavaScript

fetch('https://emogir.ls/v1/johndoe/profile', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN'
  }
})

Python

import requests

response = requests.get(
    'https://emogir.ls/v1/johndoe/profile',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'}
)

Response

{
  "username": "johndoe",
  "name": "John Doe",
  "bio": "Software developer",
  "image": "https://example.com/avatar.jpg",
  "isPremium": true,
  "badges": [
    "PREMIUM",
    "VERIFIED"
  ]
}

/{username}/links

getGet user links

Parameters

Name	Type	Description
username	string	Username of the profile to retrieve links for
limit	integer	Number of links to return (max: 100)
offset	integer	Number of links to skip

Examples

cURL

curl -X GET "https://emogir.ls/v1/johndoe/links?limit=50&offset=0" -H "Authorization: Bearer YOUR_API_TOKEN"

JavaScript

fetch('https://emogir.ls/v1/johndoe/links?limit=50&offset=0', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN'
  }
})

Python

import requests

response = requests.get(
    'https://emogir.ls/v1/johndoe/links',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
    params={'limit': 50, 'offset': 0}
)

Response

[
  {
    "id": "link_123",
    "title": "My Website",
    "url": "https://example.com",
    "iconUrl": "https://example.com/icon.png",
    "enabled": true,
    "position": 0,
    "clicks": 42
  }
]

/{username}/links/{linkId}

getGet specific link

Parameters

Name	Type	Description
username	string	Username of the profile to retrieve link from
linkId	string	ID of the link to retrieve

Examples

cURL

curl -X GET "https://emogir.ls/v1/johndoe/links/link_123" -H "Authorization: Bearer YOUR_API_TOKEN"

JavaScript

fetch('https://emogir.ls/v1/johndoe/links/link_123', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN'
  }
})

Python

import requests

response = requests.get(
    'https://emogir.ls/v1/johndoe/links/link_123',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'}
)

Response

{
  "id": "link_123",
  "title": "My Website",
  "url": "https://example.com",
  "iconUrl": "https://example.com/icon.png",
  "enabled": true,
  "position": 0,
  "clicks": 42
}

/{username}/appearance

getGet appearance settings

Parameters

Name	Type	Description
username	string	Username of the profile to retrieve appearance for

Examples

cURL

curl -X GET "https://emogir.ls/v1/johndoe/appearance" -H "Authorization: Bearer YOUR_API_TOKEN"

JavaScript

fetch('https://emogir.ls/v1/johndoe/appearance', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN'
  }
})

Python

import requests

response = requests.get(
    'https://emogir.ls/v1/johndoe/appearance',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'}
)

Response

{
  "displayName": "John's Links",
  "bio": "Check out my links!",
  "avatar": "https://example.com/avatar.jpg",
  "banner": "https://example.com/banner.jpg",
  "backgroundUrl": "https://example.com/bg.jpg",
  "layoutStyle": "default",
  "containerBackgroundColor": "#000000",
  "glassEffect": true,
  "audioTracks": [
    {
      "id": "track_1",
      "url": "https://example.com/song.mp3",
      "title": "My Song",
      "icon": "🎵",
      "order": 0
    }
  ]
}