GET /users/lookup

GET /users/lookup

Request data for a list of Users

Query parameters

  • user_id array[integer]

    Requested Users by ID

    Can be comma delimited, pipe delimited, or JSON Array encoded

  • username array[string]

    Requested Users by Username

    Can be comma delimited, pipe delimited, or JSON Array encoded

Responses

GET /users/lookup
curl \
 -X GET https://api.cosmily.com/api/v1/users/lookup \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "data": [
    {
      "id": 42,
      "auth0_id": "string",
      "username": "string",
      "email": "string",
      "user_type": "string",
      "followed_by_count": 42,
      "following_count": 42,
      "supergroups": [
        "string"
      ],
      "last_active": "string",
      "followed_by_me": true,
      "profile": {
        "id": 122,
        "user_id": 122,
        "full_name": "Jane Doe",
        "tagline": "Skincare lover from NYC.",
        "about_me": "Native New Yorker Janehn Doe is a NYC & MIAMI based esthetician, known for her microcurrent facials.  Her clients include some of the industry's top editors and models, and she's been featured in Vogue, Elle, Harper’s Bazaar, and countless other publications. ",
        "instagram_handle": "jane_doe122",
        "twitter_handle": "jane_doe122",
        "tiktok_handle": "jane_doe122",
        "instagram_url": "https://instagram.com/jane_doe122",
        "twitter_url": "https://twitter.com/jane_doe122",
        "tiktok_url": "https://instagram.com/jane_doe122",
        "profile_url": "https://cosmily.com/u/jane_doe",
        "website": "https://janedoe.com/",
        "referrer_id": 42
      },
      "profile_picture": {
        "id": 42,
        "user_id": 42,
        "image": "string",
        "url": "string"
      }
    }
  ]
}
Response examples (200)
{
  "data": [
    {
      "id": 42,
      "auth0_id": "string",
      "username": "string",
      "email": "string",
      "user_type": "string",
      "followed_by_count": 42,
      "following_count": 42,
      "supergroups": [
        "string"
      ],
      "last_active": "string",
      "followed_by_me": true,
      "profile": {
        "id": 122,
        "user_id": 122,
        "full_name": "Jane Doe",
        "tagline": "Skincare lover from NYC.",
        "about_me": "Native New Yorker Janehn Doe is a NYC & MIAMI based esthetician, known for her microcurrent facials.  Her clients include some of the industry's top editors and models, and she's been featured in Vogue, Elle, Harper’s Bazaar, and countless other publications. ",
        "instagram_handle": "jane_doe122",
        "twitter_handle": "jane_doe122",
        "tiktok_handle": "jane_doe122",
        "instagram_url": "https://instagram.com/jane_doe122",
        "twitter_url": "https://twitter.com/jane_doe122",
        "tiktok_url": "https://instagram.com/jane_doe122",
        "profile_url": "https://cosmily.com/u/jane_doe",
        "website": "https://janedoe.com/",
        "referrer_id": 42
      },
      "profile_picture": {
        "id": 42,
        "user_id": 42,
        "image": "string",
        "url": "string"
      }
    }
  ]
}