[{"data":1,"prerenderedAt":667},["ShallowReactive",2],{"blog-getting-started-with-allnewsapi":3},{"id":4,"title":5,"author":6,"body":7,"date":655,"description":656,"draft":657,"extension":658,"image":659,"meta":660,"navigation":93,"path":661,"seo":662,"sitemap":663,"stem":664,"tags":665,"__hash__":666},"blog\u002Fblog\u002Fgetting-started-with-allnewsapi.md","Getting Started with AllNewsAPI","AllNewsAPI Team",{"type":8,"value":9,"toc":639},"minimark",[10,14,19,22,26,31,34,57,61,64,136,140,143,453,457,461,464,493,497,500,529,533,536,551,555,582,586,589,611,615,618,632,635],[11,12,13],"p",{},"Welcome to AllNewsAPI! This guide will help you get started with our news aggregation API in just a few minutes.",[15,16,18],"h2",{"id":17},"what-is-allnewsapi","What is AllNewsAPI?",[11,20,21],{},"AllNewsAPI is a powerful news aggregation platform that provides programmatic access to news articles from 244 countries worldwide. Whether you're building a news app, conducting research, or monitoring media coverage, AllNewsAPI makes it easy to access the news data you need.",[15,23,25],{"id":24},"quick-start","Quick Start",[27,28,30],"h3",{"id":29},"_1-sign-up-for-an-api-key","1. Sign Up for an API Key",[11,32,33],{},"First, you'll need to create an account and get your API key:",[35,36,37,48,51,54],"ol",{},[38,39,40,41],"li",{},"Visit ",[42,43,47],"a",{"href":44,"rel":45},"https:\u002F\u002Fallnewsapi.com\u002Fsignup",[46],"nofollow","allnewsapi.com\u002Fsignup",[38,49,50],{},"Create your free account",[38,52,53],{},"Verify your email address",[38,55,56],{},"Get your API key from the dashboard",[27,58,60],{"id":59},"_2-make-your-first-request","2. Make Your First Request",[11,62,63],{},"Once you have your API key, you can start making requests. Here's a simple example using JavaScript:",[65,66,71],"pre",{"className":67,"code":68,"language":69,"meta":70,"style":70},"language-javascript shiki shiki-themes github-light github-dark","const API_KEY = 'your_api_key_here';\nconst API_URL = 'https:\u002F\u002Fapi.allnewsapi.com\u002Fv1\u002Fheadlines';\n\nasync function getHeadlines() {\n  const response = await fetch(`${API_URL}?apikey=${API_KEY}&country=us`);\n  const data = await response.json();\n  console.log(data);\n}\n\ngetHeadlines();\n","javascript","",[72,73,74,82,88,95,101,107,113,119,125,130],"code",{"__ignoreMap":70},[75,76,79],"span",{"class":77,"line":78},"line",1,[75,80,81],{},"const API_KEY = 'your_api_key_here';\n",[75,83,85],{"class":77,"line":84},2,[75,86,87],{},"const API_URL = 'https:\u002F\u002Fapi.allnewsapi.com\u002Fv1\u002Fheadlines';\n",[75,89,91],{"class":77,"line":90},3,[75,92,94],{"emptyLinePlaceholder":93},true,"\n",[75,96,98],{"class":77,"line":97},4,[75,99,100],{},"async function getHeadlines() {\n",[75,102,104],{"class":77,"line":103},5,[75,105,106],{},"  const response = await fetch(`${API_URL}?apikey=${API_KEY}&country=us`);\n",[75,108,110],{"class":77,"line":109},6,[75,111,112],{},"  const data = await response.json();\n",[75,114,116],{"class":77,"line":115},7,[75,117,118],{},"  console.log(data);\n",[75,120,122],{"class":77,"line":121},8,[75,123,124],{},"}\n",[75,126,128],{"class":77,"line":127},9,[75,129,94],{"emptyLinePlaceholder":93},[75,131,133],{"class":77,"line":132},10,[75,134,135],{},"getHeadlines();\n",[27,137,139],{"id":138},"_3-explore-the-response","3. Explore the Response",[11,141,142],{},"The API returns a JSON response with the following structure:",[65,144,148],{"className":145,"code":146,"language":147,"meta":70,"style":70},"language-json shiki shiki-themes github-light github-dark","{\n  \"totalArticles\": 7199232,\n  \"currentPage\": 1,\n  \"articles\": [\n    {\n      \"title\": \"Breaking News Title\",\n      \"description\": \"Article description...\",\n      \"category\": \"technology\",\n      \"content\": \"Full article content...\",\n      \"country\": \"us\",\n      \"region\": \"americas\",\n      \"lang\": \"en\",\n      \"sentiment\": \"neutral\",\n      \"sentimentScores\": {\n        \"negative\": 0.03,\n        \"neutral\": 0.95,\n        \"positive\": 0.02\n      },\n      \"url\": \"https:\u002F\u002Fexample.com\u002Farticle\",\n      \"image\": \"https:\u002F\u002Fexample.com\u002Fimage.jpg\",\n      \"publishedAt\": \"2024-12-01T10:00:00Z\",\n      \"source\": {\n        \"name\": \"News Source\",\n        \"url\": \"https:\u002F\u002Fexample.com\"\n      }\n    }\n  ],\n  \"nextPage\": 2\n}\n","json",[72,149,150,156,171,183,191,196,209,221,233,245,257,270,283,296,305,318,331,342,348,361,374,387,395,408,419,425,431,437,448],{"__ignoreMap":70},[75,151,152],{"class":77,"line":78},[75,153,155],{"class":154},"sVt8B","{\n",[75,157,158,162,165,168],{"class":77,"line":84},[75,159,161],{"class":160},"sj4cs","  \"totalArticles\"",[75,163,164],{"class":154},": ",[75,166,167],{"class":160},"7199232",[75,169,170],{"class":154},",\n",[75,172,173,176,178,181],{"class":77,"line":90},[75,174,175],{"class":160},"  \"currentPage\"",[75,177,164],{"class":154},[75,179,180],{"class":160},"1",[75,182,170],{"class":154},[75,184,185,188],{"class":77,"line":97},[75,186,187],{"class":160},"  \"articles\"",[75,189,190],{"class":154},": [\n",[75,192,193],{"class":77,"line":103},[75,194,195],{"class":154},"    {\n",[75,197,198,201,203,207],{"class":77,"line":109},[75,199,200],{"class":160},"      \"title\"",[75,202,164],{"class":154},[75,204,206],{"class":205},"sZZnC","\"Breaking News Title\"",[75,208,170],{"class":154},[75,210,211,214,216,219],{"class":77,"line":115},[75,212,213],{"class":160},"      \"description\"",[75,215,164],{"class":154},[75,217,218],{"class":205},"\"Article description...\"",[75,220,170],{"class":154},[75,222,223,226,228,231],{"class":77,"line":121},[75,224,225],{"class":160},"      \"category\"",[75,227,164],{"class":154},[75,229,230],{"class":205},"\"technology\"",[75,232,170],{"class":154},[75,234,235,238,240,243],{"class":77,"line":127},[75,236,237],{"class":160},"      \"content\"",[75,239,164],{"class":154},[75,241,242],{"class":205},"\"Full article content...\"",[75,244,170],{"class":154},[75,246,247,250,252,255],{"class":77,"line":132},[75,248,249],{"class":160},"      \"country\"",[75,251,164],{"class":154},[75,253,254],{"class":205},"\"us\"",[75,256,170],{"class":154},[75,258,260,263,265,268],{"class":77,"line":259},11,[75,261,262],{"class":160},"      \"region\"",[75,264,164],{"class":154},[75,266,267],{"class":205},"\"americas\"",[75,269,170],{"class":154},[75,271,273,276,278,281],{"class":77,"line":272},12,[75,274,275],{"class":160},"      \"lang\"",[75,277,164],{"class":154},[75,279,280],{"class":205},"\"en\"",[75,282,170],{"class":154},[75,284,286,289,291,294],{"class":77,"line":285},13,[75,287,288],{"class":160},"      \"sentiment\"",[75,290,164],{"class":154},[75,292,293],{"class":205},"\"neutral\"",[75,295,170],{"class":154},[75,297,299,302],{"class":77,"line":298},14,[75,300,301],{"class":160},"      \"sentimentScores\"",[75,303,304],{"class":154},": {\n",[75,306,308,311,313,316],{"class":77,"line":307},15,[75,309,310],{"class":160},"        \"negative\"",[75,312,164],{"class":154},[75,314,315],{"class":160},"0.03",[75,317,170],{"class":154},[75,319,321,324,326,329],{"class":77,"line":320},16,[75,322,323],{"class":160},"        \"neutral\"",[75,325,164],{"class":154},[75,327,328],{"class":160},"0.95",[75,330,170],{"class":154},[75,332,334,337,339],{"class":77,"line":333},17,[75,335,336],{"class":160},"        \"positive\"",[75,338,164],{"class":154},[75,340,341],{"class":160},"0.02\n",[75,343,345],{"class":77,"line":344},18,[75,346,347],{"class":154},"      },\n",[75,349,351,354,356,359],{"class":77,"line":350},19,[75,352,353],{"class":160},"      \"url\"",[75,355,164],{"class":154},[75,357,358],{"class":205},"\"https:\u002F\u002Fexample.com\u002Farticle\"",[75,360,170],{"class":154},[75,362,364,367,369,372],{"class":77,"line":363},20,[75,365,366],{"class":160},"      \"image\"",[75,368,164],{"class":154},[75,370,371],{"class":205},"\"https:\u002F\u002Fexample.com\u002Fimage.jpg\"",[75,373,170],{"class":154},[75,375,377,380,382,385],{"class":77,"line":376},21,[75,378,379],{"class":160},"      \"publishedAt\"",[75,381,164],{"class":154},[75,383,384],{"class":205},"\"2024-12-01T10:00:00Z\"",[75,386,170],{"class":154},[75,388,390,393],{"class":77,"line":389},22,[75,391,392],{"class":160},"      \"source\"",[75,394,304],{"class":154},[75,396,398,401,403,406],{"class":77,"line":397},23,[75,399,400],{"class":160},"        \"name\"",[75,402,164],{"class":154},[75,404,405],{"class":205},"\"News Source\"",[75,407,170],{"class":154},[75,409,411,414,416],{"class":77,"line":410},24,[75,412,413],{"class":160},"        \"url\"",[75,415,164],{"class":154},[75,417,418],{"class":205},"\"https:\u002F\u002Fexample.com\"\n",[75,420,422],{"class":77,"line":421},25,[75,423,424],{"class":154},"      }\n",[75,426,428],{"class":77,"line":427},26,[75,429,430],{"class":154},"    }\n",[75,432,434],{"class":77,"line":433},27,[75,435,436],{"class":154},"  ],\n",[75,438,440,443,445],{"class":77,"line":439},28,[75,441,442],{"class":160},"  \"nextPage\"",[75,444,164],{"class":154},[75,446,447],{"class":160},"2\n",[75,449,451],{"class":77,"line":450},29,[75,452,124],{"class":154},[15,454,456],{"id":455},"key-features","Key Features",[27,458,460],{"id":459},"multi-country-support","Multi-Country Support",[11,462,463],{},"Access news from 244 countries:",[65,465,467],{"className":67,"code":466,"language":69,"meta":70,"style":70},"\u002F\u002F Get news from France\nfetch(`${API_URL}?apikey=${API_KEY}&country=fr`)\n\n\u002F\u002F Get news from Japan\nfetch(`${API_URL}?apikey=${API_KEY}&country=jp`)\n",[72,468,469,474,479,483,488],{"__ignoreMap":70},[75,470,471],{"class":77,"line":78},[75,472,473],{},"\u002F\u002F Get news from France\n",[75,475,476],{"class":77,"line":84},[75,477,478],{},"fetch(`${API_URL}?apikey=${API_KEY}&country=fr`)\n",[75,480,481],{"class":77,"line":90},[75,482,94],{"emptyLinePlaceholder":93},[75,484,485],{"class":77,"line":97},[75,486,487],{},"\u002F\u002F Get news from Japan\n",[75,489,490],{"class":77,"line":103},[75,491,492],{},"fetch(`${API_URL}?apikey=${API_KEY}&country=jp`)\n",[27,494,496],{"id":495},"category-filtering","Category Filtering",[11,498,499],{},"Filter news by category:",[65,501,503],{"className":67,"code":502,"language":69,"meta":70,"style":70},"\u002F\u002F Get technology news\nfetch(`${API_URL}?apikey=${API_KEY}&category=technology`)\n\n\u002F\u002F Get sports news\nfetch(`${API_URL}?apikey=${API_KEY}&category=sports`)\n",[72,504,505,510,515,519,524],{"__ignoreMap":70},[75,506,507],{"class":77,"line":78},[75,508,509],{},"\u002F\u002F Get technology news\n",[75,511,512],{"class":77,"line":84},[75,513,514],{},"fetch(`${API_URL}?apikey=${API_KEY}&category=technology`)\n",[75,516,517],{"class":77,"line":90},[75,518,94],{"emptyLinePlaceholder":93},[75,520,521],{"class":77,"line":97},[75,522,523],{},"\u002F\u002F Get sports news\n",[75,525,526],{"class":77,"line":103},[75,527,528],{},"fetch(`${API_URL}?apikey=${API_KEY}&category=sports`)\n",[27,530,532],{"id":531},"search-functionality","Search Functionality",[11,534,535],{},"Search for specific topics:",[65,537,539],{"className":67,"code":538,"language":69,"meta":70,"style":70},"\u002F\u002F Search for articles about AI\nfetch(`${API_URL}?apikey=${API_KEY}&q=artificial+intelligence`)\n",[72,540,541,546],{"__ignoreMap":70},[75,542,543],{"class":77,"line":78},[75,544,545],{},"\u002F\u002F Search for articles about AI\n",[75,547,548],{"class":77,"line":84},[75,549,550],{},"fetch(`${API_URL}?apikey=${API_KEY}&q=artificial+intelligence`)\n",[15,552,554],{"id":553},"best-practices","Best Practices",[35,556,557,564,570,576],{},[38,558,559,563],{},[560,561,562],"strong",{},"Cache responses"," - Store API responses to reduce unnecessary requests",[38,565,566,569],{},[560,567,568],{},"Handle errors gracefully"," - Always check for error responses",[38,571,572,575],{},[560,573,574],{},"Respect rate limits"," - Monitor your usage to stay within your plan limits",[38,577,578,581],{},[560,579,580],{},"Use pagination"," - For large result sets, use pagination parameters",[15,583,585],{"id":584},"next-steps","Next Steps",[11,587,588],{},"Now that you've made your first request, here are some things to explore:",[590,591,592,600,608],"ul",{},[38,593,594,595,599],{},"Check out our ",[42,596,598],{"href":597},"\u002Fdocs","API Documentation"," for detailed endpoint information",[38,601,602,603,607],{},"Explore different ",[42,604,606],{"href":605},"\u002Fpricing","pricing plans"," to find the right fit",[38,609,610],{},"Join our community to share tips and get support",[15,612,614],{"id":613},"need-help","Need Help?",[11,616,617],{},"If you have questions or need assistance:",[590,619,620,626,629],{},[38,621,622,623],{},"Visit our ",[42,624,625],{"href":597},"documentation",[38,627,628],{},"Contact our support team",[38,630,631],{},"Check out our other blog posts for tips and tutorials",[11,633,634],{},"Happy coding! 🚀",[636,637,638],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}",{"title":70,"searchDepth":84,"depth":84,"links":640},[641,642,647,652,653,654],{"id":17,"depth":84,"text":18},{"id":24,"depth":84,"text":25,"children":643},[644,645,646],{"id":29,"depth":90,"text":30},{"id":59,"depth":90,"text":60},{"id":138,"depth":90,"text":139},{"id":455,"depth":84,"text":456,"children":648},[649,650,651],{"id":459,"depth":90,"text":460},{"id":495,"depth":90,"text":496},{"id":531,"depth":90,"text":532},{"id":553,"depth":84,"text":554},{"id":584,"depth":84,"text":585},{"id":613,"depth":84,"text":614},"2021-12-01","Learn how to integrate AllNewsAPI into your application in just a few minutes and start accessing news data from around the world",false,"md","\u002Fblog\u002Fgetting-started-with-allnewsapi.webp",{},"\u002Fblog\u002Fgetting-started-with-allnewsapi",{"title":5,"description":656},{"loc":661},"blog\u002Fgetting-started-with-allnewsapi","guide","D0-g-cmTylQrhL_UoknFAMRCI1Ofdm8olt4JyHzencM",1783882214592]