Google Trends API، ابزار جدید گوگل برای استخراج ترندهای جستجو

---

مشخصات کلی Google Trends API (نسخه آلفا)

ویژگی	توضیحات
نوع محصول	API (رابط برنامه نویسی کاربردی)
داده‌های موجود	داده‌های علاقه جستجو (Search Interest)
بازه زمانی داده‌ها	پنج سال گذشته (پنجره زمانی چرخشی ۱۸۰۰ روزه)
تازگی داده‌ها	اطلاعات تا ۴۸ ساعت قبل در دسترس هستند.
مقیاس‌بندی داده‌ها	مقیاس‌بندی ثابت (Consistently Scaled) که امکان مقایسه بین درخواست‌های مختلف رو میده.
تفکیک زمانی (Aggregation)	روزانه، هفتگی، ماهانه و سالانه
تفکیک جغرافیایی	کشور، ایالت، شهر (منطقه و زیرمنطقه بر اساس استاندارد ISO 3166-2)
محدودیت	داده‌های بخش «جستجوهای داغ» یا Trending Now در این API وجود نداره.
وضعیت فعلی	نسخه آلفا (در حال تست)
ارائه‌دهندگان	Daniel Waisberg و Hadas Jacobi از تیم گوگل ترندز
محل رونمایی	Google Search Central Live, Deep Dive APAC 2025

---

داستان از چه قراره؟ گوگل یه API برای ترندز داده بیرون

گوگل به تازگی توی رویداد Google Search Central Live, Deep Dive APAC 2025 از یه نسخه آلفا یا آزمایشی برای API گوگل ترندز رونمایی کرده. اگه نمیدونی API چیه، بذار ساده بگم: یه راهی هست که برنامه‌ها و نرم‌افزارهای مختلف میتونن مستقیم با داده‌های گوگل ترندز حرف بزنن و اطلاعات بگیرن، بدون اینکه لازم باشه بری توی سایت گوگل ترندز و دستی چیزی رو جستجو کنی. یعنی میتونی داده‌های صفحه «اکسپلور» گوگل ترندز رو مستقیم بیاری توی اپلیکیشن یا ابزار خودت.

این خبر رو دو نفر از اعضای تیم گوگل به اسم‌های دنیل وایزبرگ (Daniel Waisberg) و هداس جاکوبی (Hadas Jacobi) اعلام کردن. اونها گفتن که این نسخه آلفا از همین امروز در دسترسه و دنبال توسعه‌دهنده‌ها و افرادی میگردن که حاضر باشن این ابزار رو در طول سال ۲۰۲۵ تست کنن و به گوگل بازخورد بدن. یه نکته مهم اینه که این API قرار نیست داده‌های بخش «جستجوهای داغ» یا همون Trending Now رو شامل بشه.

این API به درد کیا میخوره؟

گوگل ترندز سال‌هاست که وجود داره و همه از طریق وب‌سایتش به داده‌ها دسترسی داشتن. اما درخواست‌ها برای یه API که بشه به صورت مقیاس‌پذیر از این داده‌ها استفاده کرد، خیلی زیاد شده بود. گوگل بر اساس تحقیقات اولیه‌ای که انجام داده، چند تا گروه اصلی رو شناسایی کرده که این API میتونه حسابی به دردشون بخوره:

• محقق‌ها: توسعه‌دهنده‌ها و پژوهشگرها میتونن از این داده‌ها استفاده کنن تا روی تخصیص منابع عمومی و اولویت‌های تحقیقات علمی تاثیر بذارن.
• ناشرها و روزنامه‌نگارها: اونها میتونن موضوعات مختلف رو دنبال کنن، ترندهای جدید رو پیدا کنن و با استفاده از این داده‌ها، داستان‌های جذابی درباره مسائل مهم روز تعریف کنن.
• کسب‌وکارها، سئوکارها و بازاریاب‌ها: این گروه میتونن برای سرمایه‌گذاری روی منابعشون بهتر اولویت‌بندی کنن و استراتژی محتوای بهتری برای کسب‌وکارشون طراحی کنن.

ویژگی‌های اصلی این API چی هستن؟

