NAV Navbar

Introduction

The AccuNews API provides you with a simple and powerful HTTP REST API for fetching both latest local news articles in a specific geographic region or popular and world news articles, accross various Web Publishers, TV Stations, Radio Stations, Newspapers & Blogs etc.

Features Include:

Pagination & Limits

All GET endpoints which return an object list, support cursor based pagination with pagination in the form of next and previous keys. This means that to get all objects, you need to paginate through the results by always using the next key provided. To make it easier, the API will construct the next url and all you have to do is call the value of next. You know that you have paginated all the results when the response’s next is empty or null. While using cursor based pagination might seem weird compared to many APIs it protects from the situation when the resulting object list changes during pagination (new resource gets added or removed).

Default limit is set to 50 for article endpoints but values up to 100 are permitted. You can always find the default limit value on the respective documentation for each endpoint.

If an endpoint has a query string parameter with a min or max value, any value passed in which is above the max will default to the max and vice versa for min.

Restrictions & Rate Limits

The AccuNews API is rate limited to prevent abuse that would degrade our ability to maintain consistent API performance for all users. By default, each API key or app is rate limited at 60 requests per minute and 1000 requests a day. If your requests are being rate limited, HTTP response code 429 Too Many Requests will be returned.

Features such as the ability to set custom radius and the presence of cetrains data e.g. coords & address in Articles and Source response objects are currently available to all. But maybe available to only AccuNews Partners in the future.

Authentication

To get an API Key programmatically, use this code:

curl -d '{"email":"email", "password":"password"}' -H "Content-Type: application/json" -X POST https://wwww.accunewsapp.com/api/v1/auth/

The above request returns JSON structured like this:

{
    "email": "testemail@example.com",
    "apiKey": "ac2690a8378sdfks56skd98"
}

We use API Keys to allow access to all API endpoints. You can receive a new API key by sending a POST request to the endpoint below or using the form below.

Get API Key

POST https://www.accunewsapp.com/api/v1/auth/

Body Description
email Email address required for API Key generation
password Password required for API Key generation

Articles

Get Local News Articles By Location

Retrieve local news articles in the Tampa Bay Area:

curl "https://www.accunewsapp.com/api/v1/articles/?lon=-82.452606&lat=27.964157&apiKey=myAPIKey"

The above command returns JSON structured like this:

{
    "next": "https://www.accunewsapp.com/api/v1/articles/?cursor=cD0yMDE4LTEwLTA5KzIyJTNBMzUlM0ExNyUyQjAwJTNBMDA%3D&lat=27.964157&lon=-82.452606&apiKey=myAPIKey",
    "previous": null,
    "results": [
        {
            "title": "Woman, child killed during apparent domestic dispute in Tampa",
            "link": "http://www.wfla.com/video/woman-child-killed-during-apparent-domestic-dispute-in-tampa_20181022035028/1540944319",
            "time": "2018-10-22T03:50:36Z",
            "image": "https://media.wfla.com/nxs-wflatv-media-us-east-1/photo/2018/10/21/Woman__child_killed_during_apparent_dome_2_59796372_ver1.0_1280_720.jpg",
            "summary": "",
            "readtime": null,
            "source": {
                "name": "WFLA",
                "icon": "http://www.wfla.com/nxs-main-v2-theme/images/color_schemes/wfla/apple-touch-icon.png",
                "coords": {
                    "type": "Point",
                    "lat": 27.9450345,
                    "lon": -82.4604669
                },
                "address": "200 S Parker St, Tampa, FL 33606, USA"
            }
        },
        {
            "title": "DeSantis says he was added to racist Facebook group without consent",
            "link": "http://www.wfla.com/video/desantis-says-he-was-added-to-racist-facebook-group-without-consent_20181022024650/1540874343",
            "time": "2018-10-22T02:46:53Z",
            "image": "https://media.wfla.com/nxs-wflatv-media-us-east-1/photo/2018/10/21/DeSantis_says_he_was_added_to_racist_Fac_0_59789934_ver1.0_1280_720.jpg",
            "summary": "DeSantis says he was added to racist Facebook group without consent (CNN)",
            "readtime": "1 min read",
            "source": {
                "name": "WFLA",
                "icon": "http://www.wfla.com/nxs-main-v2-theme/images/color_schemes/wfla/apple-touch-icon.png",
                "coords": {
                    "type": "Point",
                    "lat": 27.9450345,
                    "lon": -82.4604669
                },
                "address": "200 S Parker St, Tampa, FL 33606, USA"
            }
        },
        "..."
      ]
}

