# Overview

All API Endpoints using post method only.
Mafindo Public API use API Key for Authentication. Please refer to Authorization section.

Base URL

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.

SHOW

# The News Object

# Attributes


  • id string

    Unique identifier for each news item

  • authors string

    News Item Author's Id, some news will show multiple author's Id separated by comma. E.g. 1, 2, 3

  • status string

    News Item Status to classified if the news is fake or truth.

    Values: 1 for truth, 2 for fake news

  • classification string

    News Item fake news classification. E.g. Fabricated Content

  • title string

    Title of the news Item

  • content string

    Content of the news Item

  • fact string

    An Argument for the news Item which state the fact of the news.

  • references string

    References Link for the news Item.

  • source_issue string

    Source of the News Item.

  • source_link string

    Source of the News Item's URL.

  • picture1 string

    URL of a picture which related to the news Item.

  • picture2 string

    URL of an additional picture for the news item.

  • tanggal string

    Date of News Item published.

  • tags string

    List of words which used as label for the news item, separated by comma. E.g. tag 1, tag 2, tag 3

  • conclusion string

    News item conclusion for public awareness.

  • claim_review array optional

    Claim 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_published string

      Date of Claim review published

    • claim_url string

      Claim review URL source

    • claim_title string

      Claim review title

    • claim_author_name string

      Claim review author's name

    • claim_rating_value string

      Claim review overall rating value

    • claim_author_type string

      Claim review overall author type

      Values: 1 for person, 2 for organization

    • claimed_item_author_name string

      Item reviewed author name

    • claimed_item_author_type string

      Item reviewed author type

      Values: 1 for person, 2 for organization

    • claimed_item_url string

      Item reviewed URL Source

    • claimed_item_published_date string

      Item reviewed published date

  • media array optional

    Media is a picture, video, or audio file related to the news item, we might remove picture1 and picture2 properties in the future for better media management.

    Show child attributes

    • media_name string

      Media filename

    • media_path string

      Media fullpath

The News Object
[
  {
    "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


  • key string required

    Your authorization API Key

  • id integer optional

    Id of News Item, mandatory to get single news item.

    If you want to get the list of news, please omit this data from request.

  • limit integer optional

    Limit of news item to show, useful for get list of news item.

  • offset integer optional

    Number 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

POST /antihoax/

    # Get News Total Count

    Get total count of news in our database

    # Parameters


    • key string required

      Your authorization API Key

    # Returns


    Returns total of news

    POST /antihoax/get_total

      # 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


      • key string required

        Your authorization API Key

      • method string required

        Search criteria / method. Please refers to search method for details.

      • value string required

        The value of search method / criteria.

      • limit integer optional

        Limit of news item to show, useful for get list of news item.

      • total integer optional

        If you send this in request data body, you will get total records count of search results instead of the list.

        The values are: 1 for true, 0 for false


      # Returns


      Returns a list of news object or the total count of news object based on the search criteria

      # Search method List


      • author

        Search news by the author of the news object

      • content

        Search news by the content of the news object

      • title

        Search news by the title of the news object

      • source_link

        Search news by the source link of the news object

      • source_link

        Search news by the tags of the news object

      • status

        Search news by the status of the news object

      POST /antihoax/search

        # Search Archive by Date

        Search news archives by date published. This end points get all archive without any limitation

        # Parameters


        • key string required

          Your authorization API Key

        • start string required

          Search start date. using format YYYY-MM-DD

        • end string required

          Search 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

        POST /antihoax/search_date

          # 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


          • key string required

            Your authorization API Key

          • type string required

            Type of media references

            Possible values: hash, image, audio

          • value string required

            Search value of the media.

            Possible values:
            For type hash, you may send hashed value of the media
            For type image/audio, you may send the media URL

          • option string required

            Additional search option.

            Possible values:
            media-only will return only the media url
            full will 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

          Response Object for media-only request
          • article_id

            ID of the news object

          • media_name string

            Media filename

          • media_path string

            Media fullpath

          POST /antihoax/multimedia
            Multimedia Response Examples

              # Random News

              Get list of random news

              # Parameters


              • key string required

                Your authorization API Key

              # Returns


              Returns a list of random news object

              POST /antihoax/random

                # Latest News

                Get list of latest news

                # Parameters


                • key string required

                  Your authorization API Key

                # Returns


                Returns a list of latest news object

                POST /antihoax/random

                  Get list of popular news

                  # Parameters


                  • key string required

                    Your authorization API Key

                  # Returns


                  Returns a list of popular news object

                  POST /antihoax/get_popular_article

                    # Get News by Author ID

                    Get list of News based on its Author.

                    # Parameters


                    # Request URL Parameter
                    • :ID string required

                      ID of the Author. Please refers to Author to get the author list.

                    # Request Body Parameter
                    • key string required

                      Your authorization API Key

                    # Returns


                    Returns a list of news object by specific author

                    POST /antihoax/author/:ID

                      # 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.

                      Method List
                      • POST /antihoax/get_authors
                      • POST /antihoax/get_author
                      SHOW

                      # The Author Object

                      # Attributes


                      • id string

                        Unique identifier or ID for each author

                      • nama string

                        Author name

                      • deskripsi string

                        A brief of information about the Author

                      • website string

                        Website URL Address of the Author

                      • icon string

                        Icon / Image URL which represent the Author

                      The Author Object
                      [
                        {
                          "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 Authors List

                      Get list of author

                      # Parameters


                      • key string required

                        Your authorization API Key

                      # Returns


                      Returns a list of author object

                      POST /antihoax/get_authors

                        # Get Author by Author ID

                        Get detail of author by its Author ID

                        # Parameters


                        • key string required

                          Your authorization API Key

                        • ID integer required

                          Author ID

                        # Returns


                        Returns an author object

                        POST /antihoax/get_author

                          # Get Author by News ID

                          Get author detail of a News Object.
                          For information about News Object refer to News Section.

                          # Parameters


                          • key string required

                            Your authorization API Key

                          • ID integer required

                            News Object ID

                          # Returns


                          Returns an object with information about the author and news related with the specified news ID

                          Response Object for Author by News ID
                          • author_id string

                            Unique identifier or ID for the author

                          • data_id string

                            Unique identifier or ID for the news

                          • urutan string internal

                            The order of the author. You may ignore this parameter, since this is for our internal purpose only.

                          • id string

                            Unique identifier or ID for the author

                          • nama string

                            Author name

                          • deskripsi string

                            A brief of information about the Author

                          • website string

                            Website URL Address of the Author

                          • icon string

                            Icon / Image URL which represent the Author

                          POST /antihoax/get_authorlink
                            Response Example
                            [
                              {
                                "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.

                            Method List
                            • POST /report/API_KEY

                            # The Report Object

                            # Attributes


                            • nama string

                              Reporter Name

                            • email string

                              Reporter Email

                            • judul string

                              Title of the report

                            • teks_hoax string

                              Content of the report. You can fill in the fake news content, or anything which can be reviewed by our fact-check team.

                            • pesan string

                              Your message related to the report

                            • prioritas string

                              Report urgency category. please consider to use Normal as default value.

                              Values are: Normal, Medium, High

                            • status string

                              Status of the report, you must send the status as Open

                              Values are: Open, In Progress, Done

                            • screenshot_1 string

                              Photo / screenshot related with the report

                            • screenshot_2 string

                              Additional Photo / screenshot related with the report

                            The Report Object
                            {
                              "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_KEY required

                              Your 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

                            POST /report/API_KEY
                              Last Updated: 3/25/2023, 10:06:21 AM