بیا با هم دقیق‌تر ببینیم این ابزار جدید گوگل چه قابلیت‌های کلیدی‌ای داره.

۱. مقیاس‌بندی ثابت داده‌ها؛ یه قابلیت خیلی مهم

مهم‌ترین و برجسته‌ترین ویژگی این نسخه آلفا، «مقیاس‌بندی ثابت» یا Consistently Scaled Search Interest هست.

اگه تا حالا با وب‌سایت گوگل ترندز کار کرده باشی، میدونی که وقتی چند تا کلمه رو با هم مقایسه میکنی، گوگل بهت یه نمودار با اعداد بین ۰ تا ۱۰۰ نشون میده. مشکل اینجاست که این اعداد هر بار بر اساس ترکیبی از کلماتی که جستجو کردی، دوباره محاسبه و مقیاس‌بندی میشن. یعنی اگه یه کلمه جدید به مقایسه‌ات اضافه کنی، اعداد قبلی هم ممکنه تغییر کنن.

اما توی این API قضیه فرق میکنه. مقادیر و اعدادی که API برمیگردونه، در تمام درخواست‌ها ثابت باقی میمونن. این یعنی شما میتونی داده‌های چند تا درخواست مختلف رو با هم ترکیب، مقایسه و ادغام کنی. مثلا میتونی جستجوی کلمه «هوش مصنوعی» رو امروز بگیری و هفته بعد دوباره همون رو بگیری و این دو تا عدد رو با هم مقایسه کنی، چون مقیاسشون یکسانه.

البته حواست باشه که این اعداد، حجم جستجوی کامل یا مطلق نیستن. اونها فقط «میزان علاقه به جستجو» یا «search interest» رو نشون میدن. با این حال، توی نمونه پاسخی که گوگل نشون داده، یه عدد به عنوان حجم جستجوی حدودی (indicative search volume) هم کنار عدد مقیاس‌بندی شده قرار گرفته تا بشه با چیزی که توی وب‌سایت گوگل ترندز میبینی، مقایسه‌اش کرد.

مزیت بزرگ این روش اینه که دیگه لازم نیست برای مانیتور کردن یک کلمه در طول زمان، هر بار کل بازه زمانی رو از اول بگیری. توی وب‌سایت، مجبور بودی هر دفعه کل تاریخچه رو دانلود کنی تا مقیاس ۰ تا ۱۰۰ درست بمونه. اما با API، فقط داده‌های دوره جدید رو میگیری و به داده‌های قبلی اضافه میکنی. همچنین، در حالی که وب‌سایت فقط اجازه مقایسه ۵ کلمه رو میده، با API میشه ده‌ها کلمه رو خیلی راحت‌تر با هم مقایسه کرد.

۲. پنجره زمانی پنج ساله

این API داده‌های مربوط به یک پنجره زمانی چرخشی ۱۸۰۰ روزه (یعنی تقریبا پنج سال) رو در اختیارت میذاره. دلیل انتخاب این بازه زمانی اینه که تحلیل‌های گوگل نشون داده بیشتر افراد تحلیل‌هاشون رو در همین بازه ۵ ساله انجام میدن. درسته که خیلی از کاربردها مربوط به ۱۲ ماه گذشته هستن، اما گوگل معتقده که بازه ۵ ساله برای محقق‌ها و روزنامه‌نگارها خیلی مهمه تا بتونن به رویدادهای مهمی مثل انتخابات‌های قبلی (که معمولا هر ۴ سال یک بار هستن) یا رویدادهای ورزشی مثل المپیک و جام جهانی نگاه کنن.

یه نکته جالب دیگه اینه که داده‌ها تا ۴۸ ساعت قبل در دسترس هستن. این تاخیر عمدی هست تا الگوهای زمانی، مثل رویدادهای سالانه یا چرخه‌های هفتگی، حفظ بشن و تحلیل‌ها دقیق‌تر باشن. این زمینه طولانی‌تر بهت کمک میکنه تا جهش‌های جستجوی امروزی رو با سال‌های قبل مقایسه کنی و ترندهای فصلی و چرخه‌های خبری تکراری رو بهتر تشخیص بدی.

