X Search за маркетинг: потребителски имена, дати и филтри
На тази страница
- Превърнете X в инструмент за маркетингов мониторинг
- Активиране на X Search в Grok API
- Филтриране по потребителски имена: Насочване към конкретни акаунти
- Филтриране по дати: Изолиране на период
- Разбиране на изображения и видеоклипове в публикациите
- Практическа задача: Скрипт за седмичен мониторинг
- Ключови изводи
Превърнете X в инструмент за маркетингов мониторинг
X (предишно име Twitter) остава една от най-богатите платформи за получаване на приложими маркетингови данни в реално време. С помощта на инструмента x_search в Grok API можете да заявявате този масив от информация по структуриран, филтриран и автоматизируем начин, директно от Вашите приложения или скриптове.
За разлика от ръчното търсене в X, API Ви позволява да насочвате точно към конкретни акаунти, периоди и теми. За маркетинг мениджъра това означава преминаване от занаятчийски мониторинг към програмируема система за събиране на конкурентно разузнаване.
Активиране на X Search в Grok API
Активирате инструмента x_search, като го декларирате в масива tools на Вашата API заявка. Той работи изключително с Responses API (старият крайна точка Chat Completions е остарял за търсене).
from openai import OpenAI
client = OpenAI(
api_key="your-xai-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest posts from @nike about their marketing campaigns?",
tools=[{"type": "x_search"}]
)
Моделът автоматично решава кога да стартира търсене в X въз основа на Вашия въпрос. Не е необходимо да управлявате задействането ръчно.
Филтриране по потребителски имена: Насочване към конкретни акаунти
Параметърът allowed_x_handles Ви позволява да ограничите търсенето до максимум 10 конкретни X акаунта. Това е идеалният инструмент за мониторинг на преки конкуренти или партньори.
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Summarize the product announcements from these brands this week",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"nike", "adidas", "puma",
"newbalance", "reebok"
]
}]
)
Обратно, excluded_x_handles Ви позволява да изключите до 10 акаунта от резултатите. Забележка: тези два параметъра са взаимно изключващи се (не можете да ги комбинирате в една и съща заявка).
Маркетингови случаи на употреба
- Конкурентен мониторинг: проследявайте 5–10 акаунта на преки конкуренти
- Партньорства: следете публикациите на Вашите партньори и посланици
- Екосистема: изключете собствените си акаунти, за да виждате само пазара
Филтриране по дати: Изолиране на период
Параметрите from_date и to_date приемат дати във формат ISO 8601 (ГГГГ-ММ-ДД). Това Ви позволява да насочите конкретна кампания, секторно събитие или да сравните два периода.
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze reactions to the Black Friday campaign from these brands",
tools=[{
"type": "x_search",
"allowed_x_handles": ["amazon_fr", "cdiscount", "fnac"],
"from_date": "2025-11-25",
"to_date": "2025-12-02"
}]
)
Тази комбинация от потребителски имена и дати Ви осигурява изключително прецизен обхват на търсене, сравним с автоматизирано задание за пазарно проучване.
Разбиране на изображения и видеоклипове в публикациите
Два булеви параметъра обогатяват Вашия визуален мониторинг:
enable_image_understanding: моделът анализира изображенията, съдържащи се в публикациите (визуални елементи на кампании, инфографики, екранни снимки)enable_video_understanding: моделът интерпретира видеоклипове (рекламни клипове, тийзъри на продукти, демонстрации)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
За маркетолога това означава, че Grok може да опише рекламните визуални елементи на конкурентите, да идентифицира използваните цветови кодове или да обобщи съдържанието на промоционално видео, всичко това програмно.
Практическа задача: Скрипт за седмичен мониторинг
Ето пълен скрипт, който генерира седмичен отчет за мониторинг на Вашите конкуренти:
from datetime import datetime, timedelta
# Изчисляване на изминалата седмица
today = datetime.now().strftime("%Y-%m-%d")
last_week = (datetime.now() - timedelta(days=7)).strftime("%Y-%m-%d")
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="""Analyze these brands' posts from the last week.
For each brand, identify:
1. Major product announcements
2. Marketing campaigns launched
3. Tone and positioning used
4. Posts that generated the most engagement""",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"concurrent1", "concurrent2", "concurrent3"
],
"from_date": last_week,
"to_date": today,
"enable_image_understanding": True
}]
)
print(response.output_text)
Ключови изводи
- X Search струва $5 на 1000 заявки, което го прави много достъпен инструмент за мониторинг
- Можете да филтрирате по потребителски имена (макс. 10) или дати (формат ISO 8601), или да комбинирате и двете
allowed_x_handlesиexcluded_x_handlesса взаимно изключващи се- Анализът на изображения и видеоклипове в публикациите е ексклузивен за X Search (не е наличен при Web Search)
- Използвайте Responses API (не Chat Completions, който е остарял за търсене)