X Search 公開版本 0.1.30 接受 queries（1 至 20 個）、searchMode（latest、top、photos、videos）、maxItemsPerQuery（1 至 1000），以及選填的 startTime 和 endTime 日期字串。將整份已儲存、包含 2 個查詢的清單，替換為 1 個你要使用的查詢及日期範圍。首次進行限定範圍的核查時，將 maxItemsPerQuery 設為 2，searchMode 設為 latest。只使用 1 組原生 startTime 和 endTime，不要在查詢內重複加入 since 或 until 篩選條件，也不要加入憑空設想的 expansion、includeReplies 或 page 輸入欄位。
目前的對照測試輸入使用 from:OpenAI，startTime 為 2026-07-07，endTime 為 2026-07-09，由此產生實際執行的查詢 from:OpenAI since:2026-07-07 until:2026-07-10。位於第 2 及第 3 位的 2 筆 7 月 9 日回覆資料列，其作者 ID 及 UTC createdAt 值均正確；此外，outsideTimeRange 彙總計數顯示排除了 1 筆資料，但沒有列出被排除的 ID。這證明了已核查的工作流程有效，並不代表已驗證所有搜尋運算子，或涵蓋完整歷史資料。
工具使用的原生欄位包括 inputQuery、executedQuery、searchMode、resultPosition、postId、postUrl、text、createdAt、authorId、authorHandle、authorUrl、isReply、isQuote、isRepost 及 observedAt。輸出的 searchMode 使用首字母大寫的 Latest，而輸入的列舉值則為小寫。資料集的資料列沒有狀態欄位。
限定日期範圍搜尋的操作步驟
- 執行任何指令碼前，先寫下你要搜尋的詞句及日期範圍。初步核查時，將 maxItemsPerQuery 維持在較低數值，並將 searchMode 設為 latest。
- 將範例查詢清單替換為單一查詢字串，將項目上限設為兩項，並使用原生 startTime 和 endTime 字串。不要在查詢字串內重複加入 since 或 until 條件。
- 同時儲存 inputQuery 和 executedQuery 字串。例如，結束日期為 7 月 9 日的請求，會產生不包含 7 月 10 日的上限，例如 until:2026-07-10。
- 解析原生 createdAt 時間戳記，並對照明確指定的 UTC 時間區間進行核查。畫面上只有日期的標示，除非經過轉換，否則不會自行採用本地時區。
- 缺少時間戳記的資料須保留為未能判定，不要猜測。createdAt 欄位為空時，不能改用 observedAt 來判定其時間排序，因為 observedAt 只記錄收集時間。
- 核查作者 ID、帳號名稱，以及回覆、引用或轉發等帖文類型。某位作者發出的帖文仍可能是回覆，未必是獨立的原創帖文。
- 檢查 OUTPUT 的頂層欄位，例如 searchesQueued、searchesStarted、rowsSaved、outsideTimeRange、statusCounts 及 stopReason，同時檢查 queries 陣列內的 inputQuery、executedQuery、status、rowsSaved、outsideTimeRange 及 stopReason。頂層的 queries_exhausted 表示佇列處理已結束，並不表示已找盡所有符合條件的來源帖文；每個查詢的 max_items_per_query 則表示樣本已達到該查詢的數量上限。失敗、沒有結果及達到上限的結果須分開保留。你必須保留來源位置編號中的缺口，不要為已收集的資料列重新排序編號。
- 交付附日期的資料明細，並附上輸入設定紀錄及排除計數。不要假設小量樣本能代表整個平台上的出現頻率或過往受歡迎程度。
原創虛構 UTC 邊界核查範例
下表是原創虛構的測試案例，用於測試 10 月 1 日至 10 月 4 日區間的 UTC 日期邊界。UTC 即協調世界時；半開區間包含開始時間，但不包含上限時間。按照已核查、只指定日期的處理慣例，要求包含 10 月 1 日至 3 日的日期範圍，對應的開始時間為 10 月 1 日 00:00 UTC，不包含在範圍內的上限時間則為 10 月 4 日 00:00 UTC。原生輸入所要求的 endTime 為 10 月 3 日，產生的 until 則為 10 月 4 日，兩者須分開保留。這是供讀者核查的測試案例，並非來自 Actor 對照測試的即時數據。
| 帖文 ID | 建立時間（UTC） | 觀測時間 | 是否在日期範圍內 |
|---|---|---|---|
| CandidateP1 | 2026-10-01 00:00:00 | 2026-10-01 01:00:00 | 範圍內 |
| CandidateP2 | 2026-10-03 23:59:59 | 2026-10-04 00:00:00 | 範圍內 |
| CandidateP3 | 2026-10-04 00:00:00 | 2026-10-04 01:00:00 | 範圍外 |
| CandidateP4 | null | 2026-10-03 12:00:00 | 未能判定 |
此測試案例有 2 筆位於範圍內的資料列、1 筆位於範圍外的資料列，以及 1 筆建立日期為 null、未能判定的資料列。收集到的樣本可能遺漏較早的帖文，因此某篇帖文沒有出現在樣本中，只表示樣本未有觀測到該帖文，並不表示 X 上沒有該帖文。
來源與延伸閱讀
作者 Chronometrica · 更新日期
返回頂端 ↑