۳. دسته‌بندی انعطاف‌پذیر و تفکیک جغرافیایی

شما میتونی انتخاب کنی که داده‌ها چطور دسته‌بندی یا جمع‌بندی (aggregate) بشن: هفتگی، ماهانه یا سالانه. علاوه بر اینها، دسته‌بندی روزانه هم ارائه میشه. این انعطاف‌پذیری بهت اجازه میده هم برای تحلیل‌های خیلی دقیق روی جزئیات زوم کنی و هم برای دیدن ترندهای بلندمدت، یه قدم به عقب برگردی و تصویر بزرگ‌تر رو ببینی. چون کاربردها خیلی متنوع هستن و ممکنه توسعه‌دهنده‌ها بخوان این داده‌ها رو با گزارش‌های دیگه خودشون ترکیب کنن، گوگل هر چهار گزینه (روزانه، هفتگی، ماهانه، سالانه) رو فراهم کرده تا دستشون برای کار با داده‌ها باز باشه.

علاوه بر این، تفکیک‌های منطقه‌ای و زیرمنطقه‌ای هم از طریق API در دسترس هستن. یعنی میتونی میزان علاقه به یک موضوع رو در سطح کشورها، ایالت‌ها یا حتی شهرها بدون هیچ کار اضافه‌ای مشخص کنی. این تفکیک جغرافیایی بر اساس استاندارد ISO 3166-2 انجام میشه.

یه نمونه درخواست و پاسخ API

هداس جاکوبی توی معرفیش یه مثال از نحوه ارسال درخواست با زبان برنامه‌نویسی پایتون و نمونه پاسخی که از API دریافت میشه رو به اشتراک گذاشت. بیا با هم ببینیمش:

نمونه درخواست (Request):

from googleapiclient.discovery import build

service = build("searchtrends", "v1alpha", API_KEY, credentials)

request = {
    "geo": {"type": "GEO_TYPE_COUNTRY", "code": "US"},
    "expression": "world cup",
    "time_range": {
        "start_time": "2024-01-01",
        "end_time": "2024-12-31",
    },
    "time_resolution": "WEEK",
}

operation = service.fetchTimeSeries(body=request).execute()

<go get coffee...>

time_series = service.getOperation(operation.id)

نمونه پاسخ (Response):

بعد از ارسال درخواست، پاسخی که از سرور گوگل برمیگرده یه چیزی شبیه به اینه:

{
  "points": [
    {
      "time_range": {
        "start_time": (2024-01-01),
        "end_time": (2024-01-07),
      },
      "search_interest": 4400.0,
      "scaled_search_interest": 62,
    },
    {
      "time_range": {
        "start_time": (2024-01-08),
        "end_time": (2024-01-14),
      },
      "search_interest": 7100.0,
      "scaled_search_interest": 100,
    },
    …
  ]
}

بذار این پاسخ رو برات باز کنم:

• "points": یه لیستی از نقاط داده رو نشون میده. هر نقطه مربوط به یک بازه زمانیه.
• "time_range": مشخص میکنه که این داده برای چه بازه زمانی هست. مثلا از اول ژانویه ۲۰۲۴ تا هفتم ژانویه ۲۰۲۴.
• "search_interest": این همون عدد حجم جستجوی حدودی هست که گفتم. مثلا در هفته اول ژانویه، میزان علاقه جستجو ۴۴۰۰ بوده.
• "scaled_search_interest": این همون عدد مقیاس‌بندی شده ثابته که بین ۰ تا ۱۰۰ هست. اینجا برای هفته اول ۶۲ و برای هفته دوم که اوج جستجو بوده، ۱۰۰ در نظر گرفته شده.

سوالات پرتکرار درباره داده‌های گوگل ترندز

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

چطور یه نمونه از جستجوها میتونه نماینده کل جستجوها باشه؟

