نحوه ارسال و تجزیه و تحلیل با API توییتر

adminآگوست 25, 2025

0 26 خواندن این مطلب 10 دقیقه زمان میبرد

نحوه ارسال و تجزیه و تحلیل با API توییتر

در این درس ، دریابید که چگونه API X/Twitter می تواند تجارت شما را بهبود بخشد و نحوه ارسال و دریافت تجزیه و تحلیل را مستقیماً از پلتفرم یا برنامه خود در کاربران خود بیاموزد.

با وجود فاجعه اخیر ، توییتر ، که اکنون با نام X شناخته می شود ، با حدود 238 میلیون کاربر فعال روزانه در سراسر جهان یکی از مشهورترین سیستم عامل های رسانه های اجتماعی است. برخی از بزرگترین شرکت ها ، مارک ها و افراد مشهور هر روز در توییتر در مکالمات عمومی با مشتری و پیروان شرکت می کنند.

بخش اعظم این تعهد به صورت دستی با استفاده از برنامه های توییتر یا برنامه های ساخته شده در توییتر یا برنامه های شخص ثالث ساخته شده است. اما توییتر همچنین دارای یک API پایدار (رابط برنامه) است که دنیای فرصت ها را باز می کند ، به عنوان مثال توییت از طرف کاربر خود مستقیماً از پلتفرم خود ، یک تحلیل غنی مانند رشد پیروان ارائه می دهد ، یا وقتی شخصی در مورد پست های خود اظهار نظر می کند ، به کاربران خود اطلاع می دهد.

در اینجا یک راهنمای سریع برای نحوه ادغام API در توییتر ، ارسال یک پست و دریافت تجزیه و تحلیل آورده شده است.

چرا توییتر برای تجارت شما مهم است

تجارت قادر است با استفاده از قابلیت های توییتر ، از جمله توییت های تبلیغاتی ، retouates ، تبلیغات ، با مشتریان درگیر شود. فضاهای توییترلیست های CURATION ، پیام های مستقیم ، تعبیه وب سایت و حاشیه هاطبق توییتر ، بیش از 68 ٪ کاربران از تجارت خریداری می کنند آنها دنبال می کنند. مطالعات دیگر نشان می دهد که مشتریان ترجیح می دهند اعلام کنند به جای تماس با پشتیبانی مشتری ، و کسانی که از توییتر خوبی برخوردار می شوند احتمالاً بیشتر برای این برند خرج می کنند.

جمعیت شناسی کاربر توییتر نیز قانع کننده است. با توجه به همه اینها ، تعداد کاربرانی که می توانند افزایش دهند ، هر سال در سال 2022 به 41.5 میلیون افزایش می یابد ، آیا راهی وجود دارد که یک تجارت بتواند از توییتر بهتر استفاده کند؟ API وجود دارد.

مقدمه ای در API توییتر

او API استراحت توییتر برنامه های وب و تلفن همراه را برای استفاده از داده ها و ویژگی های توییتر برای نیازهای تجاری منحصر به فرد و تجربه مشتری خود فعال کنید.

در اینجا موارد جالب استفاده از تجارت API توییتر آورده شده است:

پلت فرم استخدام (مانند واقعاً) می تواند وظایف جدیدی را از مشتری در این مشتری در توییتر ارسال کند.
سکوی املاک و مستغلات خانگی (مانند Zillow) می تواند فیلم هایی از اجاره های جدید را در حساب توییتر از درس و تبلیغات آنها با استفاده از API ADS ارسال کند.
هر بار که هش خرید به عنوان “#BlackFridaySale” یک روند است ، یک پلت فرم تجارت الکترونیکی مانند Shopify می تواند به طور خودکار آن را در زمان واقعی پیدا کند و آخرین محصولات موجود در موجودی خود را صدا کند.
یک بستر خدمات مشتری مانند Intercom می تواند به طور خودکار توییت ها را با استفاده از نقطه پایان جستجو جستجو کند و بلیط را برای مشتری که شکایات خود را برای کاربران در توییتر دریافت می کند ، باز کند.

اگر شما یک توسعه دهنده هستید ، ما شما را از طریق یک درس مرحله ای -در مرحله شروع می کنیم تا از API در توییتر شروع کنیم.

