Obtenir un utilisateur par nom | Documentation des 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

Utilisez username pour consulter un profil. Cet endpoint est utile lorsque vous ne connaissez qu’un nom d’utilisateur et avez besoin du data.id normalisé pour les requêtes de fil.

text

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

Authentification

Tous les endpoints de l’API Twitter nécessitent une authentification par jeton Bearer.

http

Authorization: Bearer YOUR_API_KEY

Paramètres de requête

usernamestringobligatoire

Nom d’utilisateur Twitter. elonmusk et @elonmusk sont acceptés ; le @ initial est supprimé côté serveur.

user.fieldsstring

Champs utilisateur séparés par des virgules, comme created_at,description,public_metrics,verified.

Exemple de requête

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"

Réponse

dataobjectobligatoire

Objet utilisateur normalisé.

Champs de data

idstringobligatoire

Identifiant unique de l’utilisateur. Privilégiez cette valeur pour les requêtes de fil.

namestringobligatoire

Nom affiché.

usernamestringobligatoire

Nom d’utilisateur sans @.

created_atstring

Horodatage ISO 8601, renvoyé lorsque user.fields=created_at est demandé.

descriptionstring

Biographie de l’utilisateur.

entitiesobject

Entités du profil, comme descriptions d’URL et liens.

locationstring

Localisation dans le profil utilisateur.

pinned_tweet_idstring

ID de la publication épinglée.

profile_banner_urlstring

URL de la bannière du profil.

profile_image_urlstring

URL de l’image de profil.

protectedboolean

Indique si le compte est protégé.

public_metricsobject

Indicateurs publics de l’utilisateur.

Champs de public_metrics

followers_countinteger

Nombre d’abonnés.

following_countinteger

Nombre de comptes suivis.

tweet_countinteger

Nombre total de publications.

listed_countinteger

Nombre de listes contenant l’utilisateur. Peut être absent si la source ne le fournit pas.

urlstring

URL du site web dans le profil utilisateur.

verifiedboolean

Indique si le compte est vérifié.

verified_typestring

Type de vérification, comme Business.

Exemple réussi

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
  }
}

Réponse d’erreur

Consultez Codes d’erreur et dépannage pour la référence complète des codes, les différences de protocole et les étapes de diagnostic.

json

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

Conseils d’utilisation

Si vous connaissez uniquement username, appelez d’abord cet endpoint
Pour consulter un fil, utilisez le data.id renvoyé
Si vous souhaitez seulement l’avatar, la biographie ou le nombre d’abonnés, passez explicitement user.fields