ScriptureEarth.org API

To get every item for one language:

• With the ?v=1&key=[your key], you will also need
• index number (type ‘&idx=[index number]’)
•     OR
• ISO 639-3 code (type ‘&iso=[ISO code]’)
•     OR
• ISO 639-3 code and ROD code [and variant code] (type ‘&iso=[ISO code]&rod=[ROD code][&var=[variant code]]’)
•     OR
• language name and alternate language names (type ‘&pln=[language name and alternate language names]’)

will pull out

• ISO 639-3 code
• ROD code
• variant code
• variant name
• index number
• 10 navigational language query strings
• 10 major language names
• alternate language numbers
• alternate language names
  • alternate language
  • second alternate language
  • ...
• English countries names
  • English country name
  • second English country name
  • ...
• countries codes
  • country code
  • second country code
  • ...
• number of SE apps
  • Android app (apk)
  • iOS Asset Package
• number of SE Scripture App Build HTMLs
  • text
  • audio
  • video
• number of SE online viewers
• number of the SE media
  • text (OT and NT PDFs)
  • audio (OT and NT audio recordings)
  • video (OT and NT video recordings)
  • audio playlists
  • video playlists
• number of the SE media downloads
  • text (OT and NT PDFs)
  • audio (OT and NT audio recordings)
  • video (OT and NT video recordings)
  • video playlists
• number of links to SE Google Play (apk)
• other SE software modules
  • number of GoBible
  • number of MySword
  • number of theWord Windows Bible software
• links to media
  • number of links to Bible.is (Faith Comes by Hearing)
  • number of links to LUMO Bible.is Gospel Film (Faith Comes by Hearing)
  • number of links to YouVersions (Bible.com)
  • number of links to eBible
  • number of links to Global Recordings Network (GRN)
• number of Bibles to buy
• number of links to maps
• number of links to watches
• number of links to other websites
• number of other titles
• number of links to SIL