برای استفاده از API در X/Twitter آماده شوید

ابتدا باید درک کنید که برنامه شما به چه چیزی نیاز دارد و سپس داده های آن را در پورتال توسعه دهنده توییتر پیکربندی می کنید.

1. ویژگی ها و نسخه های API مورد نیاز خود را انتخاب کنید

API توییتر دارای نسخه های مختلفی مانند Twitter API V2 ، Standard V1.1 و Enterprise API (یا GNIP) است. استفاده کردن منابع API صفحه برای یافتن لیست نسخه های مورد نیاز خود.
بهترین توصیه های API Twitter: از API V2 توییتر ، که مبتنی بر GraphQL است ، برای همه تماس ها استفاده کنید ، به جز ارسال تصاویر و فیلم ها. در حال حاضر ، فقط v1.1 از انتشار رسانه هایی مانند تصاویر و فیلم ها پشتیبانی می کند.

2. سطح دسترسی به API و تأیید

سپس ، میزان دسترسی به API مورد نیاز خود را در توییتر تصمیم بگیرید سطح دسترسی صفحه هر سطح ویژگی های بیشتر و محدودیت سرعت بالاتر را باز می کند. شما بدون نیاز به تأیید ، دسترسی پیش فرض اساسی را دریافت می کنید. اما تأیید برای افزایش و دسترسی دانشگاهی به تحقیقات ضروری است. به طور کلی ، دسترسی اساسی برای شروع کافی است و در صورت لزوم می توانید برای افزایش دسترسی اقدام کنید. توجه داشته باشید که تأیید می تواند تا دو هفته یا بیشتر طول بکشد.

3. در پورتال توسعه دهنده ثبت نام کنید

در یک توسعه دهنده از یک حساب کاربری ثبت نام کنید پورتال توسعه دهنده توییترو جزئیات برنامه اصلی خود را وارد کنید.

4. تنظیمات را برای برنامه خود پیکربندی کنید

هنگامی که وارد می شوید ، برنامه اصلی خود را تحت “پروژه ها و برنامه ها” مشاهده خواهید کرد. برنامه را انتخاب کرده و تحت “تنظیمات تأیید اعتبار کاربر” کلیک کنید. برنامه خود را به شرح زیر پیکربندی کنید:

مجوزهای درخواست: بخوانید و بنویسید.
نوع: اگر برنامه شما می تواند اسرار را به عنوان راز مشتری ارسال کند ، “مشتری با اعتماد به نفس” را انتخاب کنید. اگر اینطور نیست ، “مشتری عمومی” را انتخاب کنید. معمولاً برنامه های وب سنتی محرمانه هستند ، در حالی که برنامه های تلفن همراه بدون هیچ سروری مشتری عمومی هستند.
بازپرداخت URI: نقاط پایانی برنامه خود را که توییتر می تواند در حین اجازه کاربر تماس بگیرد ، ثبت کنید.
url وب سایت: به برنامه وب یا صفحه اطلاعات آن پیوند دهید.

5. شناسه مشتری و راز برنامه خود را نگه دارید

پس از پیکربندی ، یک شناسه مشتری و راز مشتری را برای برنامه خود دریافت خواهید کرد. آنها را به طور ایمن در یک پایگاه داده ، طاق یا موارد مشابه نگه دارید. یا برنامه خود را برای خواندن ایمن آنها طراحی کنید ، یا سرور خود را برای خواندن و تزریق آنها در وسط برنامه خود تنظیم کنید.

6. تماس مستقیم یا بسته SDK مشتری را حل کنید

شما می توانید همه تماس ها را در API Twitter REST مستقیماً انجام دهید یا از یکی از بسیاری استفاده کنید بسته های SDK مشتری در توییترمورد علاقه ما برای Node.js توییتر-API-V2 است زیرا از بیشتر ویژگی ها (v1.1 و v2) پشتیبانی می کند و حفظ می کند. ما همچنین توصیه می کنیم آزمایش تماس های API در پستچی… این زندگی را بسیار ساده تر می کند.

برای بقیه این مقاله ، ما به تماس های API REST مستقیم خواهیم رسید.

از کاربران خود رضایت دهید تا از طرف آنها صدای جیر جیر کنید

