Créer ou mettre à jour une Publication

curl --request POST \
  --url https://api.x.com/2/tweets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "card_uri": "<string>",
  "community_id": "1146654567674912769",
  "direct_message_deep_link": "<string>",
  "for_super_followers_only": false,
  "geo": {
    "place_id": "<string>"
  },
  "nullcast": false,
  "quote_tweet_id": "1346889436626259968",
  "share_with_followers": false,
  "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
}
'

import requests

url = "https://api.x.com/2/tweets"

payload = {
    "card_uri": "<string>",
    "community_id": "1146654567674912769",
    "direct_message_deep_link": "<string>",
    "for_super_followers_only": False,
    "geo": { "place_id": "<string>" },
    "nullcast": False,
    "quote_tweet_id": "1346889436626259968",
    "share_with_followers": False,
    "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\u2026 https:\/\/t.co\/56a0vZUx7i"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    card_uri: '<string>',
    community_id: '1146654567674912769',
    direct_message_deep_link: '<string>',
    for_super_followers_only: false,
    geo: {place_id: '<string>'},
    nullcast: false,
    quote_tweet_id: '1346889436626259968',
    share_with_followers: false,
    text: 'Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\u2026 https:\/\/t.co\/56a0vZUx7i'
  })
};

fetch('https://api.x.com/2/tweets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/tweets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'card_uri' => '<string>',
    'community_id' => '1146654567674912769',
    'direct_message_deep_link' => '<string>',
    'for_super_followers_only' => false,
    'geo' => [
        'place_id' => '<string>'
    ],
    'nullcast' => false,
    'quote_tweet_id' => '1346889436626259968',
    'share_with_followers' => false,
    'text' => 'Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/tweets"

	payload := strings.NewReader("{\n  \"card_uri\": \"<string>\",\n  \"community_id\": \"1146654567674912769\",\n  \"direct_message_deep_link\": \"<string>\",\n  \"for_super_followers_only\": false,\n  \"geo\": {\n    \"place_id\": \"<string>\"\n  },\n  \"nullcast\": false,\n  \"quote_tweet_id\": \"1346889436626259968\",\n  \"share_with_followers\": false,\n  \"text\": \"Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\\\u2026 https:\\\\/\\\\/t.co\\\\/56a0vZUx7i\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.x.com/2/tweets")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"card_uri\": \"<string>\",\n  \"community_id\": \"1146654567674912769\",\n  \"direct_message_deep_link\": \"<string>\",\n  \"for_super_followers_only\": false,\n  \"geo\": {\n    \"place_id\": \"<string>\"\n  },\n  \"nullcast\": false,\n  \"quote_tweet_id\": \"1346889436626259968\",\n  \"share_with_followers\": false,\n  \"text\": \"Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\\\u2026 https:\\\\/\\\\/t.co\\\\/56a0vZUx7i\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/tweets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"card_uri\": \"<string>\",\n  \"community_id\": \"1146654567674912769\",\n  \"direct_message_deep_link\": \"<string>\",\n  \"for_super_followers_only\": false,\n  \"geo\": {\n    \"place_id\": \"<string>\"\n  },\n  \"nullcast\": false,\n  \"quote_tweet_id\": \"1346889436626259968\",\n  \"share_with_followers\": false,\n  \"text\": \"Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\\\u2026 https:\\\\/\\\\/t.co\\\\/56a0vZUx7i\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "1346889436626259968",
    "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

{
  "code": 123,
  "message": "<string>"
}

POST

tweets

Créer ou mettre à jour une Publication

curl --request POST \
  --url https://api.x.com/2/tweets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "card_uri": "<string>",
  "community_id": "1146654567674912769",
  "direct_message_deep_link": "<string>",
  "for_super_followers_only": false,
  "geo": {
    "place_id": "<string>"
  },
  "nullcast": false,
  "quote_tweet_id": "1346889436626259968",
  "share_with_followers": false,
  "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
}
'

import requests

url = "https://api.x.com/2/tweets"

payload = {
    "card_uri": "<string>",
    "community_id": "1146654567674912769",
    "direct_message_deep_link": "<string>",
    "for_super_followers_only": False,
    "geo": { "place_id": "<string>" },
    "nullcast": False,
    "quote_tweet_id": "1346889436626259968",
    "share_with_followers": False,
    "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\u2026 https:\/\/t.co\/56a0vZUx7i"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    card_uri: '<string>',
    community_id: '1146654567674912769',
    direct_message_deep_link: '<string>',
    for_super_followers_only: false,
    geo: {place_id: '<string>'},
    nullcast: false,
    quote_tweet_id: '1346889436626259968',
    share_with_followers: false,
    text: 'Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\u2026 https:\/\/t.co\/56a0vZUx7i'
  })
};