This endpoint retrieves latest local news articles around a specific city/location.

HTTP Request

GET https://www.accunewsapp.com/api/v1/articles/?lon=<lon>&lat=<lat>&apiKey=myAPIKey

Query Parameters

Parameter Default Description
lat None Latitude for city/place/location to retrieve local news articles from.
lon None Longitude for city/place/location to retrieve local news articles from.
apiKey None Registered API User apiKey.
radius 50 Radius in miles (Max - 300mi)
limit 50 Number of articles to return (Max 100)

Retrieve latest news articles from popular sources:

curl "https://www.accunewsapp.com/api/v1/articles/?popular=true&apiKey=myAPIKey"

The above command returns JSON structured like this:

{
    "next": "https://www.accunewsapp.com/api/v1/articles/?cursor=cD0yMDE4LTEwLTE0KzE4JTNBMDAlM0EwMCUyQjAwJTNBMDA%3D&apiKey=myAPIKey&popular=true",
    "previous": null,
    "results": [
        {
            "title": "Thousands of caravan migrants reach Mexico",
            "link": "https://www.bbc.co.uk/news/world-us-canada-45936816",
            "time": "2018-10-22T03:32:52Z",
            "image": "http://c.files.bbci.co.uk/91E1/production/_103954373_p06phq0m.jpg",
            "summary": "Despite initial efforts from Mexico to block them at the border with Guatemala, most have entered illegally by boat.",
            "readtime": "1 min read",
            "source": {
                "name": "BBC News",
                "icon": "http://static.bbci.co.uk/wwhp/1.128.0/responsive/img/apple-touch/apple-touch-180.jpg",
                "coords": {
                    "type": "Point",
                    "lat": 51.5100255,
                    "lon": -0.2268465
                },
                "address": "Television Centre Wood Lane London W12 7TQ"
            }
        },
        {
            "title": "Stephen Hawking's Wheelchair and PhD Thesis Are up for Sale",
            "link": "http://time.com/5430707/stephen-hawking-auction-christies/",
            "time": "2018-10-22T03:32:11Z",
            "image": "https://timedotcom.files.wordpress.com/2018/10/ap18292425442381.jpg?quality=85",
            "summary": "(LONDON) — Stephen Hawking was a cosmic visionary, a figure of inspiration and a global celebrity.\n\nHis unique status is reflected in an upcoming auction of some of the late physicist’s possessions: It includes complex scientific papers, one of the world’s most iconic wheelchairs and a script from “The Simpsons.”\n\nThe online sale announced Monday by auctioneer Christie’s features 22 items from Hawking, including his doctoral thesis on the origins of the universe, some of his many awards, and scientific papers such as “Spectrum of Wormholes” and “Fundamental Breakdown of Physics in Gravitational Collapse.”\n\nThomas Venning, head of Christies’ books and manuscripts department, said the papers “trace the development of his thought — this brilliant, electrifying intelligence.”\n\n“You can see each advance as he produced it and introduced it to the scientific community,” Venning said.\n\nOf course, Hawking’s fame rests only partly on his scientific status as the cosmologist who put black holes on the map.\n\nDiagnosed with motor neuron disease at 22 and given just a few years to live, he survived for decades, dying in March at 76.\n\nThe auction includes one of five existing copies of Hawking’s 1965 Cambridge University Ph.D. thesis, “Properties of Expanding Universes,” which carries an estimated price of 100,000 pounds to 150,000 pounds ($130,000 to $195,000).\n\nVenning said the thesis, signed by Hawking in handwriting made shaky by his illness, is both a key document in the physicist’s scientific evolution and a glimpse into his personal story.\n\n“He was diagnosed with ALS (amyotrophic lateral sclerosis) just as he arrived in Cambridge to begin his Ph.D. studies,” Venning said.",
            "readtime": "3 min read",
            "source": {
                "name": "Time",
                "icon": "http://www.time.com/img/favicons/favicon-57.png",
                "coords": {
                    "type": "Point",
                    "lat": 40.7123955,
                    "lon": -74.0154171
                },
                "address": "225 Liberty in New York's Financial District"
            }
        }
        "..."
      ]
}