برای توییت یا دریافت تجزیه و تحلیل از طرف کاربران خود ، ابتدا باید رضایت آنها را دریافت کنید. این مرحله مجوز نامیده می شود و با کمک جریان کد OAUT 2.0 تحقق می یابد. نتیجه آن یک کاربر برای دسترسی به کاربر است که به برنامه شما اجازه می دهد تا با یک API در توییتر تماس بگیرد.

1. یک اتصال یا دکمه فراهم کنید تا کاربران خود اجازه دهند

روی آن کلیک کنید ، کاربران شما می توانند جریان اجازه را آغاز کنند. هنگام کلیک با نقطه انتهایی برنامه خود تماس بگیرید.

2. URL مجوز را تولید کنید

صفحه برنامه در برنامه توییتر — صفحه برنامه توییتر به کاربر نمایش داده می شود

در شما /authorize نقطه پایانی ، یک URL مجوز ایجاد کرده و کاربر خود را در آنجا تغییر مسیر دهید. این صفحه برای مجوز متعلق به توییتر باز می شود.

مجوز فرمت URL:

https://twitter.com/i/oauth2/authorize?
response_type=code
&scope=tweet.read%20tweet.write%20users.read%20offline.access
&client_id={client-id}
&redirect_uri={registered-url}
&state={state}
&code_challenge={challenge}&code_challenge_method=S256

پارامترهای مهم در اینجا عبارتند از:

redirect_uri={registered-url}: نقطه پایان برنامه وب یا بومی شما ، که در پورتال توسعه دهنده نیز ثبت شده است. توییتر کد اجازه را از اینجا ارسال می کند.
client_id={client-id}: شناسه مشتری برنامه شما از پورتال توسعه دهنده.
scope: مجوزهایی که درخواست شما نیاز دارد. اگرچه شما فقط یک مجوز ارسال می خواهید ، اما نقطه پایان ارسال به سه مورد اول نیاز داردحرف

مقادیر باقیمانده را با استفاده از این دیگ تولید کنید:

const state = randomstring.generate(48);
const codeVerifier = randomstring.generate(128);
const base64Digest = crypto.createHash("sha256")
.update(codeVerifier).digest("base64");
const codeChallenge = base64url.fromBase64(base64Digest);

3. کد مجوز را دریافت کنید

هنگامی که کاربر به برنامه شما اجازه داده است ، توییتر کد اجازه را برای آن کاربر به برنامه شما ارسال می کند redirect_uri نکته نهایی:

GET https://REDIRECT-URL?code={auth-code}&state={state}

4. تبادل دسترسی

برای به دست آوردن یک نشانگر دسترسی API V2 API V2 ، از این کد مجوز استفاده کنید ، 2/oauth2/token:

POST https://api.twitter.com/2/oauth2/token

پارامترها عبارتند از:

grant_type=authorization_code
code={auth-code}: کد مجوز که دریافت کرده اید.
redirect_uri={registered-url}: همان URL تغییر مسیر که قبلاً ارسال شده است.
code_verifier={verifier}: codeVerifier زودتر محاسبه شد
هدر Authorization: Basic {client-credentials}
هدر Content-Type: application/x-www-form-urlencoded;charset=UTF-8

گرفتن {client-credentials} با ترکیب شناسه مشتری و راز:

const clientCreds = ${clientId}:${clientSecret};
const clientCreds = Buffer.from(clientCreds).toString('base64');

پاسخ json:

{
  "access_token": "…",
  "refresh_token": "…",
  "token_type": "bearer",
  "expires_in": 7200,
  "scope": "tweet.read tweet.write users.read offline.access"
}

این نشانگر دسترسی پس از دو ساعت منقضی می شود. اما با استفاده از Tokene Refresh ، می توانید از همان نقطه پایان نشانگرهای دسترسی جدید را درخواست کنید.

شما باید نشانه های طراوت را به عنوان رمزهای عبور درمان کنید. رمزگذاری و ذخیره آنها را به طور ایمن در پایگاه داده یا طاق خود ذخیره کنید.

ارسال توییتر با توییتر API v2

این اقدامات فقط برای دریافت این علامت دسترسی به کاربر شما اقدامات زیادی انجام داد. خوشبختانه اکنون همه چیز آسانتر است.
اولین درخواست خود را به عنوان کاربر با این پارامترها و عناوین ارسال کنید:

