共用方式為


LegiScan (獨立發行者) (預覽版)

使用 LegiScan API 存取所有 50 個州和國會的立法資訊。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 丹·羅馬諾
URL https://developments.substack.com
Email dan.romano@swolcat.com
連接器中繼資料
Publisher 克勞特羅克
網站 https://legiscan.com/
隱私策略 https://legiscan.com/privacy
類別 資料

LegiScan(獨立出版商)

LegiScan 是一項立法跟踪和數據服務,可提供有關州和聯邦立法的實時信息。 此連接器允許用戶以編程方式訪問美國所有 50 個州和國會的地方級別的法案信息、會話數據、人員資料、投票記錄、搜索結果和監控州。

出版商:丹·羅馬諾(swolcat)

先決條件

您需要 LegiScan Civic API 金鑰 才能使用此連接器。 通過 LegiScan 網站註冊以獲取訪問憑據。

連接器目前支援下列作業:

工作階段和元數據

  • GetSessionList:擷取每個支援的州和國會的所有可用會話清單。
  • GetMasterListRaw:傳回指定工作階段所有帳單的原始字典。
  • GetDatasetList:列出所有州的大量立法資料集。
  • GetDataset:傳回特定資料集的中繼資料。
  • GetDatasetRaw:擷取完整的資料集內容以進行大量處理。

賬單資料

  • GetBill:傳回特定帳單的結構化資訊。
  • GetBillText:傳回特定帳單的全文。
  • GetAmendment:傳回特定修正的內容。
  • GetSupplement:擷取帳單的補充或附件。

投票和人員

  • GetRollCall:傳回特定點名的投票結果。
  • GetPerson:擷取立法者、贊助者或相關人員的相關資訊。
  • GetSessionPeople:傳回與特定工作階段相關聯的所有人員。
  • GetSponsoredList:傳回由人員贊助的帳單清單。
  • GetSearchResults:傳回查詢的結構化搜尋結果。
  • GetSearchRawResults:傳回適合差異或稽核的原始搜尋結果。

監測

  • GetMonitorList:傳回受監視帳單的結構化清單。
  • GetMonitorListRaw:傳回變更偵測工作流程的監視器清單的輕量型版本。
  • SetMonitor:設定或更新您帳戶的受監控帳單清單。

取得憑證

  1. 移至 https://legiscan.com/
  2. 點擊“生成密鑰!
  3. 在下一頁上,找到「在此處註冊」連結或造訪 https://legiscan.com/user/register
  4. 核准後,您將收到要在連接器中使用的 API 金鑰。

使用者入門

  1. 從 LegiScan 取得 API 金鑰。
  2. 閱讀文件: https://legiscan.com/misc/LegiScan_API_User_Manual.pdf

已知問題和限制

  • 速率限制,視您的 API 訂閱層級而定。
  • 完整的法案文本可能無法在引入後立即提供。
  • 一些州級數據可能會滯後或不完整,具體取決於立法機關的更新頻率。

常見問題

問: 此連接器是否支援聯邦立法?

一個: 是的,除了所有 50 個州之外,LegiScan 還包括美國國會。

問: 我可以追蹤帳單進度嗎?

一個: 是的,每張帳單都包含行動的狀態和歷史記錄。

問: 此連接器是否支援州立法?

一個: 是的,LegiScan 包括美國所有 50 個州的立法活動。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

修改指定帳單的監控清單

在監控/忽略清單中新增或移除帳單。 使用監視器、刪除、設置為動作;立場選項是觀察、支持、反對。

全文搜尋帳單

從全文搜尋引擎檢索結果(50 個結果)。 使用 LegiScan 引擎執行立法的全文檢索搜尋。 您可以按狀態縮寫或會話 ID 進行搜索。 回應包括編頁結果和追蹤更新的change_hash。

取得 GAITS 監視器清單

從 GAITS 監視器清單擷取帳單

取得人員(贊助商)資訊

擷取指定people_id的基本資訊

取得修正案

擷取指定amendment_id的修正文字

取得可用工作階段的清單