This endpoint retrieves top stories and latest articles from popular news sources around the world. Sources include, Al Jazeera, CNN, Fox News, BBC, USA Today...

HTTP Request

GET https://www.accunewsapp.com/api/v1/articles/?popular=True&apiKey=myAPIKey&limit=30

Query Parameters

Parameter Default Description
popular None You can pass in a value of True or true to retrieve articles from popular sources
apiKey None Registered API User apiKey.
limit 50 Optional number of articles to return (Max 100)

Retrieve latest news articles from popular sources:

curl "https://www.accunewsapp.com/api/v1/articles/?popular=true&lon=-82.452606&lat=27.964157&apiKey=myAPIKey"

The above command returns JSON structured like this:

{
    "next": "https://www.accunewsapp.com/api/v1/articles/?cursor=cD0yMDE4LTEwLTE0KzE4JTNBNTUlM0EzOCUyQjAwJTNBMDA%3D&lat=27.964157&lon=-82.452606&apiKey=myAPIKey&popular=true",
    "previous": null,
    "results": [
        {
            "title": "Vietnam's Communist Party chief set to become president",
            "link": "https://www.aljazeera.com/news/2018/10/vietnam-communist-party-chief-set-president-181018075230534.html",
            "time": "2018-10-22T03:53:42Z",
            "image": "https://www.aljazeera.com/mritems/Images/2018/10/18/040c11d753034ee394581f8eefd34db7_18.jpg",
            "summary": "Ho Chi Minh City, Vietnam - Nguyen Phu Trong, the general secretary of Vietnam's ruling Communist Party, is expected to be chosen as the country's next president when the one-party state's rubber-stamp National Assembly meets on Monday, making him the first person since founding father Ho Chi Minh to hold both posts.\n\nTrong, 74, is the only candidate to succeed Tran Dai Quang, who died last month following a serious illness.\n\nUnder Vietnam's political system, the country follows what it calls \"balanced leadership\" with no overall leader and the general secretary, president, prime minister and National Assembly chairperson all acting as a check and balance on each other.\n\nNevertheless, while the presidency is a largely ceremonial position, it is likely to strengthen Trong's political clout at a time when he is leading a crackdown on high-level corruption that has snared business people, state executives, and even a member of the politburo.\n\n'Very confident'\n\n\"If it [merging the presidency and the general secretary role] is going to be permanent, that says that Trong is very confident, not just in his own power, but in the power of getting his protege to be the next general secretary,\" said Zachary Abuza, a professor at the National War College in Washington DC who specialises in Southeast Asian political and security issues.\n\n\"If there was any doubt in his mind, he would keep these positions separate.\"\n\nVice President Dang Thi Ngoc Thinh is currently the country's acting president and Vietnam's first female head of state, but she has not been put forward as a candidate in the election, which will be decided by a secret ballot of the assembly. The new president will be sworn in immediately afterwards with the ceremony broadcast live on television.\n\nThe likelihood of Trong becoming both general secretary and president has drawn comparisons to China's Xi Jinping...",
            "readtime": "3 min read",
            "source": {
                "name": "Al Jazeera English",
                "icon": "https://www.aljazeera.com/mritems/assets/images/touch-icon-ipad-retina.png",
                "coords": {
                    "type": "Point",
                    "lat": 25.3186961,
                    "lon": 51.4940047
                },
                "address": "Khalifa Street 23123 Doha QATAR"
            }
        },
        {
            "title": "Woman, child killed during apparent domestic dispute in Tampa",
            "link": "http://www.wfla.com/video/woman-child-killed-during-apparent-domestic-dispute-in-tampa_20181022035028/1540944319",
            "time": "2018-10-22T03:50:36Z",
            "image": "https://media.wfla.com/nxs-wflatv-media-us-east-1/photo/2018/10/21/Woman__child_killed_during_apparent_dome_2_59796372_ver1.0_1280_720.jpg",
            "summary": "",
            "readtime": null,
            "source": {
                "name": "WFLA",
                "icon": "http://www.wfla.com/nxs-main-v2-theme/images/color_schemes/wfla/apple-touch-icon.png",
                "coords": {
                    "type": "Point",
                    "lat": 27.9450345,
                    "lon": -82.4604669
                },
                "address": "200 S Parker St, Tampa, FL 33606, USA"
            }
        },
        "..."
      ]
}

This endpoint retrieves both local news articles from a specific region and top stories from popular news sources around the world.

