Премини към основното съдържание
Български— Изберете език
Меню

X Search за маркетинг: потребителски имена, дати и филтри

Урок 1 от 12 Обновен 30 юли 2026 г. Средно
На тази страница
  1. Превърнете X в инструмент за маркетингов мониторинг
  2. Активиране на X Search в Grok API
  3. Филтриране по потребителски имена: Насочване към конкретни акаунти
  4. Филтриране по дати: Изолиране на период
  5. Разбиране на изображения и видеоклипове в публикациите
  6. Практическа задача: Скрипт за седмичен мониторинг
  7. Ключови изводи

Превърнете X в инструмент за маркетингов мониторинг

X (предишно име Twitter) остава една от най-богатите платформи за получаване на приложими маркетингови данни в реално време. С помощта на инструмента x_search в Grok API можете да заявявате този масив от информация по структуриран, филтриран и автоматизируем начин, директно от Вашите приложения или скриптове.

За разлика от ръчното търсене в X, API Ви позволява да насочвате точно към конкретни акаунти, периоди и теми. За маркетинг мениджъра това означава преминаване от занаятчийски мониторинг към програмируема система за събиране на конкурентно разузнаване.

$5
на 1000 заявки
10
филтрируеми потребителски имена
ISO
формат на датата
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, който е остарял за търсене)