POST https://api.twitter.com/2/tweets

text={tweet}: متن توییت شما (واجب)
هدر Authorization: Bearer {access_token}
هدر Content-Type: application/json

اگر درخواست موفق شود ، با این JSON 200 (موفقیت) دریافت می کنید:

{
  "data": {
  "id": "1591766215437361152",
  "text": "The text of your tweet"
  }
}

شناسه برگشتی شناسه توییت است و می تواند برای اتصال مستقیم به توییت استفاده شود:

https://twitter.com/{user}/status/{ID}

اما اگر در تنظیمات برنامه یا درخواست عنوان اشتباه یا از دست رفته باشد ، با وضعیت 403 پاسخ می دهد (ممنوع):

{
  "title": "Forbidden",
  "type": "about:blank",
  "status": 403,
  "detail": "Forbidden"
}

درخواست صدای جیر جیر با استفاده از node.js با JavaScript ، به نظر می رسد:

import fetch from 'node-fetch';

// Get the access token for the current user.
// from your database / vault / keyring, etc.

const accessTokenOfUser = getAccessTokenOfLoggedInUser();
const params = {
'text': 'Your tweet'
};

const apiResp = await fetch('https://api.twitter.com/2/tweets', {
  method: 'POST',
  headers: {
    'Authorization': Bearer ${accessTokenOfUser},
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(params)
});

const tweet = await apiResp.json();

با API V2 توییتر تجزیه و تحلیل کنید

نشانگر توییت از جستجو نقطه پایان با روشن کردن اطلاعات مورد نظر شما tweet.fields:

GET https://api.twitter.com/2/tweets/{ID}?tweet.fields=public_metrics,organic_metrics,non_public_metrics

{ID}: شناسه tuit
tweet.fields: یک یا چند نفر public_metrics. ، organic_metrics. ، non_public_metricsوت promoted_metricsthe حوض معیارها او آنها را توضیح می دهد. برای جدا کردن مقادیر مختلف از کاما استفاده کنید.
هدر Authorization: Bearer {access_token}

مثال JSON پاسخ:

{
  "data": {
    "id": "1591766215437361152",
    "public_metrics": {
      "retweet_count": 0,
      "reply_count": 0,
      "like_count": 0,
      "quote_count": 0
  },
  "non_public_metrics": {
    "impression_count": 4,
    "user_profile_clicks": 0
  },
  "organic_metrics": {
    "retweet_count": 0,
    "impression_count": 4,
    "reply_count": 0,
    "like_count": 0,
    "user_profile_clicks": 0
  },
  "text": "The text of your tweet",
  …
  }
}

با استفاده از node.js با JavaScript:

import fetch from 'node-fetch';

const accessTokenOfUser = getAccessTokenOfLoggedInUser();

const tweetId = 'A-TWEET-ID';

const tweetUrl = https://api.twitter.com/2/tweets/${tweetId} +
  '?tweet.fields=public_metrics,organic_metrics,non_public_metrics';

const apiResp = await fetch(tweetUrl, {
  headers: {
    'Authorization' : Bearer ${accessTokenOfUser}}
  });

const metrics = await apiResp.json();

جایگزین ساده تر برای API توییتر

اگر لیست طولانی مراحل مورد نیاز برای استفاده از API توییتر را پشت سر گذاشته اید ، تبریک می گویم. شما می توانید با استفاده از API در رسانه های اجتماعی Ayrshare ، به طور چشمگیری این کار را کاهش دهید ، در عوض به عنوان جایگزینی برای API توییتر.

ارسال توییت با استفاده از ادغام API ما در توییتر و بسته API NPM اجتماعی به همین راحتی است:

// Install Ayrshare’s Node package: npm i social-media-api
import SocialPost from 'social-media-api';

// 1. Get your API key from https://app.ayrshare.com/api.
// 2. Add it to your application’s environment.
// export AYRSHARE_API_KEY=YOUR-AYRSHARE-API-KEY

const social = new SocialMediaAPI(process.env.AYRSHARE_API_KEY);
const post = social.post({
  "post": "Your tweet",
  "platforms": ["twitter"]
})
.then((json) => console.log(json))
.catch(console.error);

پیش نیازها نیز ساده هستند. فقط برای Ayrshare ثبت نام کنید ، کلید API خود را دریافت کنید ، به حساب های توییتر کاربران خود وصل شوید و شروع به تماس کنید. نیازی به مبارزه با OAUTH ، تنظیمات برنامه ، امنیت شناسایی ، تأیید یا اسناد توییتر نیست.

نمونه های بیشتری را با API در Ayrshare امتحان کنید یا سایر ادغام های ما مانند Python ، Airtable و Bubble را ببینید.

1. توییت با Ayrshare ، Knot and Retrieval

نیازی به استفاده از بسته NPM یا سایر ادغام های ما نیست. تماس با API ما با استفاده از بسته HTTP مورد نظر خود به همان اندازه ساده است! در اینجا مثالی با کمک node-fetch بسته:

const params = {
  'post': 'Your tweet',
  'platforms': ['twitter']
}

const apiResp = await fetch('https://app.ayrshare.com/api/post', {
  method: 'POST',
  headers: {
    'Authorization' : Bearer ${process.env.AYRSHARE_API_KEY},
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(params)
});

const tweet = await apiResp.json();

2. یک موضوع را در توییتر با Ayrshare ، Python و درخواست ارسال کنید

انتشار یک موضوع شماره گذاری شده توییت فقط به دو گزینه اضافی نیاز دارد. Ayrshare به طور خودکار پیام طولانی شما را در توالی شماره گذاری شده توییت می شکند. این را با یک API در توییتر مقایسه کنید ، جایی که باید هر توییت را با جزئیات مربوط به توییت قبلی خود ارسال کنید.

import os
import requests

params = {
  'post': 'Your lengthy essay…',
  'platforms': ['twitter'],
  'twitterOptions': {
    'thread': True,
    'threadNumber': True
  }
}

headers = {
  'Authorization': f'Bearer {os.environ["AYRSHARE_API_KEY"]}',
  'Content-Type': 'application/json'
}

r = requests.post('https://app.ayrshare.com/api/post', 
  json=params, headers=headers)

tweet = r.json()

3 تصویر یا فیلم توییت با استفاده از بسته Python Ayrshare

برای تصاویر و فیلم ها در توییتر کاربر شما انتظار دارد که آنها را در آن بارگذاری کنید /رسانه/بارگذاری یک نقطه پایانیجزئیات آنها را دنبال کنید و آنها را به توییت نقطه پایانیحرف

با استفاده از Ayrshare ، فقط تنظیم کنید mediaUrls گزینه لیستی از پیوندها.

به یاد داشته باشید که برای توییت فیلم ها یا بیش از یک تصویر به یک برنامه حق بیمه ، تجاری یا تجاری نیاز دارید.

اگر سرور برای رسانه خود ندارید ، می توانید آنها را در نقطه پایانی API رسانه ما بارگذاری کنید.

import os

# python -m pip install -U social-post-api
from ayrshare import SocialPost

params = {
  'post': 'Your tweet',
  'platforms': ['twitter'],
  'mediaUrls': ['https://IMAGE–LINK1', 'https://IMAGE-LINK2']
}

social = SocialPost(os.environ["AYRSHARE_API_KEY"])

result = social.post(params)

برای پست های خود تجزیه و تحلیل کنید

چگونه کاربران شما می توانند بدانند که پست ها و تعهدات آنها به خوبی انجام می شود؟ شما می توانید برای پست های آنها شاخص های مفصلی دریافت کرده و داده ها را ارسال کنید:

POST https://app.ayrshare.com/api/analytics/post

برای پاسخ کامل به API Analytics مراجعه کنید.

با ارسال API در توییتر ، حضور آنلاین کاربران خود را افزایش دهید

به عنوان یک بستر قدرتمند رسانه های اجتماعی ، توییتر می تواند از مشتریان شما استفاده کند و تجارت را مدیریت کند. علاوه بر این ، با یادگیری اصول اولیه توییتر و Ayrshare API ، می توانید تعهد خود را بیشتر بهبود بخشید.

برای اطلاعات بیشتر در توییتر ، 7 نکته و ترفند ما را برای ارسال در توییتر و 10 API برتر برای رسانه های اجتماعی برای توسعه دهنده بررسی کنید.

Source link