HTTP Request

GET https://www.accunewsapp.com/api/v1/articles/?popular=true&lon=<lon>&lat<lat>&apiKey=myAPIKey

Query Parameters

Parameter Default Description
popular None You can pass in a value of True or true to retrieve articles from popular sources
lat None Latitude for city/place/location to retrieve local news articles from.
lon None Longitude for city/place/location to retrieve local news articles from.
apiKey None Registered API User apiKey.
radius 50 Optional radius in miles (Max - 300mi)
limit 50 Optional number of articles to return (Max 100)

Get Articles By Mention/Source/Topic

Retrieve articles about Elon Musk:

curl "https://www.accunewsapp.com/api/v1/articles/?apiKey=myAPIKey&keyword=elon%20musk%5C"

The above command returns JSON structured like this:

{
    "next": "https://www.accunewsapp.com/api/v1/articles/?apiKey=myAPIKey&keyword=elon+musk%5C&cursor=AoIIRADbCDluZXdzZmVlZC5hcnRpY2xlLjIwNDYyNzcz",
    "results": [
        {
            "title": "Elon Musk says first tunnel is almost done, opens December 10: tweet",
            "link": "http://feeds.reuters.com/~r/reuters/topNews/~3/Y-rQsusAG6Y/elon-musk-says-first-tunnel-is-almost-done-opens-december-10-tweet-idUSKCN1MW024",
            "time": "2018-10-21T23:37:01Z",
            "image": "https://s4.reutersmedia.net/resources/r/?m=02&d=20181022&t=2&i=1317281616&w=1200&r=LYNXNPEE9L01X",
            "summary": "NEW YORK (Reuters) - A company owned by Elon Musk that is trying to lower the cost of building high-speed transit tunnels is nearing completion on the first tunnel, Musk said on Twitter on Sunday.\n\nFILE PHOTO: Tesla Chief Executive Office Elon Musk speaks at his company's factory in Fremont, California, U.S., June 22, 2012. REUTERS/Noah Berger/File Photo\n\nThe first tunnel, under Hawthorne in the Los Angeles area, is almost done and will open on Dec. 10, Musk said. Privately held Boring Co has been promoting its plans for tunnels that would allow high-speed travel between cities.",
            "readtime": "1 min read",
            "source": {
                "name": "Reuters",
                "icon": "https://s4.reutersmedia.net/resources_v2/images/rcom-default.png",
                "coords": {
                    "type": "Point",
                    "lat": 43.6503406,
                    "lon": -79.38052069999999
                },
                "address": "333 Bay St, Toronto, ON M5H 2R2, Canada"
            }
        },
        {
            "title": "Elon Musk tweeted about a 'dog mode' for Teslas and it's not a terrible idea",
            "link": "http://feeds.mashable.com/~r/Mashable/~3/TZIRuh6Se-s/",
            "time": "2018-10-21T16:00:09Z",
            "image": "https://i.amz.mshcdn.com/HhXYx_hzsPkEqnUQswcpLFoRUG0=/720x480/https%3A%2F%2Fblueprint-api-production.s3.amazonaws.com%2Fuploads%2Fstory%2Fthumbnail%2F82768%2F34f98911-683e-48df-a00c-b55aeec9c8d4.jpg",
            "summary": "<img alt=\"\" src=\"https://i.amz.mshcdn.com/jUamdZXcK3HZfeXgiXz2EQItkT4=/575x323/filters:quality(90)/https%3A%2F%2Fblueprint-api-production.s3.amazonaws.com%2Fuploads%2Fcard%2Fimage%2F867673%2F817476bd-3d35-4045-ad46-d60c065a0e3c.jpg\" /><div style=\"float: right; width: 50px;\"><a href=\"https://twitter.com/share?via=Mashable&text=Elon+Musk+tweeted+about+a+%27dog+mode%27+for+Teslas+and+it%27s+not+a+terrible+idea&url=https%3A%2F%2Fmashable.com%2Farticle%2Ftesla-dog-mode-elon-musk\" style=\"margin: 10px;\"><img alt=\"Twitter\" border=\"0\" src=\"https://a.amz.mshcdn.com/assets/feed-tw-e71baf64f2ec58d01cd28f4e9ef6b2ce0370b42fbd965068e9e7b58be198fb13.jpg\" /></a><a href=\"https://www.facebook.com/sharer.php?u=https%3A%2F%2Fmashable.com%2Farticle%2Ftesla-dog-mode-elon-musk&src=sp\" style=\"margin: 10px;\"><img alt=\"Facebook\" border=\"0\" src=\"https://a.amz.mshcdn.com/assets/feed-fb-8e3bd31e201ea65385a524ef67519d031e6851071807055648790d6a4ca77139.jpg\" /></a></div><p>When a Twitter user asked Elon Musk if future Teslas would include a \"dog mode\" to keep car-bound pets safe and cool while their owner was away, he responded with a simple \"yes.\"</p>\n<div><div><blockquote>\n<p>Yes</p>\n<p>&#8212; Elon Musk (@elonmusk) <a href=\"https://twitter.com/elonmusk/status/1053477064844632064?ref_src=twsrc%5Etfw\">October 20, 2018</a></p>\n</blockquote></div></div>\n<div><p>SEE ALSO: <a href=\"http://mashable.com/video/elon-musk-steps-down-tesla-chairman?utm_campaign&amp;utm_cid=a-seealso&amp;utm_context=textlink&amp;utm_medium=rss&amp;utm_source\">Elon Musk steps down as Tesla chairman: What happens next? &#8212; Technically Speaking</a></p></div>\n<p>The idea behind dog mode, a pitch that in this case also included the Tesla displaying a readout of the car's interior temperature to assure passersby that the pet inside is safe, is definitely within the realm of possibility when it comes to future Tesla features. But it also highlights the fact that electric vehicles like Teslas typically come with a system that regulates internal car temperatures.&#160; <a href=\"https://mashable.com/article/tesla-dog-mode-elon-musk\">Read more...</a></p>More about <a href=\"https://mashable.com/category/tesla/?utm_campaign=Mash-Prod-RSS-Feedburner-All-Partial&amp;utm_cid=Mash-Prod-RSS-Feedburner-All-Partial\">Tesla</a>, <a href=\"https://mashable.com/category/elon-musk/?utm_campaign=Mash-Prod-RSS-Feedburner-All-Partial&amp;utm_cid=Mash-Prod-RSS-Feedburner-All-Partial\">Elon Musk</a>, <a href=\"https://mashable.com/category/electric-vehicles/?utm_campaign=Mash-Prod-RSS-Feedburner-All-Partial&amp;utm_cid=Mash-Prod-RSS-Feedburner-All-Partial\">Electric Vehicles</a>, <a href=\"https://mashable.com/category/tesla-dog-mode/?utm_campaign=Mash-Prod-RSS-Feedburner-All-Partial&amp;utm_cid=Mash-Prod-RSS-Feedburner-All-Partial\">Tesla Dog Mode</a>, and <a href=\"https://mashable.com/category/dogs-in-cars/?utm_campaign=Mash-Prod-RSS-Feedburner-All-Partial&amp;utm_cid=Mash-Prod-RSS-Feedburner-All-Partial\">Dogs In Cars</a>",
            "readtime": "1 min read",
            "source": {
                "name": "Mashable",
                "icon": "https://mashable.com/apple-touch-icon-57x57.png?v=m2Pmw8zNwl",
                "coords": {
                    "type": "Point",
                    "lat": 40.7379058,
                    "lon": -73.9926904
                },
                "address": "114 5th Ave, New York, NY 10011, USA"
            }
        },
        "..."
      ]
}

