Threads API

Threads の公開処理は、Meta のサーバーサイドクローラー経由でお使いの URL からメディアを取得します。 Ayrshare のエラーコード 379 が表示される場合（特に同一公開内で Instagram のエラー 440 または 138 と併発する場合）は、 Meta Media Crawler Blocked を参照してください。

Threads への投稿

Threads API を使って、リンクと画像を含む基本的な投稿を行う JSON：

Threads Post

{
  "post": "The best Threads post ever #best #awesome https://www.threads.net", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["threads"]
}

Threads API には以下の要件と制限があります：

Threads は、投稿に画像や動画が含まれていない限り、リンクを自動的にプレビュー表示します。上記の例では画像が表示されます。画像を削除するとリンクプレビューが表示されます。
Threads プロファイルは、24 時間の移動期間内に API 経由で公開できる投稿数が 250 件に制限されています。
Threads は 1 投稿につき 1 つのハッシュタグしか許可しません。
@メンションされた Threads ユーザーは通知を受け取ります。
投稿の最大文字数は 500 文字。
複数画像/動画投稿はサポートされており、カルーセルとして送信されます。最大 20 の動画と画像を送信できます。
Threads は API 経由の削除をサポートしていません。削除は Threads アプリから手動で行う必要があります。
動画が mp4 などの既知の拡張子で終わらない場合、isVideo パラメーターを使用してください。詳細は /post エンドポイントを参照してください。
Threads は投稿テキストなしでメディアのみを送信することもサポートしています。投稿テキストを含めない場合は、空の文字列 post: "" を送信してください。
詳細は Threads Media Guidelines および Threads Authorization を参照してください。

Threads オプション

threadsOptions パラメーターを使って、投稿に追加のオプションを設定できます。

Threads Options

{
  "threadsOptions": {
    "allowCountries": ["US", "CA"],
    "thread": true,
    "threadNumber": true,
    "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"] // used when sending as a thread of threads
  }
}

Threads オプションは、投稿を制御するために使用できる任意のフィールドです。

allowCountries

array of strings

国コードを使って、投稿を特定の国に制限します。国コードを使用してください。Meta がアカウントに対して地理制限を有効にしている場合のみ利用可能です。詳細は Threads Geo Restrictions を参照してください。

thread

boolean

デフォルト:false

長い投稿を、オプションの番号付けとメディアを備えた連結されたスレッドシリーズに分割します。詳細は Thread を参照してください。

threadNumber

boolean

デフォルト:false

各スレッドの末尾に自動的に 1/n 形式の番号を追加します。thread: true が必要です。

mediaUrls

array of strings

スレッドオブスレッドにメディアオブジェクトを追加します。各スレッドに順番に 1 つのメディアオブジェクトが追加されます。特定のスレッドでメディアをスキップするには null を使用します。1 つのスレッドに複数のメディアを持たせるには、複数の URL を持つオブジェクトを使用します。詳細は Thread Media を参照してください。

Threads 投稿に改行やリッチテキストを追加する

Threads の改行は、特殊な改行文字を使って投稿に追加できます。太字や斜体などのリッチテキストは、いくつかの html 要素を使って Threads 投稿に追加できます。

画像・動画のカルーセル

Threads に複数の画像や動画をカルーセルとして投稿できます。カルーセルには合計最大 20 個の画像や動画を使用可能です。追加の画像や動画を mediaUrls 配列に追加するだけで、カルーセルが自動的に作成されます。

"mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...];  // Max 20 images or videos

動画 URL は mp4 のような既知の拡張子で終わる必要があります。

文字数制限

詳細については Threads Character Limits を参照してください。

地理制限

allowCountries 配列を使って、投稿を特定の国に制限できます。

{
  "threadsOptions": {
    "allowCountries": ["US", "CA"]
  }
}

allowCountries: 許可する国コードの配列。国コードを参照してください。

Threads の地理制限（ジオゲーティング）は、Meta がアカウントに対してこの機能を有効にしている場合のみ利用可能です。Meta は、アカウント認証、フォロワー数、コンテンツクリエイターステータスなどの要因に基づいて、どの Threads アカウントが地理制限の対象となるかを決定します。アカウントが対象の場合、新しい Threads 投稿を作成する際に投稿コンポーザー内に地理設定（地球アイコン）が表示されます。ユーザープロファイルが Threads の地理制限の対象かどうかは、/user エンドポイントの isEligibleForGeoRestrictions プロパティを確認することで判定できます。

Threads メンション

投稿テキストに @handle を追加することで、別の Threads ハンドルをメンションできます。例：

