X API v2 manage Posts クイックスタート

このガイドでは、X API を使用して投稿を作成・削除する方法を説明します。

前提条件始める前に以下が必要です:

承認済みの App を含む開発者アカウント
ユーザーアクセストークン(OAuth 1.0a または OAuth 2.0 PKCE)

投稿を作成する

リクエストを準備する

POST /2/tweets エンドポイントには、少なくとも text または media を含む JSON ボディが必要です:

{
  "text": "Hello from the X API!"
}

リクエストを送信する

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from the X API!"}'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# 投稿を作成する
response = client.posts.create(text="Hello from the X API!")
print(f"Created Post: {response.data.id}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// 投稿を作成する
const response = await client.posts.create({ text: "Hello from the X API!" });
console.log(`Created Post: ${response.data?.id}`);

レスポンスを確認する

成功したレスポンスには新しい投稿の id と text が含まれます:

{
  "data": {
    "id": "1445880548472328192",
    "text": "Hello from the X API!"
  }
}

応用例

投稿に返信する

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "This is a reply!",
    "reply": {
      "in_reply_to_tweet_id": "1234567890"
    }
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# 返信を作成する
response = client.posts.create(
    text="This is a reply!",
    reply={"in_reply_to_tweet_id": "1234567890"}
)
print(f"Created reply: {response.data.id}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// 返信を作成する
const response = await client.posts.create({
  text: "This is a reply!",
  reply: { inReplyToTweetId: "1234567890" },
});
console.log(`Created reply: ${response.data?.id}`);

投稿を引用する

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Check this out!",
    "quote_tweet_id": "1234567890"
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# 投稿を引用する
response = client.posts.create(
    text="Check this out!",
    quote_tweet_id="1234567890"
)
print(f"Created quote: {response.data.id}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// 投稿を引用する
const response = await client.posts.create({
  text: "Check this out!",
  quoteTweetId: "1234567890",
});
console.log(`Created quote: ${response.data?.id}`);

メディア付き投稿

まずメディアアップロードエンドポイントでメディアをアップロードし、media_id を参照します:

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Photo of the day!",
    "media": {
      "media_ids": ["1234567890123456789"]
    }
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# メディア付き投稿
response = client.posts.create(
    text="Photo of the day!",
    media={"media_ids": ["1234567890123456789"]}
)
print(f"Created Post with media: {response.data.id}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// メディア付き投稿
const response = await client.posts.create({
  text: "Photo of the day!",
  media: { mediaIds: ["1234567890123456789"] },
});
console.log(`Created Post with media: ${response.data?.id}`);

Poll 付き投稿

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "What is your favorite color?",
    "poll": {
      "options": ["Red", "Blue", "Green", "Yellow"],
      "duration_minutes": 1440
    }
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Poll 付き投稿
response = client.posts.create(
    text="What is your favorite color?",
    poll={"options": ["Red", "Blue", "Green", "Yellow"], "duration_minutes": 1440}
)
print(f"Created poll: {response.data.id}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Poll 付き投稿
const response = await client.posts.create({
  text: "What is your favorite color?",
  poll: { options: ["Red", "Blue", "Green", "Yellow"], durationMinutes: 1440 },
});
console.log(`Created poll: ${response.data?.id}`);

有償パートナーシップ付き投稿

paid_partnership フィールドを使用して、投稿が有償パートナーシップであること(投稿に有償プロモーションが含まれることを作成者が開示している)を示します。true に設定すると、投稿は有償プロモーションとしてラベル付けされます。

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Excited to partner with Acme on their latest launch!",
    "paid_partnership": true
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# 有償パートナーシップ付き投稿
response = client.posts.create(
    text="Excited to partner with Acme on their latest launch!",
    paid_partnership=True
)
print(f"Created paid partnership post: {response.data.id}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// 有償パートナーシップ付き投稿
const response = await client.posts.create({
  text: "Excited to partner with Acme on their latest launch!",
  paidPartnership: true,
});
console.log(`Created paid partnership post: ${response.data?.id}`);

投稿を削除する

投稿 ID を取得する

削除したい投稿の ID が必要です。これは投稿作成時に返されます。

DELETE リクエストを送信する

cURL

curl -X DELETE "https://api.x.com/2/tweets/1445880548472328192" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# 投稿を削除する
response = client.posts.delete("1445880548472328192")
print(f"Deleted: {response.data.deleted}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// 投稿を削除する
const response = await client.posts.delete("1445880548472328192");
console.log(`Deleted: ${response.data?.deleted}`);

削除を確認する

{
  "data": {
    "deleted": true
  }
}

自分が作成した投稿のみ削除できます。

次のステップ

統合ガイド

主要な概念とベストプラクティス

メディアアップロード

投稿用にメディアをアップロード

API リファレンス

エンドポイントの完全なドキュメント

サンプルコード

動作するコード例

Getting Started

Products

Fundamentals

Partners & Customers

Resources

X API v2 manage Posts クイックスタート

投稿を作成する

応用例

投稿を削除する

次のステップ

統合ガイド

メディアアップロード

API リファレンス

サンプルコード

​投稿を作成する

​応用例

​投稿を削除する

​次のステップ

統合ガイド

メディアアップロード

API リファレンス

サンプルコード

投稿を作成する

応用例

投稿を削除する

次のステップ