This endpoint retrieves articles about a specific keyword, company, topic, named entity or articles from a specifc source

HTTP Request

To fetch articles about a mention or topic:

GET https://www.accunewsapp.com/api/v1/articles/?keyword=<keyword>&apiKey=myAPIKey&popular=True

To fetch by a specific source, pass in the domain name as a keyword e.g. to fetch articles by CNN pass in keyword=cnn.com, or for less accurate results pass in keyword=cnn.

GET https://www.accunewsapp.com/api/v1/articles/?keyword=cnn.com&apiKey=myAPIKey

Query Parameters

Parameter Default Description
keyword None Specific keyword for article retrieval.
popular True Retrieve articles from only popular sources.
lat None Optional latitude for location to filter articles about a topic.
lon None Optional longitude for location to filter articles about a topic.
apiKey None Registered API User apiKey.
radius 50 Optional radius in miles (Max - 300mi)
limit 50 Optional number of articles to return (Max 100)

Sources

Get Local News Sources/Publishers By Location

Retrieve local news sources/publishers in the New York area:

curl "https://www.accunewsapp.com/api/v1/sources/?lon=<lon>&lat=<lat>&apiKey=myAPIKey"

The above command returns JSON structured like this:

{
    "next": "https://www.accunewsapp.com/api/v1/sources/?cursor=cD1EYWlseStSZWNvcmQ%3D&lon=-73.935242&lat=40.730610&apiKey=myAPIKey",
    "previous": null,
    "results": [
        {
            "name": "Courier-Post",
            "parent_name": "Gannet Company",
            "homepage": "www.courierpostonline.com",
            "coords": {
                "type": "Point",
                "lat": 39.93948169999999,
                "lon": -75.0504368
            },
            "address": "301 Cuthbert Blvd, Cherry Hill, NJ 08002, USA",
            "icon": "https://www.gannett-cdn.com/sites/courierpostonline/images/site-masthead-logo-dark@2x.png",
            "type": "NEWSPAPER",
            "email": "",
            "phone": "(856) 663-6000",
            "description": "CourierPostOnline.com covers the latest news in South Jersey including Camden, Gloucester & Burlington Counties along with regional coverage of New Jersey.",
            "facebook": "https://www.facebook.com/courierpost/",
            "twitter": "https://twitter.com/intent/user?user_id=21021385",
            "instagram": "http://instagram.com/courierpost/",
            "youtube": null,
            "snapchat": null,
            "pinterest": "http://www.pinterest.com/courierpost/"
        },
        {
            "name": "ABC7 New York",
            "parent_name": "Disney-ABC Television Group",
            "homepage": "www.abc7ny.com",
            "coords": {
                "type": "Point",
                "lat": 40.7738597,
                "lon": -73.98089089999999
            },
            "address": "7 Lincoln Square, New York, NY 10023, USA",
            "icon": "http://cdn.abclocal.go.com/assets/news/wabc/images/logos/touch-icon-152x152.png",
            "type": "TV",
            "email": "",
            "phone": "917-260-7777",
            "description": "New York's source for breaking news and live streaming video online. Covering New York City, New Jersey, Long Island and all of the greater New York Area.",
            "facebook": "https://facebook.com/ABC7NY",
            "twitter": "https://twitter.com/ABC7NY",
            "instagram": null,
            "youtube": null,
            "snapchat": null,
            "pinterest": null
        },
        "..."
    ]
}