درسته که گوگل ترندز فقط از یه نمونه از جستجوهای گوگل استفاده میکنه، اما این کافیه چون روزانه میلیاردها جستجو در گوگل انجام میشه. ارائه دسترسی به کل مجموعه داده‌ها اونقدر حجمش زیاده که پردازش سریعش غیرممکنه. با نمونه‌برداری از داده‌ها، گوگل میتونه به مجموعه‌ای نگاه کنه که نماینده کل جستجوهای گوگل هست و همزمان، اطلاعاتی رو پیدا کنه که چند دقیقه بعد از وقوع یه رویداد در دنیای واقعی، قابل پردازش باشن.

داده‌های گوگل ترندز چطور نرمال‌سازی میشن؟

گوگل ترندز داده‌های جستجو رو نرمال‌سازی میکنه تا مقایسه بین کلمات مختلف راحت‌تر بشه. این فرآیند به این شکله:

1. هر نقطه داده بر کل جستجوهای اون منطقه جغرافیایی و بازه زمانی تقسیم میشه تا محبوبیت نسبی مشخص بشه. وگرنه، جاهایی که حجم جستجوی بیشتری دارن همیشه رتبه بالاتری میگرفتن.
2. اعداد به دست اومده بعدش بر اساس نسبت یک موضوع به کل جستجوها در همه موضوعات، روی یه مقیاس از ۰ تا ۱۰۰ قرار میگیرن.
3. مناطق مختلفی که علاقه جستجوی یکسانی برای یه کلمه نشون میدن، لزوما حجم جستجوی کل یکسانی ندارن.

چه جستجوهایی در گوگل ترندز لحاظ میشن؟

داده‌های گوگل ترندز جستجوهایی رو نشون میدن که مردم هر روز در گوگل انجام میدن، اما میتونه فعالیت‌های جستجوی غیرعادی مثل جستجوهای خودکار یا کوئری‌هایی که ممکنه برای اسپم کردن نتایج جستجو استفاده بشن رو هم منعکس کنه.

با اینکه گوگل مکانیزم‌هایی برای شناسایی و فیلتر کردن فعالیت‌های غیرعادی داره، اما این جستجوها ممکنه به عنوان یه اقدام امنیتی در گوگل ترندز باقی بمونن. دلیلش اینه که اگه این جستجوها از ترندز فیلتر بشن، به اونهایی که این کوئری‌ها رو میفرستن کمک میکنه تا بفهمن گوگل شناساییشون کرده. این کار باعث میشه فیلتر کردن این فعالیت‌ها در بقیه محصولات جستجوی گوگل که داده‌های جستجوی دقیق در اونها حیاتیه، سخت‌تر بشه. بنابراین، اونایی که به داده‌های گوگل ترندز تکیه میکنن باید بدونن که این داده‌ها آینه کاملی از فعالیت جستجو نیست.

با این حال، گوگل ترندز بعضی از انواع جستجوها رو فیلتر میکنه:

• جستجوهایی که توسط افراد خیلی کمی انجام شدن: ترندز فقط داده‌های کلمات محبوب رو نشون میده، پس کلماتی که حجم جستجوی پایینی دارن به صورت «۰» نشون داده میشن.
• جستجوهای تکراری: ترندز جستجوهای تکراری از یک شخص در یک بازه زمانی کوتاه رو حذف میکنه.
• کاراکترهای خاص: ترندز کوئری‌هایی که آپاستروف و کاراکترهای خاص دیگه دارن رو فیلتر میکنه.

آیا گوگل ترندز همون داده نظرسنجیه؟

نه. گوگل ترندز یه نظرسنجی علمی نیست و نباید با داده‌های نظرسنجی اشتباه گرفته بشه. این ابزار صرفا علاقه به جستجو در موضوعات خاص رو نشون میده. یه جهش ناگهانی در یه موضوع به این معنی نیست که اون موضوع به نوعی «محبوب» یا «برنده» شده، فقط نشون میده که به دلایل نامشخص، به نظر میرسه کاربرهای زیادی دارن درباره اون موضوع جستجو میکنن. داده‌های گوگل ترندز همیشه باید به عنوان یک نقطه داده در کنار بقیه داده‌ها در نظر گرفته بشن، قبل از اینکه به نتیجه‌گیری برسیم.

گوگل ترندز با Autocomplete چه فرقی داره؟