傳回可在指定狀態縮寫中存取的工作階段清單,或傳回所有工作階段(如果未指定狀態)。

取得可用工作階段資料集的清單

擷取可用資料集快照集的清單

取得工作階段的原始 ZIP 資料集

傳回原始 ZIP 封存,其中包含特定工作階段的所有法案、投票和人員資料。 這是一個適合檔案下載的二進位流。

取得帳單文字

擷取指定doc_id的完整帳單文字

取得立法會議的資料集封存

擷取特定session_id的個別資料集

取得簡化的搜尋結果以進行自動監控

從全文搜尋引擎擷取結果。 2000 個結果。 執行具有簡化結果結構的全文檢索搜索,一次最多返回 2000 條記錄。 此端點已針對跨狀態或工作階段的關鍵字監控進行了最佳化。

獲取 GAITS 監視器列表(原始)

從 GAITS 監視器清單中檢索帳單以進行change_hash偵測

獲取原始賬單主列表

檢索針對change_hash檢測優化的主賬單列表

獲取補充劑

擷取指定supplement_id的補充文件

獲取詳細賬單信息

擷取指定bill_id的帳單詳細資料

獲取賬單主清單

擷取指定工作階段 (id) 或指定狀態 (state) 中目前工作階段的摘要帳單資料的主要清單。

獲取點名詳細信息

擷取指定roll_call_id的唱名投票資訊

獲得立法者發起的法案

檢索由個人people_id發起的法案清單

讓工作階段中的人員記錄處於作用中狀態

擷取特定session_id中活躍的人員清單

修改指定帳單的監控清單

在監控/忽略清單中新增或移除帳單。 使用監視器、刪除、設置為動作;立場選項是觀察、支持、反對。

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱。

行動
action True string

要執行的操作: monitor 新增帳單、 remove 從清單中刪除帳單、 set 更新立場。

帳單編號清單
list True string

要修改的值以 bill_id 逗號分隔的清單。

立場
stance string

分配給法案的立場 - watchsupportoppose

傳回

全文搜尋帳單

從全文搜尋引擎檢索結果(50 個結果)。 使用 LegiScan 引擎執行立法的全文檢索搜尋。 您可以按狀態縮寫或會話 ID 進行搜索。 回應包括編頁結果和追蹤更新的change_hash。

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

狀態縮寫
state string

使用州縮寫(例如“NY”)或“ALL”。 如果使用工作階段 ID,則為選擇性。

工作階段識別碼
id integer

使用 session_id 而不是狀態來鎖定特定工作階段。

搜尋查詢
query True string

要針對搜尋引擎執行的全文檢索查詢字串。

年份篩選器
year integer

1 = 全部,2 = 當前,3 = 最近,4 = 之前或確切的 1900 年 > 。

頁碼
page integer

要傳回的結果頁碼。

傳回

取得 GAITS 監視器清單

從 GAITS 監視器清單擷取帳單

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱。

記錄篩選器
record string