This endpoint retrieves latest local news sources/publishers around a specific city/location.

HTTP Request

GET https://www.accunewsapp.com/api/v1/sources/?lon=<lon>&lat=<lat>&apiKey=myAPIKey

Query Parameters

Parameter Default Description
lat None Latitude for city/place/location to retrieve local news sources from.
lon None Longitude for city/place/location to retrieve local news sources from.
apiKey None Registered API User apiKey.
radius 50 Optional radius in miles (Max - 300mi)
limit 10 Number of sources to return (Max 100)

Retrieve details about popular news sources:

curl "https://www.accunewsapp.com/api/v1/sources/?popular=true&apiKey=myAPIKey"

The above command returns JSON structured like this:

{
    "next": "https://wwww.accunewsapp.com/api/v1/sources/?cursor=cD1CbG9vbWJlcmcuY29t&limit=10&popular=true&apiKey=myAPIKey",
    "previous": null,
    "results": [
        {
            "name": "Ars Technica",
            "parent_name": "Conde Nast",
            "homepage": "www.arstechnica.com",
            "coords": {
                "type": "Point",
                "lat": 40.7120719,
                "lon": -74.013395
            },
            "address": "1 World Trade CenterNew York, NY 10006",
            "icon": "https://cdn.arstechnica.net/wp-content/themes/ars/assets/img/ars-ios-icon-d9a45f558c.png",
            "type": "WEB",
            "email": null,
            "phone": null,
            "description": "Serving the Technologist for more than a decade. IT news, reviews, and analysis.",
            "facebook": "https://www.facebook.com/arstechnica",
            "twitter": "https://www.twitter.com/arstechnica",
            "instagram": "https://www.instagram.com/arstechnica",
            "youtube": "https://www.youtube.com/user/arstechnicavideos",
            "snapchat": null,
            "pinterest": null
        },
        {
            "name": "Axios",
            "parent_name": "Axios Media Inc.",
            "homepage": "www.axios.com",
            "coords": {
                "type": "Point",
                "lat": 38.8863497,
                "lon": -77.0952071
            },
             "address": "3100 Clarendon Blvd Suite 200 Arlington, VA 22201 United States",
            "icon": "https://assets.axios.com/icons-023b31e91db1f3ed6ba6184b3117b001/apple-touch-icon-57x57.png",
            "type": "WEB",
            "email": "news@axios.com",
            "phone": "(703) 291-3600",
            "description": "Smart, efficient news worthy of your time, attention, and trust",
            "facebook": "https://www.facebook.com/axiosnews",
            "twitter": "https://www.twitter.com/axios",
            "instagram": "https://www.instagram.com/axios/",
            "youtube": "https://www.youtube.com/axios",
            "snapchat": "https://www.snapchat.com/add/axios",
            "pinterest": null
        },
        "..." 
    ]
}

