API Access
I am working on setting up basic functionality to retrieve information from the Birdwatch Archive database programatically. By making requests to the API endpoints, you can retrieve data in a standardized JSON format. Please see below for details on the current available functionality.
Basic Details
No authentication is required to use these endpoints. Please don't DDOS my server, though. I have implemented basic rate-limiting, and the server will return an HTTP 429 - Too Many Requests response if you are overloading it. If you write scripts to interact with the site, please be sure to configure them to handle this response code.
Technical Details
- rack-attack
- rack-cors
- grape
- grape-active_model_serializers
- grape-kaminari
Notes
Retrieve a list of all Birdwatch Notes by making a GET request to https://birdwatcharchive.org/api/v1/notes
[
{
"id": 1391040186075713500,
"noteId": 1391040186075713500,
"createdAtMillis": 1620484799293,
"tweetId": 1390855971833012200,
"classification": "MISINFORMED_OR_POTENTIALLY_MISLEADING",
"believable": "BELIEVABLE_BY_MANY",
"harmful": "CONSIDERABLE_HARM",
"validationDifficulty": "EASY",
"misleadingOther": 0,
"misleadingFactualError": 1,
"misleadingManipulatedMedia": 0,
"misleadingOutdatedInformation": 0,
"misleadingMissingImportantContext": 1,
"misleadingUnverifiedClaimAsFact": 1,
"misleadingSatire": 0,
"notMisleadingOther": 0,
"notMisleadingFactuallyCorrect": 0,
"notMisleadingOutdatedButNotWhenWritten": 0,
"notMisleadingClearlySatire": 0,
"notMisleadingPersonalOpinion": 0,
"trustworthySources": 1,
"summary": "This is a lie that has been proven wrong again and again. https://www.ncbi.nlm.nih.gov/search/research-news/9701/"
},
[...]
{
"id": 1404416342950924300,
"noteId": 1404416342950924300,
"createdAtMillis": 1623673923608,
"tweetId": 1403723194117275600,
"classification": "MISINFORMED_OR_POTENTIALLY_MISLEADING",
"believable": "BELIEVABLE_BY_MANY",
"harmful": "CONSIDERABLE_HARM",
"validationDifficulty": "EASY",
"misleadingOther": 0,
"misleadingFactualError": 1,
"misleadingManipulatedMedia": 0,
"misleadingOutdatedInformation": 0,
"misleadingMissingImportantContext": 1,
"misleadingUnverifiedClaimAsFact": 1,
"misleadingSatire": 0,
"notMisleadingOther": 0,
"notMisleadingFactuallyCorrect": 0,
"notMisleadingOutdatedButNotWhenWritten": 0,
"notMisleadingClearlySatire": 0,
"notMisleadingPersonalOpinion": 0,
"trustworthySources": 1,
"summary": "This statement has multiple pieces of misinformation. https://www.politifact.com/factchecks/list/?speaker=donald-trump&ruling=false"
}
]
The notes listing is paginated, and will display only 50 notes per page. Request different pages by passing a ?page parameter. For example: https://birdwatcharchive.org/api/vi/notes?page=5
Specific note details
To retrieve information about a specific note, include the note ID in the URL. For example: https://birdwatcharchive.org/api/v1/notes/1597379851526279168
{
"id": 1597379851526279200,
"noteId": 1597379851526279200,
"createdAtMillis": 1669680009143,
"tweetId": 1592127966372315100,
"classification": "MISINFORMED_OR_POTENTIALLY_MISLEADING",
"believable": null,
"harmful": null,
"validationDifficulty": null,
"misleadingOther": 0,
"misleadingFactualError": 1,
"misleadingManipulatedMedia": 0,
"misleadingOutdatedInformation": 0,
"misleadingMissingImportantContext": 1,
"misleadingUnverifiedClaimAsFact": 0,
"misleadingSatire": 0,
"notMisleadingOther": 0,
"notMisleadingFactuallyCorrect": 0,
"notMisleadingOutdatedButNotWhenWritten": 0,
"notMisleadingClearlySatire": 0,
"notMisleadingPersonalOpinion": 0,
"trustworthySources": 1,
"summary": "The risk of myocarditis is more than seven times higher from COVID-19 than the vaccine. https://www.frontiersin.org/articles/10.3389/fcvm.2022.951314/full The side effects of the vaccines have always been listed on the CDC website, including myocarditis. https://www.cdc.gov/coronavirus/2019-ncov/vaccines/safety/adverse-events.html"
}
Search by Tweet ID
If you know a specific Tweet ID (perhaps you have your own data set of tweets that you are hoping to cross-reference with Birdwatch), you can retrieve a list of all Birdwatch notes which match that specific Tweet by making a GET request to https://birdwatcharchive.org/api/v1/notes/tweet/TWEET_ID
For example, https://birdwatcharchive.org/api/v1/notes/tweet/1377030478167937024 will return:
[
{
"id": 1537142913737429000,
"noteId": 1537142913737429000,
"createdAtMillis": 1655318404027,
"tweetId": 1377030478167937000,
"classification": "MISINFORMED_OR_POTENTIALLY_MISLEADING",
"believable": "BELIEVABLE_BY_MANY",
"harmful": "CONSIDERABLE_HARM",
"validationDifficulty": "EASY",
"misleadingOther": 0,
"misleadingFactualError": 1,
"misleadingManipulatedMedia": 0,
"misleadingOutdatedInformation": 0,
"misleadingMissingImportantContext": 1,
"misleadingUnverifiedClaimAsFact": 1,
"misleadingSatire": 0,
"notMisleadingOther": 0,
"notMisleadingFactuallyCorrect": 0,
"notMisleadingOutdatedButNotWhenWritten": 0,
"notMisleadingClearlySatire": 0,
"notMisleadingPersonalOpinion": 0,
"trustworthySources": 1,
"summary": "Forbes has a good rundown of the investigation and the Washington Post has a fuller picture of where the investigation is headed. Gaetz seems to be deliberately misleading his readers about the timeline of any investigation with this tweet. https://www.forbes.com/sites/rachelsandler/2021/03/30/gop-rep-matt-gaetz-reportedly-under-investigation-over-relationship-with-17-year-old-girl/?sh=7da3be1a23f4 https://www.washingtonpost.com/politics/2022/01/27/sex-trafficking-allegations-matt-gaetz/ "
},
{
"id": 1377061482198827000,
"noteId": 1377061482198827000,
"createdAtMillis": 1617152016578,
"tweetId": 1377030478167937000,
"classification": "MISINFORMED_OR_POTENTIALLY_MISLEADING",
"believable": "BELIEVABLE_BY_MANY",
"harmful": "CONSIDERABLE_HARM",
"validationDifficulty": "EASY",
"misleadingOther": 0,
"misleadingFactualError": 0,
"misleadingManipulatedMedia": 0,
"misleadingOutdatedInformation": 0,
"misleadingMissingImportantContext": 1,
"misleadingUnverifiedClaimAsFact": 1,
"misleadingSatire": 0,
"notMisleadingOther": 0,
"notMisleadingFactuallyCorrect": 0,
"notMisleadingOutdatedButNotWhenWritten": 0,
"notMisleadingClearlySatire": 0,
"notMisleadingPersonalOpinion": 0,
"trustworthySources": 1,
"summary": "The DOJ started this investigation under former President Trump and former Attorney General Bill Barr which means it was -- -- not weeks ago, it was months -- it is not an organized crime group it was the DOJ -- this is part of a larger investigation https://www.orlandoweekly.com/Blogs/archives/2021/03/30/florida-rep-matt-gaetz-reportedly-under-investigation-for-relationship-with-17-year-old-girl "
}
]