Ambil Pengguna Berdasarkan Nama Pengguna | Dokumentasi API

# Get User By Username

Query a Twitter user profile by username and return a normalized X API v2-style user object.

GET https://api.apihop.ai/v1/twitter/users

Use `username` to query a user profile. This endpoint is useful when you only know a username and need the normalized `data.id` for timeline requests.

```text
GET https://api.apihop.ai/v1/twitter/users
```

## Authentication

All Twitter API endpoints require Bearer Token authentication.

```http
Authorization: Bearer YOUR_API_KEY
```

## Query Parameters

### `username` (string, required)

Twitter username. Both `elonmusk` and `@elonmusk` are accepted; the leading `@` is removed server-side.

### `user.fields` (string)

Comma-separated user fields, such as `created_at,description,public_metrics,verified`.

## Request Example

```bash
curl --request GET \
  "$API_BASE_URL/v1/twitter/users?username=elonmusk&user.fields=created_at,description,public_metrics,verified" \
  --header "Authorization: Bearer YOUR_API_KEY"
```

## Response

### `data` (object, required)

Normalized user object.

### data fields

### `id` (string, required)

Unique user identifier. Prefer this value for timeline queries.

### `name` (string, required)

Display name.

### `username` (string, required)

Username without `@`.

### `created_at` (string)

ISO 8601 timestamp, returned when `user.fields=created_at` is requested.

### `description` (string)

User bio.

### `entities` (object)

Profile entities, such as URL descriptions and links.

### `location` (string)

Location in the user profile.

### `pinned_tweet_id` (string)

ID of the pinned tweet.

### `profile_banner_url` (string)

Profile banner URL.

### `profile_image_url` (string)

Profile image URL.

### `protected` (boolean)

Whether the account is protected.

### `public_metrics` (object)

Public user metrics.

### public_metrics fields

### `followers_count` (integer)

Number of followers.

### `following_count` (integer)

Number of accounts followed.

### `tweet_count` (integer)

Total number of tweets.

### `listed_count` (integer)

Number of lists containing the user. May be absent when the data source does not provide it.

### `url` (string)

Website URL in the user profile.

### `verified` (boolean)

Whether the account is verified.

### `verified_type` (string)

Verification type, such as `Business`.

### Success Example

```json
{
  "data": {
    "id": "44196397",
    "name": "Elon Musk",
    "username": "elonmusk",
    "created_at": "2009-06-02T20:12:29.000Z",
    "description": "Mars and cars",
    "public_metrics": {
      "followers_count": 10,
      "following_count": 20,
      "tweet_count": 40
    },
    "verified": true
  }
}
```

## Error Response

See [Error Codes and Troubleshooting](https://apihop.ai/en/docs/api-reference/errors) for the full code reference, protocol differences, and diagnostic steps.

```json
{
  "success": false,
  "error": {
    "code": 40000,
    "message": "Insufficient credit. Required: 100000, Available: 99999"
  },
  "requestId": "req_xxx"
}
```

## Usage Tips

- If you only know `username`, call this endpoint first
- If you plan to query a timeline, use the returned `data.id`
- If you only need avatar, bio, or follower counts, pass `user.fields` explicitly

Gunakan username untuk mengueri profil pengguna. Endpoint ini berguna jika Anda hanya mengetahui nama pengguna dan memerlukan data.id yang dinormalisasi untuk permintaan linimasa.

text

GET https://api.apihop.ai/v1/twitter/users

Autentikasi

Semua endpoint API Twitter memerlukan autentikasi Bearer Token.

http

Authorization: Bearer YOUR_API_KEY

Parameter Kueri

usernamestringwajib

Nama pengguna Twitter. elonmusk dan @elonmusk sama-sama diterima; @ di awal dihapus oleh server.

user.fieldsstring

Kolom pengguna yang dipisahkan koma, misalnya created_at,description,public_metrics,verified.

Contoh Permintaan

bash

curl --request GET \
  "$API_BASE_URL/v1/twitter/users?username=elonmusk&user.fields=created_at,description,public_metrics,verified" \
  --header "Authorization: Bearer YOUR_API_KEY"

Respons

dataobjectwajib

Objek pengguna yang dinormalisasi.

Kolom data

idstringwajib

Pengenal pengguna unik. Utamakan nilai ini untuk kueri linimasa.

namestringwajib

Nama tampilan.

usernamestringwajib

Nama pengguna tanpa @.

created_atstring

Stempel waktu ISO 8601, dikembalikan jika user.fields=created_at diminta.

descriptionstring

Biografi pengguna.

entitiesobject

Entitas profil, seperti deskripsi URL dan tautan.

locationstring

Lokasi dalam profil pengguna.

pinned_tweet_idstring

ID postingan yang disematkan.

profile_banner_urlstring

URL banner profil.

profile_image_urlstring

URL gambar profil.

protectedboolean

Apakah akun dilindungi.

public_metricsobject

Metrik publik pengguna.

Kolom public_metrics

followers_countinteger

Jumlah pengikut.

following_countinteger

Jumlah akun yang diikuti.

tweet_countinteger

Jumlah total postingan.

listed_countinteger

Jumlah daftar yang memuat pengguna. Dapat tidak tersedia jika sumber data tidak menyediakannya.

urlstring

URL situs web dalam profil pengguna.

verifiedboolean

Apakah akun terverifikasi.

verified_typestring

Jenis verifikasi, misalnya Business.

Contoh Berhasil

json

{
  "data": {
    "id": "44196397",
    "name": "Elon Musk",
    "username": "elonmusk",
    "created_at": "2009-06-02T20:12:29.000Z",
    "description": "Mars and cars",
    "public_metrics": {
      "followers_count": 10,
      "following_count": 20,
      "tweet_count": 40
    },
    "verified": true
  }
}

Respons Kesalahan

Lihat Kode Kesalahan dan Pemecahan Masalah untuk referensi kode lengkap, perbedaan protokol, dan langkah diagnosis.

json

{
  "success": false,
  "error": {
    "code": 40000,
    "message": "Insufficient credit. Required: 100000, Available: 99999"
  },
  "requestId": "req_xxx"
}

Tips Penggunaan

Jika hanya mengetahui username, panggil endpoint ini terlebih dahulu
Jika akan mengueri linimasa, gunakan data.id yang dikembalikan
Jika hanya memerlukan avatar, biografi, atau jumlah pengikut, kirim user.fields secara eksplisit