Начало работы

Gemlead API

Горячие лиды, которых Gemlead находит в X, прямо в ваших инструментах. REST API, подписанные вебхуки и MCP-сервер для ИИ-ассистентов, и всё это на одном ключе.

Перед началом

API и MCP-сервер входят в тарифы Business и Enterprise, включая пробный период. Все эндпоинты находятся по адресу https://gemlead.ai/api/v1, принимают и возвращают JSON с полями в snake_case, а все даты и время записывают в ISO 8601 по UTC.

Базовый URL

https://gemlead.ai/api/v1

Получите API-ключ

В Gemlead откройте API в меню. Выберите аккаунт X, для которого нужен ключ, дайте ключу имя и выберите права доступа, только read или read и write.

Ключ начинается с gl_live_ и показывается один раз, поэтому сразу сохраните его в менеджере секретов или в переменной окружения. Ключ принадлежит одному аккаунту X и видит только его данные.

Терминал

export GEMLEAD_API_KEY="gl_live_..."

Отправьте первый запрос

Проверьте ключ запросом Получение аккаунта. Каждый запрос передаёт ключ в заголовке Authorization как bearer-токен.

В ответе придёт аккаунт X, которому принадлежит ключ, и его тариф.

GET/v1/account

curl https://gemlead.ai/api/v1/account \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"

Ответ200

{
  "object": "account",
  "id": "a9PzK2vRtM",
  "username": "acme",
  "name": "Acme",
  "profile_image_url": "https://pbs.twimg.com/profile_images/1180044592/acme_400x400.jpg",
  "plan": "business"
}

Получите список горячих лидов

Лид становится горячим, когда Dana AI ставит ему оценку 60 или выше. Запросите самых свежих с hot=true и добавьте persona, score_min или дату, чтобы сузить список.

Списки приходят постранично. Переходите по next_cursor, пока has_more равно true, как показано в разделе Пагинация.

GET/v1/leads

curl -G https://gemlead.ai/api/v1/leads \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -d hot=true \
  -d limit=10

Ответ200

{
  "object": "list",
  "data": [
    {
      "id": "msgOtJ8dvT",
      "object": "lead",
      "profile": {
        "x_user_id": "1460283925",
        "username": "jane_builds",
        "name": "Jane Doe",
        "bio": "Runs a paid trading community. Daily setups, no hype.",
        "followers_count": 12400,
        "following_count": 380,
        "location": "Austin, TX",
        "website": "https://janedoe.com",
        "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
        "verified": true,
        "url": "https://x.com/jane_builds"
      },
      "score": 86,
      "score_reason": "Runs a paid trading community and asks how to collect payments for it.",
      "hot": true,
      "status": "scored",
      "persona": {
        "id": "lvWBPnytpS",
        "name": "Tipsters"
      },
      "campaign": null,
      "conversation_id": null,
      "locked_to": null,
      "found_at": "2026-11-05T14:02:11.482Z",
      "scored_at": "2026-11-05T14:03:40.117Z",
      "updated_at": "2026-11-05T14:03:40.117Z",
      "metadata": {}
    }
  ],
  "has_more": true,
  "next_cursor": "eyJzIjoiMjAyNi0xMS0wNVQxNDowMzo0MC4xMTdaIn0"
}

Примите первый вебхук

Вебхуки отправляют события на ваш сервер в момент, когда они происходят, и опрашивать API не нужно. Зарегистрируйте публичный HTTPS URL для lead.hot и reply.received, сохраните secret из ответа и отправьте себе тестовое событие. lead.created присылает каждого нового лида, горячего или нет.

Проверяйте каждый запрос по заголовку Gemlead-Signature, как описано в разделе Проверка подписи. Эндпоинт можно добавить и в приложении, в разделе API.

POST/v1/webhook_endpoints

curl -X POST https://gemlead.ai/api/v1/webhook_endpoints \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/gemlead",
    "events": ["lead.hot", "reply.received"],
    "description": "CRM sync",
    "filters": {
      "persona_ids": ["lvWBPnytpS"]
    }
  }'

POST/v1/webhook_endpoints/:id/test

curl -X POST \
  https://gemlead.ai/api/v1/webhook_endpoints/wh3LpX9dKe/test \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"

Подключите ИИ-ассистента

MCP-сервер Gemlead по адресу https://gemlead.ai/mcp позволяет Claude, ChatGPT и Cursor искать ваших лидов, читать ваши диалоги и запускать кампании прямо в чате.

В Claude Code сервер подключается одной командой с вашим ключом. Для остальных клиентов смотрите раздел Подключение MCP.

Claude Code

claude mcp add --transport http gemlead https://gemlead.ai/mcp \
  --header "Authorization: Bearer $GEMLEAD_API_KEY"

Что дальше

АутентификацияКлючи, права доступа и защита ключей.ЛидыВсе фильтры списка лидов и объект лида.ВебхукиСобытия и их данные, подписи и повторные отправки.MCP-серверНастройка Claude, ChatGPT, Cursor и Claude Code.