This endpoint retrieves popular news sources & publishers details from around the world. Sources include, Al Jazeera, CNN, Fox News, BBC, USA Today...

HTTP Request

GET https://www.accunewsapp.com/api/v1/sources/?popular=true&apiKey=myAPIKey

Query Parameters

Parameter Default Description
popular None You can pass in a value of True or true to retrieve articles from popular sources
apiKey None Registered API User apiKey.
limit 50 Optional number of articles to return (Max 100)

Get News Sources by Type

Retrieve Sports News Sources:

curl "https://www.accunewsapp.com/api/v1/articles/?popular=true&lon=-82.452606&lat=27.964157&apiKey=myAPIKey"

The above command returns JSON structured like this:

{
    "next": "https://www.accunewsapp.com/api/v1/sources/?apiKey=3f2b548398c17ec83e21cae82753d7a6331659e5&limit=30&type=sports&cursor=AoIIQBDmQDNuZXdzZmVlZC5zb3VyY2UuMjA5",
    "previous": null,
    "results": [
        {
            "name": "VICE Sports",
            "parent_name": "Vice Media, Inc.",
            "homepage": "sports.vice.com",
            "icon": "https://vice-web-statics-cdn.vice.com/favicons/sports/apple-touch-icon-152x152.png",
            "type": "WEB",
            "coords": {
                "type": "Point",
                "lat": 40.7149544,
                "lon": -73.96619799999999
            },
            "address": "49 S 2nd St New York, New York 11249",
            "email": "editor@vice.com",
            "phone": "(718) 599-3101",
            "description": "Stories beyond the stadium.",
            "facebook": "https://www.facebook.com/vicesports",
            "twitter": "https://twitter.com/VICESports",
            "instagram": "https://instagram.com/vicesports",
            "youtube": "https://www.youtube.com/user/NOC",
            "snapchat": null,
            "pinterest": null
        },
        {
            "name": "ESPN.com",
            "parent_name": "ESPN Inc.",
            "homepage": "www.espn.com",
            "coords": {
                "type": "Point",
                "lat": 41.6490184,
                "lon": -72.90263949999999
            },
            "address": "ESPN Plaza Bristol, CT 06010",
            "icon": "http://a1.espncdn.com/combiner/i?img=%2Fi%2Fespn%2Fespn_logos%2Fespn_red.png",
            "type": "WEB",
            "email": "hello@espn.com",
            "phone": "1-888-549-ESPN",
            "description": "Visit ESPN to get up-to-the-minute sports news coverage, scores, highlights and commentary for NFL, MLB, NBA, College Football, NCAA Basketball and more.",
            "facebook": "https://www.facebook.com/ESPN/",
            "twitter": "https://twitter.com/espn",
            "instagram": "https://www.instagram.com/espn/",
            "youtube": "https://www.youtube.com/channel/UCiWLfSweyRNmLpgEHekhoAg?ex_cid=espn-left-nav-follow-us-youtube",
            "snapchat": "https://www.snapchat.com/discover/ESPN/7296089122",
            "pinterest": null
        }
        "..."
      ]
}

This endpoint retrieves sources by type/genre of the source e.g. business, fashion, sports news sources, or by domain name e.g. wfla.com

HTTP Request

GET https://www.accunewsapp.com/api/v1/sources/?apiKey=myAPIKey&limit=30&type=sports

Query Parameters

Parameter Default Description
type None Type of source/publisher to query for e.g. politics
apiKey None Registered API User apiKey.
limit 10 Optional number of articles to return (Max 100)