fetch('https://api.x.com/2/tweets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/tweets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'card_uri' => '<string>',
    'community_id' => '1146654567674912769',
    'direct_message_deep_link' => '<string>',
    'for_super_followers_only' => false,
    'geo' => [
        'place_id' => '<string>'
    ],
    'nullcast' => false,
    'quote_tweet_id' => '1346889436626259968',
    'share_with_followers' => false,
    'text' => 'Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/tweets"

	payload := strings.NewReader("{\n  \"card_uri\": \"<string>\",\n  \"community_id\": \"1146654567674912769\",\n  \"direct_message_deep_link\": \"<string>\",\n  \"for_super_followers_only\": false,\n  \"geo\": {\n    \"place_id\": \"<string>\"\n  },\n  \"nullcast\": false,\n  \"quote_tweet_id\": \"1346889436626259968\",\n  \"share_with_followers\": false,\n  \"text\": \"Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\\\u2026 https:\\\\/\\\\/t.co\\\\/56a0vZUx7i\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.x.com/2/tweets")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"card_uri\": \"<string>\",\n  \"community_id\": \"1146654567674912769\",\n  \"direct_message_deep_link\": \"<string>\",\n  \"for_super_followers_only\": false,\n  \"geo\": {\n    \"place_id\": \"<string>\"\n  },\n  \"nullcast\": false,\n  \"quote_tweet_id\": \"1346889436626259968\",\n  \"share_with_followers\": false,\n  \"text\": \"Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\\\u2026 https:\\\\/\\\\/t.co\\\\/56a0vZUx7i\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/tweets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"card_uri\": \"<string>\",\n  \"community_id\": \"1146654567674912769\",\n  \"direct_message_deep_link\": \"<string>\",\n  \"for_super_followers_only\": false,\n  \"geo\": {\n    \"place_id\": \"<string>\"\n  },\n  \"nullcast\": false,\n  \"quote_tweet_id\": \"1346889436626259968\",\n  \"share_with_followers\": false,\n  \"text\": \"Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\\\u2026 https:\\\\/\\\\/t.co\\\\/56a0vZUx7i\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "1346889436626259968",
    "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

{
  "code": 123,
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

tweet.read

View all Posts you can see, including those from protected accounts.

tweet.write

Post and repost on your behalf.

users.read

View any account you can see, including protected accounts.

Body

application/json

card_uri

string

Paramètre Card URI. Ce paramètre ne peut pas être utilisé conjointement avec Quote Tweet Id, Poll, Media ou Direct Message Deep Link.

community_id

string

L’identifiant unique de cette Communauté.

Pattern: ^[0-9]{1,19}$

Example:

"1146654567674912769"

direct_message_deep_link

string

Lien permettant de faire passer la conversation de la timeline publique à un Message direct privé.

edit_options

object

Options pour modifier une Publication existante. Lorsqu’elles sont définies, cette requête modifie la Publication spécifiée au lieu d’en créer une nouvelle.

Show child attributes

for_super_followers_only

boolean

default:false

Tweet réservé aux super‑followers.

geo

object

Identifiant de lieu associé au Tweet pour la géolocalisation.

Show child attributes

media

object

Informations relatives aux médias associés au Tweet créé. Ce champ est mutuellement exclusif avec Quote Tweet id, Poll et Card URI.

Show child attributes

nullcast

boolean

default:false

Les Publications nullcastées (diffusées uniquement en promotion) n’apparaissent pas dans la timeline publique et ne sont pas diffusées aux abonnés.

poll

object

Options pour un Tweet contenant un sondage. Ceci est mutuellement exclusif avec Media, l’id du Tweet cité et l’URI de la carte (Card).

Show child attributes

quote_tweet_id

string

Identifiant unique de ce Tweet. Il est renvoyé sous forme de chaîne de caractères afin d’éviter les complications avec les langages et outils qui ne gèrent pas les entiers de très grande taille.

Pattern: ^[0-9]{1,19}$

Example:

"1346889436626259968"

object

Informations sur le Tweet auquel il répond.

Show child attributes

reply_settings

enum<string>

Paramètres définissant qui peut répondre au Tweet.

Available options:

following,

mentionedUsers,

subscribers,

verified

Partager également la publication de la communauté avec les abonnés.

text

string

Contenu du Tweet.

Example:

"Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"

Response

La requête a réussi.

data

object

Show child attributes

errors

object[]

Minimum array length: 1

Un objet HTTP Problem Details, tel que défini dans la RFC IETF 7807 (https://tools.ietf.org/html/rfc7807).

Show child attributes

Getting Started

Fundamentals

Partners & Customers

Resources

Créer ou mettre à jour une Publication

Authorizations

Scopes

Body

Response