records.php will look like (https://scriptureearth.org/api/records.php?v=1&key=[your key]&iso=ngu) in raw data:

{
    "0": {
        "type": "iso",
        "id": "1",
        "attributes": {
            "iso": "ngu",
            "num_nav": 9,
            "navigation": {
                "English": "00eng.php",
                "Spanish": "00spa.php",
                "Portugues": "00por.php",
                "French": "00fra.php",
                "Dutch": "00nld.php",
                "German": "00deu.php",
                "Chinese": "00cmn.php",
                "Korean": "00kor.php",
                "Russian": "00rus.php,"
                "Arabic": "00arb.php"
            }
        },
        "relationships": {
            "rod": "00000",
            "var_code": "",
            "var_name": "",
            "iso_query_string": "iso=ngu",
            "idx": 113,
            "idx_query_string": "idx=113",
            "language_name": {
                "English": "Náhuatl, Guerrero",
                "Spanish": "Náhuatl de Guerrero",
                "Portuguese": "",
                "French": "",
                "Dutch": "",
                "German": "",
                "Chinese": "",
                "Korean": "나후아틀, 게레로",
                "Russian": "Науатль, Герреро",
                "Arabic": "",
                "minority": ""
            },
            "alternate_language_count": 6,
            "alternate_language_names": {
                "0": "Náhuatl (Nauatl; Azteca) de Guerrero Central",
                "1": "Mexicano (Mejicano) de Guerrero Central",
                "2": "Nahuatl, Guerrero",
                "3": "Guerrero Aztec",
                "4": "Mexicano de Guerrero",
                "5": "Xalitla Nahuatl"
            },
            "country_count": 1,
            "countries_names": {
                "0": "Mexico"
            },
            "countries_codes": {
                "0": "MX"
            },
            "se_apps": {
                "android": 6,
                "ios": 1
            },
            "se_sab": {
                "text": 1095,
                "audio": 0,
                "video": 0
            },
            "se_online_viewer": 1,
            "se_media": {
                "text": 33,
                "ePub": 0,
                "audio": 187,
                "video": 0,
                "playlist_audio": 1,
                "playlist_video": 4
            },
            "se_download_media": {
                "text": 33,
                "audio": 187,
                "video": 0,
                "playlist_video": 3
            },
            "se_google_play": 1,
            "se_other_software": {
                "GoBible": 1,
                "MySword": 0,
                "theWord": 1
            },
            "links_media": {
                "Bible.is": 2,
                "Bible.is_Gospel_Film": 1,
                "YouVersion": 2,
                "eBible": 1,
                "GRN": 1
            },
            "buy": 1,
            "maps": 1,
            "watch": 1,
            "websites": 0,
            "other_titles": 1,
            "SIL_link": 1
        }
    }
}

same as records.php but pulls the counts of all of the ISO 639-3 products

To get at least 3 letters for English language names and alternate language names starting at the beginning of the words

• With the ?v=1&key=[your key], you will also need
• partial language names (type ‘&ln=[partial language names]’)

will pull out

• English language names
• ISO 639-3 codes
• ROD codes
• variant codes
• variant names
• index numbers
• alternate language numbers
• alternate language names
• country names
• coumtry codes

To get the country:

• With the ?v=1&key=[your key], you will also need
• English country name (type ‘&country=[English country name]’)
•     OR
• country code (type ‘&cc=[country code]’)

will pull out

• English country name
• country code
• ISO 639-3 code
• ROD code
• variant code
• variant name
• index number
• English language name
• alternate language numbers
• alternate language names

To get at least 2 letters starting at the beginning of the word

• With the ?v=1&key=[your key], you will also need
• partial country name in English (type ‘&pc=[partial country name]’)
•     OR
• partial country name and major language (type '&pc=[partial country name]&ml=[English, Spanish, Portuguese, French, Dutch, German, Chinese, Russian, Korean, or Arabic]’)

will pull out

• country name
• country code
• ISO 639-3 code
• ROD code
• variant code
• variant name
• index number
• English language name
• alternate language numbers
• alternate language names

To get all the countries

• v=1&key=[your key]
• optional: major language (type '&ml=[English, Spanish, Portuguese, French, Dutch, German, Chinese, Russian, Korean, or Arabic]’)

will pull out

• country names
• country codes

To get the subfamily(ies)

• With the ?v=1&key=[your key], you will also need
• all of the elements of the ISOs of the subfamilies (type ‘&all=subfamilies’)
•     OR
• only the ISOs of the subfamilies (type ‘&all=justsubfamilies’)
•     OR
• e.g. Náhuatl (the ISOs within that subfamily) (type ‘&subfamily=[the particular name of the subfamily]’)

will pull out

• total countries for the subfamily
• ISO 639-3 codes
• ROD codes
• variant codes
• variant names
• index numbers
• language names
• individual countries based on the language name

To get the ScriptureEarth media:

• With the ?v=1&key=[your key], you will also need
• index number (type ‘&idx=[index number]’)
•     OR
• ISO 639-3 code (type ‘&iso=[ISO code]’)
•     OR
• ISO 639-3 code and ROD code [and variant code] (type ‘&iso=[ISO code]&rod=[ROD code][&var=[variant code]]’)

will pull out all of the ScriptureEarth URLs for

• ISO 639-3 code
• ROD code
• variant code
• variant name
• index number
• texts (OT and NT PDFs)
• audio (OT and NT audio recordings)
• videos (OT and NT video recordings)
• audio playlists
• video playlists
• theWord (Windows OS)
• online viewer

To get the links:

• With the ?v=1&key=[your key], you will also need
• index number (type ‘&idx=[index number]’)
•     OR
• ISO 639-3 code (type ‘&iso=[ISO code]’)
•     OR
• ISO 639-3 code and ROD code [and variant code] (type ‘&iso=[ISO code]&rod=[ROD code][&var=[variant code]]’)

will pull out the general URLs for

• Bible.is (Faith Comes by Hearing)
• Read
• Read and Listen
• Read, Listen, and View
• LUMO Bible.is Gospel Film (Faith Comes by Hearing)
• YouVersion (Bible.com)
• Global Recordings Network (GRN)
• eBible
• Watch full videos from websites other than ScriptureEarth.org
  • Jesus Film
  • Scripture YouTube videos
  • other Scripture videos

To get the Android, iOS, or both apps:

• With the ?v=[1 or 2]&key=[your key], you will also need
• index number (type ‘&idx=[index number]’)
•     OR
• ISO 639-3 code (type ‘&iso=[ISO code][&rel=[android OR ios]]’
•     OR
• All the ISO 639-3 codes (type ‘&iso=ALL[&rel=[android OR ios]]’)
•     OR
• ISO 639-3 code and ROD code [and variant code] (type ‘&iso=[ISO code]&rod=[ROD code][&var=[variant code]][&rel=[android OR ios]]’)
•     OR
• country code or country with either Android, iOS, or both (type '&cc=[country code]' OR '&country=[English country name]'[&rel=[android OR ios]])

will pull out

• ISO 639-3 code(s)
• ROD code(s)
• variant code(s)
• variant name(s)
• index number(s)
• links to Android apps
• link to iOS Asset Package

version 2 will add

• the descriptions of each link

apps.php will look like (https://scriptureearth.org/api/apps.php?v=2&key=[your key]&cc=MX):

To get the language name(s) and mobile devices:

• With the ?v=1&key=[your key], you will also need
• index number (type ‘&idx=[index number]’)
•     OR
• ISO 639-3 code (type ‘&iso=[ISO code]’)
•     OR
• ISO 639-3 code and ROD code [and variant code] (type ‘&iso=[ISO code]&rod=[ROD code][&var=[variant code]]’)
•     OR
• country code with either the Android app (apk) and iOS Assent Package, or both (type '&cc=[country code][[&rel=ios or android]]')

will pull out

• ISO 639-3 code(s)
• ROD code(s)
• variant code(s)
• variant name(s)
• index number(s)
• English language name(s)
• [iOS and/or Android for the country code]
  • [title]
  • [file name]
  • [optional]

languageNames.php will look like (https://scriptureearth.org/api/languageNames.php?v=2&key=[your key]&cc=MX&rel=ios):

To get the SAB HTML:

• With the ?v=1&key=[your key], you will also need
• index number (type ‘&idx=[index number]’)
•     OR
• ISO 639-3 code (type ‘&iso=[ISO code]’)
•     OR
• ISO 639-3 code and ROD code [and variant code] (type ‘&iso=[ISO code]&rod=[ROD code][&var=[variant code]]’)

will pull out

• ISO 639-3 code
• ROD code
• variant code
• variant name
• index number
• path to the HTML files
• all of the HTML files

To get the other ScritureEarth items:

• With the ?v=1&key=[your key], you will also need
• index number (type ‘&idx=[index number]’)
•     OR
• ISO 639-3 code (type ‘&iso=[ISO code]’)
•     OR
• ISO 639-3 code and ROD code [and variant code] (type ‘&iso=[ISO code]&rod=[ROD code][&var=[variant code]]’)

will pull out

• ISO 639-3 code
• ROD code
• variant code
• variant name
• index number
• path to the other PDF/ePub or audio SE files
• all of the other PDF/ePub or audio SE files

To get the website links:

• With the ?v=1&key=[your key], you will also need
• index number (type ‘&idx=[index number]’)
•     OR
• ISO 639-3 code (type ‘&iso=[ISO code]’)
•     OR
• ISO 639-3 code and ROD code [and variant code] (type ‘&iso=[ISO code]&rod=[ROD code][&var=[variant code]]’)

will pull out

• ISO 639-3 code
• ROD code
• variant code
• variant name
• index number
• all of the website links (e.g., Kalaam Media, OneStory, iTunes, Facebook, Deaf Bibles, SIL Papua New Guinea, and other links)

To get the downloadable media:

• With the ?v=1&key=[your key], you will also need
• index number (type ‘&idx=[index namer]’)
•     OR
• ISO 639-3 code (type ‘&iso=[ISO code]’)
•     OR
• ISO 639-3 code and ROD code [and variant code] (type ‘&iso=[ISO code]&rod=[ROD code][&var=[variant code]]’)

will pull out

• ISO 639-3 code
• ROD code
• variant code
• variant name
• index number
• path to the files (audio, video, PDF, and study folders)
• all of the downloadable SE files (OT and NT audio files, playlist audio files, playlist video files, PDF files, The Word for Windows, etc.)