Autocomplete یا تکمیل خودکار، یه ویژگی توی جستجوی گوگله که برای سریع‌تر کردن تکمیل جستجوهایی که شروع به تایپشون کردی، طراحی شده. پیش‌بینی‌ها از جستجوهای واقعی که در گوگل اتفاق میفتن میان و جستجوهای رایج و ترند مرتبط با کاراکترهایی که وارد کردی و همچنین موقعیت مکانی و جستجوهای قبلی تو رو نشون میدن. برخلاف گوگل ترندز، Autocomplete تابع سیاست‌های حذف گوگل و همچنین فیلترهای الگوریتمی هست که برای گرفتن پیش‌بینی‌های ناقض سیاست‌ها و نشون ندادن اونها طراحی شده. به همین دلیل، نباید Autocomplete رو همیشه به عنوان منعکس کننده محبوب‌ترین کلمات جستجو شده مرتبط با یه موضوع در نظر گرفت.

گوگل ترندز با داده‌های جستجوی AdWords چه فرقی داره؟

گزارش کلمات جستجوی AdWords برای درک حجم جستجوی ماهانه و میانگین، به طور خاص برای تبلیغ‌دهنده‌ها طراحی شده، در حالی که گوگل ترندز برای کندوکاو عمیق‌تر در داده‌های جزئی‌تر و در لحظه (real-time) ساخته شده.

چه منطقه زمانی برای داده‌های نمودارها استفاده میشه؟

منطقه زمانی که در نمودارهای صفحه اکسپلور گوگل ترندز استفاده میشه، به طول بازه زمانی که مشاهده میکنی بستگی داره:

• برای بازه‌های زمانی ۳۰ روز یا بیشتر: داده‌های نشون داده شده در نمودار از زمان هماهنگ جهانی (UTC) استفاده میکنن. این برای وقتیه که جزئیات داده‌ها روزانه، هفتگی یا ماهانه باشه. استفاده از UTC یه استاندارد جهانی ثابت فراهم میکنه و مقایسه ترندهای بلندمدت در مناطق مختلف رو بدون پیچیدگی‌های مناطق زمانی محلی یا تغییرات ساعت تابستانی، آسون میکنه.
• برای بازه‌های زمانی ۷ روز یا کمتر: داده‌های نشون داده شده در نمودار از منطقه زمانی محلی خودت که در مرورگر یا دستگاهت تنظیم شده، استفاده میکنن. این معمولا برای وقتیه که جزئیات داده‌ها کمتر از یک روزه، مثل داده‌های ساعتی. استفاده از زمان محلی باعث میشه نوسانات ساعتی یا در لحظه رو به راحتی درک کنی و به رویدادهای برنامه روزانه یا منطقه خودت ربط بدی.

چطوری میشه این API رو تست کرد؟

همونطور که گفتم، این API فعلا در مرحله تست آلفا هست. گوگل میخواد عملکردش رو بررسی کنه و از یه گروه محدود از توسعه‌دهنده‌ها بازخورد بگیره تا محصول نهایی رو بهتر کنه. از اونجایی که هنوز نمیتونن API رو برای همه باز کنن، اولویت با توسعه‌دهنده‌هایی هست که میدونن میخوان باهاش چیکار کنن، میتونن زود شروع به کار کنن و مایل به ارائه بازخورد هستن.

اگه شما هم یه ایده مشخص برای استفاده از این API داری و میتونی به گوگل بازخورد بدی، میتونی از طریق فرمی که گوگل ارائه کرده برای تبدیل شدن به یه تستر آلفا درخواست بدی. گوگل دسترسی رو به صورت تدریجی طی هفته‌های آینده برای تعداد محدودی از توسعه‌دهنده‌ها باز میکنه. اگه توی اولین گروه نبودی، جای نگرانی نیست چون طی ماه‌های آینده دسترسی رو بیشتر میکنن.

منابع

• Google Trends API (Alpha) Launching: Breaking News From Search Central Live
• Introducing the Google Trends API (alpha): a new way to access Search Trends data | Google Search Central Blog | Google for Developers
• Google Trends API Alpha | Google Search Central | Documentation | Google for Developers
• FAQ about Google Trends data – Trends Help