Get Profile By User Account ID

Get profiles by user account ids

curl --request GET \
  --url https://api.tapti.ai/fusion/profiles \
  --header 'x-api-key: <api-key>'

{
  "profiles": [
    {
      "id": "65170d1b-6720-5e63-ae7a-86c8d6510db9",
      "user_platform": "YOUTUBE",
      "username": "johndoe",
      "url": "https://www.youtube.com/channel/UC1234567890",
      "gender": "MALE",
      "platform_account_id": "UC1234567890",
      "full_name": "John Doe",
      "first_name": "John",
      "last_name": "Doe",
      "nick_name": "Johnny",
      "display_name": "John Doe",
      "description": "Tech enthusiast sharing coding tutorials and tech reviews. New videos every week!",
      "profile_picture_url": "https://yt3.ggpht.com/sample-profile-picture",
      "date_of_birth": "1990:01:15",
      "category": "Technology",
      "website_url": "https://www.johndoe.com",
      "country": "US",
      "emails": [
        {
          "value": "[email protected]",
          "type": "personal",
          "is_verified": true,
          "is_primary": true,
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "created_at": "2023-01-01T00:00:00Z",
          "updated_at": "2023-01-02T00:00:00Z",
          "profile_id": "65170d1b-6720-5e63-ae7a-86c8d6510db9"
        }
      ],
      "phone_numbers": [
        {}
      ],
      "addresses": [
        {}
      ],
      "followers_count": 10000,
      "following_count": 500,
      "subscribers_count": 50000,
      "contents_count": 200,
      "watch_time_in_hours": 150000,
      "joined_at": "2015-03-15T12:00:00.000Z",
      "verified": true
    }
  ]
}

GET

fusion

profiles

Get profiles by user account ids

curl --request GET \
  --url https://api.tapti.ai/fusion/profiles \
  --header 'x-api-key: <api-key>'

{
  "profiles": [
    {
      "id": "65170d1b-6720-5e63-ae7a-86c8d6510db9",
      "user_platform": "YOUTUBE",
      "username": "johndoe",
      "url": "https://www.youtube.com/channel/UC1234567890",
      "gender": "MALE",
      "platform_account_id": "UC1234567890",
      "full_name": "John Doe",
      "first_name": "John",
      "last_name": "Doe",
      "nick_name": "Johnny",
      "display_name": "John Doe",
      "description": "Tech enthusiast sharing coding tutorials and tech reviews. New videos every week!",
      "profile_picture_url": "https://yt3.ggpht.com/sample-profile-picture",
      "date_of_birth": "1990:01:15",
      "category": "Technology",
      "website_url": "https://www.johndoe.com",
      "country": "US",
      "emails": [
        {
          "value": "[email protected]",
          "type": "personal",
          "is_verified": true,
          "is_primary": true,
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "created_at": "2023-01-01T00:00:00Z",
          "updated_at": "2023-01-02T00:00:00Z",
          "profile_id": "65170d1b-6720-5e63-ae7a-86c8d6510db9"
        }
      ],
      "phone_numbers": [
        {}
      ],
      "addresses": [
        {}
      ],
      "followers_count": 10000,
      "following_count": 500,
      "subscribers_count": 50000,
      "contents_count": 200,
      "watch_time_in_hours": 150000,
      "joined_at": "2015-03-15T12:00:00.000Z",
      "verified": true
    }
  ]
}

Authorizations

x-api-key

string

header

required

Query Parameters

user_account_ids

any[]

required

The IDs of the user accounts to get profiles for

Example:

[
  "123e4567-e89b-12d3-a456-426614174000",
  "123e4567-e89b-12d3-a456-426614174001"
]

Response

Profiles fetched successfully

profiles

object[]

required

The profiles to get

Show child attributes

profiles.id

string

required

Unique identifier for the profile

Example:

"65170d1b-6720-5e63-ae7a-86c8d6510db9"

profiles.user_platform

string

required

The platform where this profile exists

Example:

"YOUTUBE"

profiles.username

string

required

Username on the platform

Example:

"johndoe"

profiles.url

string

required

URL to the profile on the platform

Example:

"https://www.youtube.com/channel/UC1234567890"

profiles.gender

string

required

Gender of the profile owner

Example:

"MALE"

profiles.platform_account_id

string

required

Unique identifier for the account on the platform

Example:

"UC1234567890"

profiles.full_name

string

required

Full name of the profile owner

Example:

"John Doe"

profiles.first_name

string

required

First name of the profile owner

Example:

"John"

profiles.last_name

string

required

Last name of the profile owner

Example:

"Doe"

profiles.nick_name

string

required

Nickname of the profile owner

Example:

"Johnny"

profiles.display_name

string

required

Display name shown on the platform

Example:

"John Doe"

profiles.description

string

required

Profile bio or description

Example:

"Tech enthusiast sharing coding tutorials and tech reviews. New videos every week!"

profiles.profile_picture_url

string

required

URL to the profile picture

Example:

"https://yt3.ggpht.com/sample-profile-picture"

profiles.date_of_birth

string

required

Date of birth of the profile owner

Example:

"1990:01:15"

profiles.category

string

required

Category or niche of the profile

Example:

"Technology"

profiles.website_url

string

required

URL to the personal website

Example:

"https://www.johndoe.com"

profiles.country

string

required

Country code of the profile owner

Example:

"US"

profiles.emails

object[]

required

Array of email addresses associated with the profile

Show child attributes

profiles.emails.value

string

required

The email address value

Example:

"[email protected]"

profiles.emails.type

string

required

The type of email address (e.g. personal, work)

Example:

"personal"

profiles.emails.is_verified

boolean

required

Whether the email has been verified

Example:

true

profiles.emails.is_primary

boolean

required

Whether this is the primary email address

Example:

true

profiles.emails.id

string

required

Unique identifier for the email record

Example:

"550e8400-e29b-41d4-a716-446655440000"

profiles.emails.created_at

string

required

Timestamp when the email record was created

Example:

"2023-01-01T00:00:00Z"

profiles.emails.updated_at

string

required

Timestamp when the email record was last updated

Example:

"2023-01-02T00:00:00Z"

profiles.emails.profile_id

string

required

ID of the profile this email belongs to

Example:

"65170d1b-6720-5e63-ae7a-86c8d6510db9"

profiles.phone_numbers

object[]

required

Array of phone numbers associated with the profile

profiles.addresses

object[]

required

Array of addresses associated with the profile

profiles.followers_count

number

required

Number of followers the profile has

Example:

10000

profiles.following_count

number

required

Number of accounts the profile is following

Example:

500

profiles.subscribers_count

number

required

Number of subscribers the profile has

Example:

50000

profiles.contents_count

number

required

Number of content items posted by the profile

Example:

200

profiles.watch_time_in_hours

number

required

Total watch time of profile content in hours

Example:

150000

profiles.joined_at

string

required

Date when the profile was created on the platform

Example:

"2015-03-15T12:00:00.000Z"

profiles.verified

boolean

required

Whether the profile is verified on the platform

Example:

true

Fetch a profile Refresh Profiles

⌘I

API Reference

User

User Accounts

Profiles

Jobs

Get Profile By User Account ID

Authorizations

Query Parameters

Response