{
  "post": "The best social media API @Ayrshare ever!",
  "mediaUrls": ["https://images.com"],
  "platforms": ["threads"]
}

@メンションされたユーザーには通知が届きます。メンションに関する重要なルールを必ずご確認ください。

クォータに達している場合、エラーメッセージが返されます。

スレッド

Threads のスレッド（スレッドストームとも呼ばれる）は、Threads 上で連結された一連の投稿で、単一の投稿の文字数制限を超える、より長いアイデアを共有できます。まとめて見ると 1 つの連続したナラティブとして表示されます。

スレッドの投稿

Threads のスレッドは API 経由で投稿できます。スレッドは、Threads 上で関連付けられた返信投稿のセットに分割された投稿です。投稿を自動的に分割することも、投稿テキストの中でスレッド分割を指定することもできます。

Threads Thread

{
  "threadsOptions": {
    "thread": true,        // required for threadstorm
    "threadNumber": true,  // optional to add numbers to each thread
    "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...]  // optional one media object is added to a thread in order
  }
}

thread: true — 改行に基づいて投稿テキストを自動的にスレッドに分割します。
threadNumber: true — スレッドの末尾に 1/n 形式で自動的に番号を追加します。たとえば、5 つのスレッドのうち 2 番目のスレッドには 2/5 が追加されます。
mediaUrls: [array of urls] — 各メディアオブジェクト（画像または動画）を順番にスレッドに追加します。各スレッドには順番に 1 つのメディアオブジェクトのみが追加されます。

スレッドメディア

メディアのスキップ

配列内で null を使うことで、あるスレッドのメディアをスキップできます。例： ["https://site.com/image1.png", null, "https://site.com/image2.png"] これにより、1 番目の投稿に image1、2 番目の投稿には画像なし、3 番目の投稿に image2 が配置されます。

複数のメディア

mediaUrls 配列内にメディア URL を持つオブジェクト {} を追加することで、スレッド内の 1 つの投稿に複数のメディアオブジェクトを追加できます。任意のユニークなオブジェクトキーが使用可能です。例：

Threads Thread with Multiple Media URLs

{
  "threadsOptions": {
    "thread": true,
    "threadNumber": true,
    "mediaUrls": [
      "https://img.ayrshare.com/random/photo-1.jpg",
      {
        "1": "https://img.ayrshare.com/random/photo-2.jpg",
        "2": "https://img.ayrshare.com/random/photo-3.jpg"
      },
      "https://img.ayrshare.com/random/photo-4.jpg"
    ]
  }
}

この例では、1 番目の投稿に photo-1.jpg、2 番目の投稿に photo-2.jpg と photo-3.jpg、3 番目の投稿に photo-4.jpg が含まれます。

スレッド分割

Ayrshare は、投稿テキストを Threads に適した長さ（500 文字超）の投稿に自動的に分割します。スレッドを作成する際は、可能な限り 1 つの投稿の中に完結した文を保つことを優先します。文が収まらない場合は文と文の間で分割します。非常に長い文の場合は単語間で分割します。まれに単語が長すぎる場合、単語自体を分割します。投稿テキストに \n\n を手動で追加することで、独自のスレッドを作成することを示すこともできます。投稿テキストに \n\n が含まれる場合、投稿を自動的にスレッドに分割することはしません。例：

Example Threads Thread

{
  "post": "This is post 1\n\nThis is post 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}

は、スレッド内に 2 つの投稿を作成します。段落を追加したいが、投稿に分割したくない場合は、\u2063\n\u2063\n を使用してください。

Threads Thread with Paragraphs

{
  "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}

は、投稿が 500 文字未満のため、2 つの段落を持つ 1 つの投稿になります。

スレッドの削除

Threads は API 経由の削除をサポートしていません。削除は Threads アプリから手動で行う必要があります。

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Threads への投稿

Threads オプション

Threads 投稿に改行やリッチテキストを追加する

画像・動画のカルーセル

文字数制限

地理制限

Threads メンション

スレッド

スレッドの投稿

スレッドメディア

メディアのスキップ

複数のメディア

スレッド分割

スレッドの削除

​Threads への投稿

​Threads オプション

​Threads 投稿に改行やリッチテキストを追加する

​画像・動画のカルーセル

​文字数制限

​地理制限

​Threads メンション

​スレッド

​スレッドの投稿

​スレッドメディア

メディアのスキップ

複数のメディア

​スレッド分割

​スレッドの削除

Threads への投稿

Threads オプション

Threads 投稿に改行やリッチテキストを追加する

画像・動画のカルーセル

文字数制限

地理制限

Threads メンション

スレッド

スレッドの投稿

スレッドメディア

スレッド分割

スレッドの削除