JDJ Labs Indian News API Documentation

Overview

The JDJ Labs IndianNews API provides a simple and flexible way to access news articles from various sources, categorized by different topics. This documentation outlines the usage of the API’s primary endpoint: /indianNews.

Endpoint Details

• Endpoint: /indianNews
• Method: GET
• Base URL: https://indian-news1.p.rapidapi.com
• Headers:
  X-RapidAPI-Key: 'SIGN-UP-FOR-KEY'
X-RapidAPI-Host: 'indian-news1.p.rapidapi.com'

Request Parameters

The /indianNews endpoint supports the following optional query parameters:

1. size (optional): Specifies the number of news articles to retrieve. If not provided, the default size may be used.

   Example: size=1

2. cat (optional): Specifies the category of news articles to retrieve. If not provided, the response will include news articles from all available categories.

   Example:
   cat=business ,
   topNews ,
   trending,
   international,
   politics,
   business,
   sports,
   entertainment,
   technology,
   auto,
   fashion,
   travel,
   education

Example Request

GET /indianNews? HTTP/1.1
X-Rapidapi-Key: SIGN-UP-FOR-KEY
X-Rapidapi-Host: indian-news1.p.rapidapi.com
Host: indian-news1.p.rapidapi.com

Or

GET /indianNews?size=1&cat=topNews HTTP/1.1
X-Rapidapi-Key: SIGN-UP-FOR-KEY
X-Rapidapi-Host: indian-news1.p.rapidapi.com
Host: indian-news1.p.rapidapi.com

Response

The API response will be a JSON object containing an array of news articles based on the specified parameters. Each article will include relevant information such as title, source, publication date, and content.

Example Response with Parameters

{
    "indianNews": {
        "business": {
            "articles": [
                {
                    "author": "Ravindra Sonavane",
                    "content": "It's been a dream run on D-Street. As 2023 nears its end, the market rally has not only attracted a record number of retail investors to equities, but also triggered a rush among promoters to take th… [+3221 chars]",
                    "description": "The IPO rally is continuing with Rs 60,000 crore worth of share sales lined up for the new year. This includes big-ticket offerings from companies like Paytm, Zomato, and Nykaa.",
                    "publishedAt": "2023-12-22T02:16:40Z",
                    "source": {
                        "name": "Moneycontrol"
                    },
                    "title": "IPO rally stays the course with Rs 60,000-cr share sales lined up for new year - Moneycontrol",
                    "url": "https://www.moneycontrol.com/news/business/ipo/ipo-rally-stays-the-course-with-rs-60000-cr-share-sales-lined-up-for-new-year-11941081.html",
                    "urlToImage": "https://images.moneycontrol.com/static-mcnews/2023/12/Stock-Market-1-4-770x433.jpg"
                }
            ],
            "status": "ok",
            "totalResults": 1
        }
    }
}

If no parameters are provided, the response will include news articles from all available categories.

Example Response without Parameters

