From 4e0b2c6dc338b1adbd553a14106c709e8c331af5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 18 Jun 2026 20:47:39 +0000 Subject: [PATCH 1/2] docs: add changelog entry for semantic embedding operators --- changelog.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/changelog.mdx b/changelog.mdx index 8ef5fb3e7..8b493c0e8 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -7,6 +7,17 @@ keywords: ["changelog", "API updates", "release notes", "what's new", "API chang To subscribe to updates, please [**“Turn on notifications”**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) for [**@API**](https://x.com/api). + + ### Semantic embedding operators for Filtered Stream + + Today, we added new `embedding:` and `embedding_threshold:` operators to the [Filtered Stream](/x-api/posts/filtered-stream/integrate/operators). These operators use a neural embedding model to match Posts by *semantic similarity* to a natural-language query, rather than requiring exact keyword matches — useful for tracking concepts and topics that are hard to capture with keyword rules alone. + + - `embedding:"query"` — standalone operator that matches Posts semantically similar to the quoted query. + - `embedding_threshold:X.XX` — sets the minimum cosine similarity for a match (0.0–1.0, defaults to `0.3`). Must be paired with another operator. + + Available on Enterprise accounts provisioned with Embedding tier access for Filtered Stream. Contact your account representative to enable. + + ### Articles draft and publish endpoints From f4bbbb863a0d0984287fe3d58a88a74dd39abba0 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 18 Jun 2026 20:50:12 +0000 Subject: [PATCH 2/2] docs: translate embedding operators changelog entry to ja/es/pt/ko --- es/changelog.mdx | 11 +++++++++++ ja/changelog.mdx | 11 +++++++++++ ko/changelog.mdx | 11 +++++++++++ pt/changelog.mdx | 11 +++++++++++ 4 files changed, 44 insertions(+) diff --git a/es/changelog.mdx b/es/changelog.mdx index 96daa5bb1..05deafcea 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -7,6 +7,17 @@ keywords: ["registro de cambios", "actualizaciones de la API", "notas de la vers Para suscribirte a las actualizaciones, [**"Activa las notificaciones"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) para [**@API**](https://x.com/api). + + ### Operadores de embedding semántico para Filtered Stream + + Hoy, agregamos los nuevos operadores `embedding:` y `embedding_threshold:` al [Filtered Stream](/x-api/posts/filtered-stream/integrate/operators). Estos operadores usan un modelo de embeddings neuronal para hacer coincidir Posts por *similitud semántica* con una consulta en lenguaje natural, en lugar de requerir coincidencias exactas de palabras clave — útil para rastrear conceptos y temas difíciles de capturar solo con reglas basadas en palabras clave. + + - `embedding:"query"` — operador independiente que coincide con Posts semánticamente similares a la consulta entre comillas. + - `embedding_threshold:X.XX` — define la similitud de coseno mínima para una coincidencia (0.0–1.0, valor predeterminado `0.3`). Debe combinarse con otro operador. + + Disponible en cuentas Enterprise aprovisionadas con acceso al tier de Embedding para Filtered Stream. Contacta a tu representante de cuenta para habilitarlo. + + ### Endpoints de borrador y publicación de Articles diff --git a/ja/changelog.mdx b/ja/changelog.mdx index 2accc0329..4e0e453cc 100644 --- a/ja/changelog.mdx +++ b/ja/changelog.mdx @@ -7,6 +7,17 @@ keywords: ["変更履歴", "API 更新", "リリースノート", "新着情報" 更新情報の通知を受け取るには、[**@API**](https://x.com/api) の [**「通知をオンにする」**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) を有効にしてください。 + + ### Filtered Stream のセマンティック埋め込み演算子 + + 本日、[Filtered Stream](/x-api/posts/filtered-stream/integrate/operators) に新しい `embedding:` および `embedding_threshold:` 演算子を追加しました。これらの演算子は、ニューラル埋め込みモデルを使用して、完全一致のキーワードではなく自然言語クエリとの*意味的類似性*によって Post をマッチングします。キーワードベースのルールだけでは捉えにくい概念やトピックを追跡するのに有用です。 + + - `embedding:"query"` — 引用符で囲まれたクエリと意味的に類似した Post にマッチするスタンドアロン演算子。 + - `embedding_threshold:X.XX` — マッチに必要なコサイン類似度の最小値を設定します（0.0–1.0、デフォルトは `0.3`）。他の演算子と組み合わせる必要があります。 + + Filtered Stream の Embedding ティアアクセスがプロビジョニングされた Enterprise アカウントで利用可能です。有効化するにはアカウント担当者にお問い合わせください。 + + ### Articles のドラフトおよび公開エンドポイント diff --git a/ko/changelog.mdx b/ko/changelog.mdx index 8a2e3c0b9..a0ebcc4b8 100644 --- a/ko/changelog.mdx +++ b/ko/changelog.mdx @@ -7,6 +7,17 @@ keywords: ["변경 로그", "API 업데이트", "릴리스 노트", "새로운 업데이트를 구독하려면 [**@API**](https://x.com/api)의 [**"알림 켜기"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive)를 활성화하세요. + + ### Filtered Stream을 위한 시맨틱 임베딩 연산자 + + 오늘, [Filtered Stream](/x-api/posts/filtered-stream/integrate/operators)에 새로운 `embedding:` 및 `embedding_threshold:` 연산자를 추가했습니다. 이러한 연산자는 정확한 키워드 일치를 요구하는 대신, 신경망 임베딩 모델을 사용해 자연어 쿼리와의 *시맨틱 유사도*로 Post를 매칭합니다. 키워드 기반 규칙만으로는 포착하기 어려운 개념과 주제를 추적하는 데 유용합니다. + + - `embedding:"query"` — 따옴표로 묶인 쿼리와 시맨틱적으로 유사한 Post를 매칭하는 독립형 연산자. + - `embedding_threshold:X.XX` — 매칭에 필요한 최소 코사인 유사도를 설정합니다(0.0–1.0, 기본값 `0.3`). 다른 연산자와 함께 사용해야 합니다. + + Filtered Stream용 Embedding 티어 액세스가 프로비저닝된 Enterprise 계정에서 사용할 수 있습니다. 활성화하려면 계정 담당자에게 문의하세요. + + ### Articles 초안 작성 및 게시 엔드포인트 diff --git a/pt/changelog.mdx b/pt/changelog.mdx index 278c54b65..6d37091e7 100644 --- a/pt/changelog.mdx +++ b/pt/changelog.mdx @@ -7,6 +7,17 @@ keywords: ["registro de alterações", "atualizações da API", "notas de versã Para se inscrever para receber atualizações, [**"Ative as notificações"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) para [**@API**](https://x.com/api). + + ### Operadores de embedding semântico para o Filtered Stream + + Hoje, adicionamos os novos operadores `embedding:` e `embedding_threshold:` ao [Filtered Stream](/x-api/posts/filtered-stream/integrate/operators). Esses operadores usam um modelo de embeddings neural para corresponder Posts por *similaridade semântica* a uma consulta em linguagem natural, em vez de exigir correspondências exatas de palavras-chave — útil para acompanhar conceitos e temas difíceis de capturar apenas com regras baseadas em palavras-chave. + + - `embedding:"query"` — operador independente que corresponde a Posts semanticamente similares à consulta entre aspas. + - `embedding_threshold:X.XX` — define a similaridade de cosseno mínima para uma correspondência (0.0–1.0, valor padrão `0.3`). Deve ser combinado com outro operador. + + Disponível em contas Enterprise provisionadas com acesso ao tier de Embedding para o Filtered Stream. Entre em contato com seu representante de conta para habilitar. + + ### Endpoints de rascunho e publicação de Articles