LibraryOfCongress / api.congress.gov

congress.gov API
630 stars 39 forks source link

QUESTION: how frequently is the Congress.gov.api updated? #265

Open BrandonChiazza opened 1 month ago

BrandonChiazza commented 1 month ago

I would like to know if this is perfectly in synch with Congress.Gov or if there are delays between information on congress.gov and what's available via this API?

rbram commented 1 month ago

Hello. The Congress.gov API is updated with new information from Congress.gov roughly every 15 minutes. Please review the documentation in this Git repository for the scope of each collection.

BrandonChiazza commented 1 month ago

Thank you so much for the prompt respone @rbram . I have not found the details in the documentation regarding this, but will review.

My question is pertaining to the dates in the bill documentation: I noticed that in some cases there is a discrepancy for and the updateDate by a day or so. Is this expected? is there a reasoning here or some latecy between it being introduced physically, to its entry into congress.gov, and then another delay to the api?

Thank you in advance for your assistance. -Brandon

Definitions found from documentation below:

apreiter18 commented 1 month ago

Hello, @BrandonChiazza - Congress.gov's legislation collection is updated the morning after a session adjourns.

Here is an example of a bill that was introduced yesterday and ingested into Congress.gov today (2024-07-16):

The updateDate element can be best defined as the following: the date of the last update received for the legislative entity . It’s not a date corresponding to the legislative date or legislative action date.

You will see updateDate elements that differ from action dates. In the above scenario, for 118 HR 9030:

apreiter18 commented 1 month ago

Are you comfortable with closing this issue, @BrandonChiazza - or do you have any further questions? Thank you!

BrandonChiazza commented 1 month ago

Thank you. This was really helpful!

BrandonChiazza commented 1 month ago

I actually would like to just confirm my understanding further and ask a follow-up:

Confirming that there are no additional synchs or updates throughout the day -- only one synch in the day.

Thanks and sorry for the multiple questions here.

apreiter18 commented 1 month ago

Hi @BrandonChiazza - Congress.gov has many collections so the updates can vary. For example,

  1. Congress.gov's legislation collection (e.g., actions, official titles, cosponsors) is updated the morning after a session adjourns
  2. Legislation texts, which come from the Government Publishing Office (GPO), are updated throughout the day, roughly 15 minutes after the legislation text becomes available on GPO's GovInfo website.
  3. Committee reports, which come from the Government Publishing Office (GPO), are updated throughout the day, roughly 15 minutes after the committee report becomes available on GPO's GovInfo website.

This chart shows when you can expect updates to occur on Congress.gov for all of our collections.

I hope this helps a bit!

apreiter18 commented 3 weeks ago

Hi @BrandonChiazza - I wanted to check in and see if this issue could be closed/or if you had any further questions. Thanks!