{
    "indianNews": {
        "topNews": {
            "articles": [
                {
                    "content": "The cold dark winters and the bright sunny summers of Antarctica holds a secret in the ionosphere that scientists have traced recently. The day-night ionospheric density varied regardless of 24 hours… [+2289 chars]",
                    "description": "Ionospheric research in Antarctica can help improve satellite-based navigation systems.",
                    "publishedAt": "2023-12-22T06:28:17Z",
                    "source": {
                        "name": "Dst.gov.in"
                    },
                    "title": "Ionospheric secrets traced in the White continent can help satellite-based navigation - Department Of Science & Technology",
                    "updated": "1",
                    "url": "https://dst.gov.in/ionospheric-secrets-traced-white-continent-can-help-satellite-based-navigation",
                    "urlToImage": "https://dst.gov.in/sites/default/files/Ionospheric%20secrets.png"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "trending": {
            "articles": [
                {
                    "author": "Andrew Birkle",
                    "content": "Detroit Pistons fans have had enough.\r\nAs the Pistons fell apart late in their 119-111 loss to the Utah Jazz on Thursday their 25th straight after starting the season 2-1 a relatively loud \"Sell the … [+1140 chars]",
                    "description": "After the Detroit Pistons' 25th consecutive loss, fans chanted \"Sell the team\" at owner Tom Gores. This is the Pistons' longest losing streak since 1980.",
                    "publishedAt": "2023-12-22T02:53:08Z",
                    "source": {
                        "name": "Detroit Free Press"
                    },
                    "title": "Fans chant for Detroit Pistons owner Tom Gores to 'Sell the team' after 25th straight loss - Detroit Free Press",
                    "url": "https://www.freep.com/story/sports/nba/pistons/2023/12/21/fans-chant-sell-the-team-detroit-pistons-owner-tom-gores-25-straight-losses-utah-jazz/72006598007/",
                    "urlToImage": "https://www.freep.com/gcdn/presto/2023/04/06/PDTF/03caa664-d50c-4499-8796-132bb897bec0-04052023_pistons-51.jpg?crop=2399,1349,x0,y0&width=2399&height=1349&format=pjpg&auto=webp"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "international": {
            "articles": [
                {
                    "author": "",
                    "content": "The offseason remains relatively slow for Major League Baseball and we're entering the \"holiday break\" zone where generally not a lot of stuff happens around Christmas and the New Year. There is stil… [+4018 chars]",
                    "description": "The Giants are out of the running for Japanese pitcher Yoshinobu Yamamoto. The Yankees have signed former closer Aroldis Chapman.",
                    "publishedAt": "2023-12-22T00:24:00Z",
                    "source": {
                        "name": "CBS Sports"
                    },
                    "title": "MLB rumors: Giants eliminated from Yoshinobu Yamamoto sweepstakes, Yankees sign familiar name - CBS Sports",
                    "url": "https://www.cbssports.com/mlb/news/mlb-rumors-giants-eliminated-from-yoshinobu-yamamoto-sweepstakes-yankees-sign-familiar-name/",
                    "urlToImage": "https://sportshub.cbsistatic.com/i/r/2023/12/21/3acd707d-3619-4197-8b4f-c3822476fad1/thumbnail/1200x675/a6c7a2b2a4544957a6e36325d9c54d6a/yamamoto-getty-4.png"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "politics": {
            "articles": [
                {
                    "author": "Express News Service",
                    "content": "As Parliament adjourned sine dine on Thursday, a day ahead of schedule, this is what went down: the government pushed through Bills that revamped the criminal justice system, a Bill on the appointmen… [+4172 chars]",
                    "description": "Congress begins preparations for 2019 Lok Sabha elections while INDIA bloc protests at Jantar Mantar against rising fuel prices.",
                    "publishedAt": "2023-12-22T02:09:33Z",
                    "source": {
                        "name": "The Indian Express"
                    },
                    "title": "Today in Politics: Congress to take first steps in LS polls prep, INDIA bloc protest at Jantar Mantar",
                    "url": "https://indianexpress.com/article/political-pulse/today-in-politics-congress-lok-sabha-polls-preparations-9078399/",
                    "urlToImage": "https://images.indianexpress.com/2023/12/todayinpolitics.jpg"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "business": {
            "articles": [
                {
                    "author": "Ravindra Sonavane",
                    "content": "It's been a dream run on D-Street. As 2023 nears its end, the market rally has not only attracted a record number of retail investors to equities, but also triggered a rush among promoters to take th… [+3221 chars]",
                    "description": "The IPO rally is continuing with Rs 60,000 crore worth of share sales lined up for the new year. This includes big-ticket offerings from companies like Paytm, Zomato, and Nykaa.",
                    "publishedAt": "2023-12-22T02:16:40Z",
                    "source": {
                        "name": "Moneycontrol"
                    },
                    "title": "IPO rally stays the course with Rs 60,000-cr share sales lined up for new year - Moneycontrol",
                    "url": "https://www.moneycontrol.com/news/business/ipo/ipo-rally-stays-the-course-with-rs-60000-cr-share-sales-lined-up-for-new-year-11941081.html",
                    "urlToImage": "https://images.moneycontrol.com/static-mcnews/2023/12/Stock-Market-1-4-770x433.jpg"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "sports": {
            "articles": [
                {
                    "author": "HT Sports Desk",
                    "content": "Team India scripted another clinical performance on Thursday to cap off a decent white-ball campaign in South Africa. After a 1-1 draw against the home team in the three-match T20I series, the KL Rah… [+2075 chars]",
                    "description": "During the third ODI between India and West Indies, Rahul Dravid and Kieron Pollard had a stump-mic chat about 'Ram Siya Ram'. Rahul Dravid said that he used to chant 'Ram Siya Ram' during his playing days.",
                    "publishedAt": "2023-12-22T02:44:23Z",
                    "source": {
                        "name": "Hindustan Times"
                    },
                    "title": "Watch: Rahul-Maharaj's viral stump-mic chat over 'Ram Siya Ram' in 3rd ODI - Hindustan Times",
                    "url": "https://www.hindustantimes.com/cricket/watch-kl-rahul-keshav-maharaj-stump-mic-chat-over-ram-siya-ram-during-3rd-ind-vs-sa-odi-breaks-the-internet-101703209759799.html",
                    "urlToImage": "https://www.hindustantimes.com/ht-img/img/2023/12/22/1600x900/maharaj_rahl_1703210014285_1703210020827.jpg"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "entertainement": {
            "articles": [
                {
                    "author": "Livemint",
                    "content": "Salaar box office collection Day 1: The highly anticipated action thriller Salaar, starring Prabhas and Prithviraj Sukumaran, will hit the theatres early this morning, and early box office estimates … [+2222 chars]",
                    "description": "Prabhas's movie Salaar minted ₹48 crore on its first day at the box office. The movie is expected to be a pan-India success.",
                    "publishedAt": "2023-12-22T02:42:45Z",
                    "source": {
                        "name": "Livemint"
                    },
                    "title": "Salaar box office collection Day 1: Prabhas' movie mints ₹48 crore, eyes pan-India success | Mint - Mint",
                    "url": "https://www.livemint.com/industry/media/salaar-box-office-collection-day-1-prabhas-movie-mints-rs-48-crore-eyes-pan-indian-success-11703210081852.html",
                    "urlToImage": "https://www.livemint.com/lm-img/img/2023/12/22/1600x900/m1_1693461004532_1703212018902.jpg"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "technology": {
            "articles": [
                {
                    "author": "Reuters",
                    "content": "Microsoft's plan to end support for Windows 10 operating system could result in about 240 million personal computers (PCs) being disposed, potentially adding to landfill waste, Canalys Research said.… [+1696 chars]",
                    "description": "Microsoft's decision to end support for Windows 10 could force 240 million PCs to be thrown away, according to a new report.",
                    "publishedAt": "2023-12-22T04:31:53Z",
                    "source": {
                        "name": "BusinessLine"
                    },
                    "title": "Microsoft ending support for Windows 10 could send 240 mn PCs to landfills: report - BusinessLine",
                    "url": "https://www.thehindubusinessline.com/info-tech/microsoft-ending-support-for-windows-10-could-send-240-mn-pcs-to-landfills-report/article67664874.ece",
                    "urlToImage": "https://bl-i.thgim.com/public/incoming/akaaj5/article67664888.ece/alternates/LANDSCAPE_1200/image%20%2816%29.jpg"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "auto": {
            "articles": [
                {
                    "author": "Murilee Martin",
                    "content": "If there's one thing the Oldsmobile Division did well during its final couple of decades, it was special-edition cars. Just looking at cars I've documented for this series, we have the XC Edition Cut… [+2076 chars]",
                    "description": "The 1999 Oldsmobile Eighty-Eight 50th Anniversary Edition is a rare find in junkyards. It's a stylish car with a powerful engine and a comfortable ride. It's also a good value for the price.",
                    "publishedAt": "2023-12-21T21:00:00Z",
                    "source": {
                        "name": "Autoblog"
                    },
                    "title": "Junkyard Gem: 1999 Oldsmobile Eighty-Eight 50th Anniversary Edition",
                    "url": "https://www.autoblog.com/2023/12/21/junkyard-gem-1999-oldsmobile-eighty-eight-50th-anniversary-edition/",
                    "urlToImage": "https://s.aolcdn.com/images/dims3/GLOB/legacy_thumbnail/1062x597/format/jpg/quality/100/https://s.aolcdn.com/os/ab/_cms/2023/11/21174153/99-1999-Oldsmobile-88-in-Colorado-junkyard-photo-by-Murilee-Martin.jpg"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "fashion": {
            "articles": [
                {
                    "author": "Lakshmi Varanasi",
                    "content": "\"Home Alone's\" 8-year-old hero, Kevin McCallister, defends his family's home from burglars when they accidentally leave him at home alone over the holidays. 20th Century Fox\r\n<ul><li>The classic holi… [+3256 chars]",
                    "description": "The McCallisters from \"Home Alone\" would have had a net worth of $10.7 million in 2018, which would have put them in the top 1% of earners in the United States.",
                    "publishedAt": "2023-12-21T18:16:14Z",
                    "source": {
                        "id": "business-insider",
                        "name": "Business Insider"
                    },
                    "title": "The 'Home Alone' family would have been one-percenters, Fed economists have calculated",
                    "url": "https://www.businessinsider.com/home-alone-family-rich-top-one-percent-fed-report-2023-12",
                    "urlToImage": "https://i.insider.com/658468d8cefc010bea2645d6?width=1200&format=jpeg"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "travel": {
            "articles": [
                {
                    "author": "harish.jonnalagadda@futurenet.com (Harish Jonnalagadda)",
                    "content": "Audeze is a brand that needs no introduction; the American audio manufacturer is well-known for its range of planar headphones, and its products have a unique design that's immediately recognizable. … [+9093 chars]",
                    "description": "The Audeze MM-500 headphones are a masterpiece of sound, with their accurate reproduction of music and immersive soundstage. They're expensive, but worth it for the discerning listener.",
                    "publishedAt": "2023-12-22T05:03:50Z",
                    "source": {
                        "name": "Android Central"
                    },
                    "title": "Audeze MM-500 review: A $1,699 masterpiece",
                    "url": "https://www.androidcentral.com/accessories/audio/audeze-mm-500-review",
                    "urlToImage": "https://cdn.mos.cms.futurecdn.net/ASqr5sTmWTveZE2d7kVaXQ-1200-80.jpg"
                }
            ],
            "status": "ok",
            "totalResults": 1
        },
        "education": {
            "articles": [
                {
                    "author": "BeauHD",
                    "content": "It will take 283 years for female representation in IT to make up an equal share of the tech workforce in the UK, according to a report from the British Computer Society, the chartered institute for … [+1484 chars]",
                    "description": "Despite progress, women in IT will take 283 years to reach parity, warns BCS, the Chartered Institute for IT.",
                    "publishedAt": "2023-12-22T00:02:00Z",
                    "source": {
                        "name": "Slashdot.org"
                    },
                    "title": "Women In IT Are On a 283-Year March To Parity, BCS Warns",
                    "url": "https://it.slashdot.org/story/23/12/21/2228202/women-in-it-are-on-a-283-year-march-to-parity-bcs-warns",
                    "urlToImage": "https://a.fsdn.com/sd/topics/uk_64.png"
                }
            ],
            "status": "ok",
            "totalResults": 1
        }
    }
}

Error Handling

In case of errors, the API will return an appropriate HTTP status code along with an error message in the response body.

Example Error Response

{
    "status": "error",
    "code": 400,
    "message": "Bad Request - Invalid category provided."
}

Rate Limiting

To ensure fair usage, the API may implement rate limiting. Exceeding the allowed rate limit will result in a 400 Too Many Requests response.

Conclusion

The JDJ Labs Indian News API /indianNews endpoint provides a straightforward way to access and retrieve news articles based on optional parameters. Developers are encouraged to explore and integrate this API into their applications to enrich content with the latest news information.