篩選器以傳回目前或已封存的監視器。 值: currentarchived或年份 (例如, 2019

傳回

取得人員(贊助商)資訊

擷取指定people_id的基本資訊

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

人員識別碼
id True integer

人員 ID

傳回

取得修正案

擷取指定amendment_id的修正文字

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

修訂標識碼
id True integer

修訂標識碼

傳回

取得可用工作階段的清單

傳回可在指定狀態縮寫中存取的工作階段清單,或傳回所有工作階段(如果未指定狀態)。

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

呼叫作業

狀態縮寫
state string

擷取此狀態的工作階段

傳回

取得可用工作階段資料集的清單

擷取可用資料集快照集的清單

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

狀態縮寫
state string

資料集的選用狀態篩選器。

年份篩選器
year integer

資料集的選用年份篩選器。

傳回

取得工作階段的原始 ZIP 資料集

傳回原始 ZIP 封存,其中包含特定工作階段的所有法案、投票和人員資料。 這是一個適合檔案下載的二進位流。

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

工作階段識別碼
id True integer

要擷取的資料集session_id。

存取鍵
access_key True string

對應 getDatasetList 回應的access_key。

格式
format string

ZIP 封存內容的選用格式 (json 或 csv)。

傳回

response
binary

取得帳單文字

擷取指定doc_id的完整帳單文字

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

文件 ID
id True integer

文件 ID

傳回

取得立法會議的資料集封存

擷取特定session_id的個別資料集

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

工作階段識別碼
id True integer

要擷取的資料集session_id。

存取鍵
access_key True string

對應 getDatasetList 回應的access_key。

格式
format string

ZIP 封存中檔案的可選格式。 預設為 JSON。

傳回

取得簡化的搜尋結果以進行自動監控

從全文搜尋引擎擷取結果。 2000 個結果。 執行具有簡化結果結構的全文檢索搜索,一次最多返回 2000 條記錄。 此端點已針對跨狀態或工作階段的關鍵字監控進行了最佳化。

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

狀態縮寫
state string

所有州的州縮寫(例如“TX”)或“ALL”。 如果使用工作階段 ID,則為選擇性。

工作階段識別碼
id integer

將搜尋限制為特定session_id。

搜尋查詢
query True string

全文檢索查詢字串,URL 編碼。

年份篩選器
year integer

1 = 全部,2 = 當前,3 = 最近,4 = 之前,或 1900 年 > 。

頁碼
page integer

要傳回的結果頁面 (每頁最多 2000 筆記錄)。

傳回

獲取 GAITS 監視器列表(原始)

從 GAITS 監視器清單中檢索帳單以進行change_hash偵測

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱。

記錄篩選器
record string

篩選器以傳回目前或已封存的監視器。 值: currentarchived或年份 (例如, 2019

傳回

獲取原始賬單主列表

檢索針對change_hash檢測優化的主賬單列表

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰

行動
op True string

LegiScan 作業名稱

工作階段識別碼
id integer

立法會議的數字 ID

狀態縮寫
state True string

兩個字母的州縮寫(例如“NY”),用於按州過濾賬單

傳回

獲取補充劑

擷取指定supplement_id的補充文件

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

補充 ID
id True integer

補充 ID

傳回

獲取詳細賬單信息

擷取指定bill_id的帳單詳細資料

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

帳單編號
id True integer

帳單識別碼

傳回

獲取賬單主清單

擷取指定工作階段 (id) 或指定狀態 (state) 中目前工作階段的摘要帳單資料的主要清單。

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您的 LegiScan API 金鑰。

作業名稱
op True string

LegiScan API 所需的固定值 getMasterList

工作階段識別碼
id integer

立法會議的數字 ID

狀態縮寫
state True string

擷取指定狀態下目前工作階段的帳單主清單 (請謹慎使用)。

傳回

獲取點名詳細信息

擷取指定roll_call_id的唱名投票資訊

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱

點名 ID
id True integer

點名 ID

傳回

獲得立法者發起的法案

檢索由個人people_id發起的法案清單

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱。

人員識別碼
id True integer

立法者檢索發起法案的people_id。

傳回

讓工作階段中的人員記錄處於作用中狀態

擷取特定session_id中活躍的人員清單

參數

名稱 機碼 必要 類型 Description
API 金鑰
key True string

您用於存取 LegiScan 的 API 金鑰。

行動
op True string

LegiScan 作業名稱。

工作階段識別碼
id True integer

擷取作用中人員的session_id。

傳回

定義

GetSessionList回應

名稱 路徑 類型 Description
狀態
status string
sessions
sessions array of object
session_id
sessions.session_id integer
session_title
sessions.session_title string
session_name
sessions.session_name string
year_start
sessions.year_start integer
year_end
sessions.year_end integer
特殊
sessions.special integer
dataset_hash
sessions.dataset_hash string

MasterList回應

名稱 路徑 類型 Description
狀態
status string
session_id
session.session_id integer
state_id
session.state_id integer
year_start
session.year_start integer
year_end
session.year_end integer
預先檔案
session.prefile integer
sine_die
session.sine_die integer
之前的
session.prior integer
特殊
session.special integer
session_tag
session.session_tag string
session_title
session.session_title string
session_name
session.session_name string
主列表
masterlist object

MasterListRaw回應

名稱 路徑 類型 Description
狀態
status string
主列表
masterlist object

GetBill回應

名稱 路徑 類型 Description
狀態
status string
bill_id
bill.bill_id integer
title
bill.title string
description
bill.description string
url
bill.url string
change_hash
bill.change_hash string

BillText回應

名稱 路徑 類型 Description
狀態
status string
doc_id
text.doc_id integer
bill_id
text.bill_id integer
date
text.date string
型別
text.type string
默劇
text.mime string
text_size
text.text_size integer
text_hash
text.text_hash string
文件
text.doc string

法案修訂回應

名稱 路徑 類型 Description
狀態
status string
amendment_id
amendment.amendment_id integer
title
amendment.title string
description
amendment.description string
默劇
amendment.mime string
amendment_size
amendment.amendment_size integer
amendment_hash
amendment.amendment_hash string

補充回應

名稱 路徑 類型 Description
狀態
status string
supplement_id
supplement.supplement_id integer
bill_id
supplement.bill_id integer
date
supplement.date string
type_id
supplement.type_id integer
型別
supplement.type string
title
supplement.title string
description
supplement.description string
默劇
supplement.mime string
mime_id
supplement.mime_id integer
supplement_size
supplement.supplement_size integer
supplement_hash
supplement.supplement_hash string

點名回應

名稱 路徑 類型 Description
狀態
status string
roll_call_id
roll_call.roll_call_id integer
bill_id
roll_call.bill_id integer
date
roll_call.date string
說明
roll_call.desc string
roll_call.yea integer
roll_call.nay integer
內華達州
roll_call.nv integer
缺席
roll_call.absent integer
總計
roll_call.total integer
通過
roll_call.passed integer
roll_call.chamber string
chamber_id
roll_call.chamber_id integer
投票
roll_call.votes array of object
people_id
roll_call.votes.people_id integer
vote_id
roll_call.votes.vote_id integer
vote_text
roll_call.votes.vote_text string

人員回應

名稱 路徑 類型 Description
狀態
status string
people_id
person.people_id integer
person_hash
person.person_hash string
state_id
person.state_id integer
party_id
person.party_id string
合作對象
person.party string
role_id
person.role_id integer
角色
person.role string
名稱
person.name string
first_name
person.first_name string
middle_name
person.middle_name string
姓氏
person.last_name string
suffix
person.suffix string
暱稱
person.nickname string
person.district string
ftm_eid
person.ftm_eid integer
votesmart_id
person.votesmart_id integer
opensecrets_id
person.opensecrets_id string
knowwho_pid
person.knowwho_pid integer
選票百科
person.ballotpedia string
committee_sponsor
person.committee_sponsor integer
committee_id
person.committee_id integer

搜尋回應

名稱 路徑 類型 Description
狀態
status string
頁面
searchresult.summary.page string
範圍
searchresult.summary.range string
相關性
searchresult.summary.relevancy string
count
searchresult.summary.count integer
page_current
searchresult.summary.page_current string
page_total
searchresult.summary.page_total integer
results
searchresult.results array of object
適當
searchresult.results.relevance integer
狀態
searchresult.results.state string
bill_number
searchresult.results.bill_number string
bill_id
searchresult.results.bill_id integer
change_hash
searchresult.results.change_hash string
url
searchresult.results.url string
text_url
searchresult.results.text_url string
research_url
searchresult.results.research_url string
last_action_date
searchresult.results.last_action_date string
last_action
searchresult.results.last_action string
title
searchresult.results.title string

SearchRaw回應

名稱 路徑 類型 Description
狀態
status string
頁面
searchresult.summary.page string
範圍
searchresult.summary.range string
相關性
searchresult.summary.relevancy string
count
searchresult.summary.count integer
page_current
searchresult.summary.page_current string
page_total
searchresult.summary.page_total integer
results
searchresult.results array of object
適當
searchresult.results.relevance integer
bill_id
searchresult.results.bill_id integer
change_hash
searchresult.results.change_hash string

DatasetList回應

名稱 路徑 類型 Description
狀態
status string
資料集清單
datasetlist array of object
state_id
datasetlist.state_id integer
session_id
datasetlist.session_id integer
特殊
datasetlist.special integer
year_start
datasetlist.year_start integer
year_end
datasetlist.year_end integer
session_name
datasetlist.session_name string
session_title
datasetlist.session_title string
dataset_hash
datasetlist.dataset_hash string
dataset_date
datasetlist.dataset_date string
dataset_size
datasetlist.dataset_size integer
access_key
datasetlist.access_key string

DatasetArchive回應

名稱 路徑 類型 Description
狀態
status string
state_id
dataset.state_id integer
session_id
dataset.session_id integer
session_name
dataset.session_name string
dataset_hash
dataset.dataset_hash string
dataset_date
dataset.dataset_date string
dataset_size
dataset.dataset_size integer
默劇
dataset.mime string
壓縮檔
dataset.zip string

Base64 編碼的 ZIP 存檔內容

SessionPeople回應

名稱 路徑 類型 Description
狀態
status string
session_id
sessionpeople.session.session_id integer
state_id
sessionpeople.session.state_id integer
year_start
sessionpeople.session.year_start integer
year_end
sessionpeople.session.year_end integer
特殊
sessionpeople.session.special integer
預先檔案
sessionpeople.session.prefile integer
之前的
sessionpeople.session.prior integer
sine_die
sessionpeople.session.sine_die integer
session_name
sessionpeople.session.session_name string
名稱
sessionpeople.session.name string
dataset_hash
sessionpeople.session.dataset_hash string
人員
sessionpeople.people array of SessionPerson

工作階段人

名稱 路徑 類型 Description
people_id
people_id integer
person_hash
person_hash string
state_id
state_id integer
party_id
party_id string
合作對象
party string
role_id
role_id integer
角色
role string
名稱
name string
first_name
first_name string
middle_name
middle_name string
姓氏
last_name string
suffix
suffix string
暱稱
nickname string
district string
ftm_eid
ftm_eid integer
votesmart_id
votesmart_id integer
opensecrets_id
opensecrets_id string
knowwho_pid
knowwho_pid integer
選票百科
ballotpedia string
committee_sponsor
committee_sponsor integer
committee_id
committee_id integer

SponsoredList回應

名稱 路徑 類型 Description
狀態
status string
贊助者
sponsoredbills.sponsor SessionPerson
sessions
sponsoredbills.sessions array of object
session_id
sponsoredbills.sessions.session_id integer
session_name
sponsoredbills.sessions.session_name string
賬單
sponsoredbills.bills array of object
session_id
sponsoredbills.bills.session_id integer
bill_id
sponsoredbills.bills.bill_id integer
數字
sponsoredbills.bills.number string

MonitorList回應

名稱 路徑 類型 Description
監視器列表
monitorlist array of object
monitor_id
monitorlist.monitor_id integer
狀態
monitorlist.state string
bill_id
monitorlist.bill_id integer
change_hash
monitorlist.change_hash string
bill_id
monitorlist.bill.bill_id integer
狀態
monitorlist.bill.state string
數字
monitorlist.bill.number string
立場
monitorlist.bill.stance integer
change_hash
monitorlist.bill.change_hash string
url
monitorlist.bill.url string
status_date
monitorlist.bill.status_date date
狀態
monitorlist.bill.status integer
last_action_date
monitorlist.bill.last_action_date date
last_action
monitorlist.bill.last_action string
title
monitorlist.bill.title string
description
monitorlist.bill.description string

MonitorListRaw回應

名稱 路徑 類型 Description
狀態
status string
監視器列表
monitorlist array of object
bill_id
monitorlist.bill_id integer
數字
monitorlist.number string
狀態
monitorlist.state string
狀態
monitorlist.status integer
立場
monitorlist.stance integer
change_hash
monitorlist.change_hash string

SetMonitor回應

名稱 路徑 類型 Description
狀態
status string
return object

二進位

這是基本數據類型 『binary』。