# Overview
All API Endpoints using post method only.
Mafindo Public API use API Key for Authentication. Please refer to Authorization section.
https://yudistira.turnbackhoax.id/api/
# News
This is an object representing News Item. The main subject of the whole API Endpoints.
You can retrieve it to see detail of the news item, the list of news, get total of the news in our database, sample of random news, or news based on the author.
We also have experimental API endpoints to retrieve news based on media related to the news.
POST/antihoax/POST/antihoax/get_totalPOST/antihoax/searchPOST/antihoax/search_datePOST/antihoax/multimediaPOST/antihoax/randomPOST/antihoax/latestPOST/antihoax/get_popular_articlePOST/antihoax/author/:ID
SHOW
# The News Object
# Attributes
idstringUnique identifier for each news item
authorsstringNews Item Author's Id, some news will show multiple author's Id separated by comma. E.g.
1, 2, 3statusstringNews Item Status to classified if the news is fake or truth.
Values:
1for truth,2for fake newsclassificationstringNews Item fake news classification. E.g.
Fabricated ContenttitlestringTitle of the news Item
contentstringContent of the news Item
factstringAn Argument for the news Item which state the fact of the news.
referencesstringReferences Link for the news Item.
source_issuestringSource of the News Item.
source_linkstringSource of the News Item's URL.
picture1stringURL of a picture which related to the news Item.
picture2stringURL of an additional picture for the news item.
tanggalstringDate of News Item published.
tagsstringList of words which used as label for the news item, separated by comma. E.g.
tag 1, tag 2, tag 3conclusionstringNews item conclusion for public awareness.
claim_reviewarrayoptionalClaim review related to the news item from several sources, This is intended to comply with google fact-check review when people search on some news.
Item reviewed is the original source of news item that saved in our collections, while Claim is a news that acknowledge the item reviewed about its truthness and qualitiy.
Please refer to Google Fact-check Reference (opens new window) for references
Show child attributes
claim_date_publishedstringDate of Claim review published
claim_urlstringClaim review URL source
claim_titlestringClaim review title
claim_author_namestringClaim review author's name
claim_rating_valuestringClaim review overall rating value
claim_author_typestringClaim review overall author type
Values:
1for person,2for organizationclaimed_item_author_namestringItem reviewed author name
claimed_item_author_typestringItem reviewed author type
Values:
1for person,2for organizationclaimed_item_urlstringItem reviewed URL Source
claimed_item_published_datestringItem reviewed published date
mediaarrayoptionalMedia is a picture, video, or audio file related to the news item, we might remove
picture1andpicture2properties in the future for better media management.Show child attributes
media_namestringMedia filename
media_pathstringMedia fullpath
[
{
"id": "891",
"authors": "Tempo",
"status": "2",
"classification": "Misleading Content",
"title": "[SALAH] Penasihat Istana RI adalah Anggota Partai Komunis Cina",
"content": "Baru-baru ini beredar sebuah informasi bahwa Presiden Jokowi mengangkat Jack Ma sebagai penasehat Istana. Yang dipersoalkan dalam informasi itu adalah Jack Ma menjadi anggota Partai Komunis China. Informasi itu diunggah oleh akun Tata di Facebook pada 28 Desember 2018. Dia menyertakan video berdurasi 1 menit 32 detik dengan tulisan:\r\n\r\n\"Tetap waspada, bahaya komunis, rapatkan barisan, menangkan Prabowo sandi!! #PAS\"\r\n",
"fact": "Jack Ma menerima tawaran menjadi penasihat panitia pengarah roadmap e-commerce Indonesia. Ma datang ke Indonesia pada Oktober 2018 untuk menghadiri rangkaian acara Pertemuan Tahunan Dana Moneter Internasional – Bank Dunia di Bali. Sementara surat kabar pendukung pemerintah Cina, The People's Daily, mengkonfirmasi bahwa Jack Ma menjadi anggota Partai Komunis China (CPC) pada November 2018.\r\n\r\n\r\n",
"references": "https://cekfakta.tempo.co/fakta/100/fakta-atau-hoax-benarkah-penasihat-istana-ri-adalah-anggota-partai-komunis-cina",
"source_issue": "Facebook",
"source_link": "https://www.facebook.com/100010158074521/videos/vb.100010158074521/785564921792103/?type=2&theater",
"picture1": "https://cdn.tmpo.co/data/2019/01/10/id_810446/810446_720.jpg",
"picture2": "",
"tanggal": "2019-01-10",
"tags": "cekfakta",
"conclusion": "Dari fakta di atas bahwa video yang menyebutkan penasihat Istana RI adalah anggota Partai Komunis Cina adalah salah. Penunjukan Jack Ma oleh pemerintah Indonesia hanya sebagai penasihat panitia pengarah e-commerce dalam kapasitasnya sebagai pendiri Alibaba Group.",
"claim_review": [
{
"claim_date_published": "2019-02-10",
"claim_url": "http://google.com",
"claim_title": "Claim Title",
"claim_author_name": "Claim Author Name",
"claim_rating_value": "2",
"claim_author_type": "2",
"claimed_item_author_name": "Author",
"claimed_item_author_type": "1",
"claimed_item_url": "http://google.com",
"claimed_item_published_date": "2019-02-10"
},
{
"claim_date_published": "2019-02-10",
"claim_url": "http://google.com",
"claim_title": "Claim Title Next Generation",
"claim_author_name": "Claim Author Name X",
"claim_rating_value": "2",
"claim_author_type": "1",
"claimed_item_author_name": "Author",
"claimed_item_author_type": "1",
"claimed_item_url": "http://google.com",
"claimed_item_published_date": "2019-02-10"
}
],
"media": [
{
"media_name": "7iq2JjhDRwapqM2k58gkxXZo",
"media_path": "https://yudistira.turnbackhoax.id/v2/uploads/media/2019/02/bb249c0ad8af4a8c6d8483e18da81bede0cab37b979d8b3dea94a72ae9f2bbc9ed1c76519d5ab026187660da2bd018b26f7df476a2d6159d1892aacb1dc879ad.jpeg"
},
{
"media_name": "201af3e8135432cc40f61073a29556df",
"media_path": "https://yudistira.turnbackhoax.id/v2/uploads/media/2019/02/2f0c4832e58de1cfd0c60188f6273cd946deb83f3360b6deeb4f067c432168399312c5e795560517ef22bcea54aa5fb696b8ee3d425366274a1cb001d3e9a815.jpeg"
}
]
},
// ... more news item
]
# Get News List / Get News Item
Get list of news or individual news item
# Parameters
keystring requiredYour authorization API Key
idintegeroptionalId of News Item, mandatory to get single news item.
If you want to get the list of news, please omit this data from request.
limitintegeroptionalLimit of news item to show, useful for get list of news item.
offsetintegeroptionalNumber of offset for News item to be shown
# Returns
Returns a list of news or a news object based on the ID in the data sent
# Search News
Search News based on search criteria. You can retrieve the list of news or total of the news related to your search.
# Parameters
keystring requiredYour authorization API Key
methodstring requiredSearch criteria / method. Please refers to search method for details.
valuestring requiredThe value of search method / criteria.
limitintegeroptionalLimit of news item to show, useful for get list of news item.
totalintegeroptionalIf you send this in request data body, you will get total records count of search results instead of the list.
The values are:
1for true,0for false
# Returns
Returns a list of news object or the total count of news object based on the search criteria
# Search method List
authorSearch news by the author of the news object
contentSearch news by the content of the news object
titleSearch news by the title of the news object
source_linkSearch news by the source link of the news object
source_linkSearch news by the tags of the news object
statusSearch news by the status of the news object
# Search Archive by Date
Search news archives by date published. This end points get all archive without any limitation
# Parameters
keystring requiredYour authorization API Key
startstring requiredSearch start date. using format YYYY-MM-DD
endstring requiredSearch end date. using format YYYY-MM-DD
# Returns
Returns a list of news object or the total count of news object based on the search criteria
# Get News by Media References
Get news by media references in the news.
We are going to support audio, video and image file type.
# Parameters
keystring requiredYour authorization API Key
typestring requiredType of media references
Possible values:
hash,image,audiovaluestring requiredSearch value of the media.
Possible values:
For typehash, you may send hashed value of the media
For typeimage/audio, you may send the media URLoptionstring requiredAdditional search option.
Possible values:
media-onlywill return only the media url
fullwill return all parameter of the news object
# Returns
Returns a list of news or a news object based on the ID in the data sent
article_idID of the news object
media_namestringMedia filename
media_pathstringMedia fullpath
# Get News by Author ID
Get list of News based on its Author.
# Parameters
# Request URL Parameter
:IDstring requiredID of the Author. Please refers to Author to get the author list.
# Request Body Parameter
keystring requiredYour authorization API Key
# Returns
Returns a list of news object by specific author
# Author
This is an object representing Author Object. Since our news collection is written by several authors from different party.
You can retrieve it to see detail of the list of author, or the author detail information.
POST/antihoax/get_authorsPOST/antihoax/get_author
SHOW
# The Author Object
# Attributes
idstringUnique identifier or ID for each author
namastringAuthor name
deskripsistringA brief of information about the Author
websitestringWebsite URL Address of the Author
iconstringIcon / Image URL which represent the Author
[
{
"id": "14",
"nama": "Tempo",
"deskripsi": "Sejak 2008, Tempo.co telah lahir kembali dengan wajah baru dan sajian berita yang berkualitas. Kami berupaya menerapkan standar tinggi jurnalisme dalam meliput peristiwa dan menuliskannya secara tajam, cerdas dan berimbang. Prinsip kami, enak dibaca dan perlu, bahkan jenaka pun bisa.\r\nSemua itu adalah upaya kami untuk membuat Indonesia lebih baik. Tempo, Untuk Publik, Untuk Republik.",
"website": "tempo.co",
"icon": "https://yudistira.turnbackhoax.id/uploads/thumbnail/2e051cb97ef38d3a0bed0b490bd47f71.png"
},
// ... more author item
]
# Get Author by News ID
Get author detail of a News Object.
For information about News Object refer to News Section.
# Parameters
keystring requiredYour authorization API Key
IDinteger requiredNews Object ID
# Returns
Returns an object with information about the author and news related with the specified news ID
author_idstringUnique identifier or ID for the author
data_idstringUnique identifier or ID for the news
urutanstringinternalThe order of the author. You may ignore this parameter, since this is for our internal purpose only.
idstringUnique identifier or ID for the author
namastringAuthor name
deskripsistringA brief of information about the Author
websitestringWebsite URL Address of the Author
iconstringIcon / Image URL which represent the Author
[
{
"author_id": "14",
"data_id": "891",
"urutan": "1",
"id": "14",
"nama": "Tempo",
"deskripsi": "Sejak 2008, Tempo.co telah lahir kembali dengan wajah baru dan sajian berita yang berkualitas. Kami berupaya menerapkan standar tinggi jurnalisme dalam meliput peristiwa dan menuliskannya secara tajam, cerdas dan berimbang. Prinsip kami, enak dibaca dan perlu, bahkan jenaka pun bisa.\r\nSemua itu adalah upaya kami untuk membuat Indonesia lebih baik. Tempo, Untuk Publik, Untuk Republik.",
"website": "tempo.co",
"icon": "https://yudistira.turnbackhoax.id/uploads/thumbnail/2e051cb97ef38d3a0bed0b490bd47f71.png"
}
]
# Report
This is a service to report hoax news. So you can easily support our effort in fighting fake news.
POST/report/API_KEY
# The Report Object
# Attributes
namastringReporter Name
emailstringReporter Email
judulstringTitle of the report
teks_hoaxstringContent of the report. You can fill in the fake news content, or anything which can be reviewed by our fact-check team.
pesanstringYour message related to the report
prioritasstringReport urgency category. please consider to use
Normalas default value.Values are:
Normal,Medium,HighstatusstringStatus of the report, you must send the status as
OpenValues are:
Open,In Progress,Donescreenshot_1stringPhoto / screenshot related with the report
screenshot_2stringAdditional Photo / screenshot related with the report
{
"nama": "John Doe",
"email": "me@john.me",
"judul": "Informasi hoax terkait SARS",
"teks hoax": "Beredar informasi penyebaran virus SARS di kampus-kampus di area Yogyakarta",
"pesan": "Mohon dibantu untuk konfirmasi mengenai berita terkait, berita beredar melalui aplikasi chatting",
"prioritas": "normal",
"status": "",
"screenshot_1": "path/to/url/image1.png",
"screenshot_1": "path/to/url/image2.png"
}
# Submit Report
Submit your report to our reporting platform
# Parameters
# Request URL Parameter
API_KEYrequiredYour authorization API Key
# Request Body Parameter
Send request with form-data based on the Report Object
# Returns
Returns string with text.
Success message is Report saved successfully