[{"data":1,"prerenderedAt":737},["ShallowReactive",2],{"blog-getting-started-with-allnewsapi":3},{"id":4,"title":5,"author":6,"body":7,"date":725,"description":726,"draft":727,"extension":728,"image":729,"meta":730,"navigation":93,"path":731,"seo":732,"sitemap":733,"stem":734,"tags":735,"__hash__":736},"blog\u002Fblog\u002Fgetting-started-with-allnewsapi.md","Getting Started with AllNewsAPI","AllNewsAPI Team",{"type":8,"value":9,"toc":709},"minimark",[10,14,19,22,26,31,34,57,61,64,136,140,143,523,527,531,534,563,567,570,599,603,606,621,625,652,656,659,681,685,688,702,705],[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      \"authors\": [\"John Doe\"],\n      \"ai_sentiment\": \"neutral\",\n      \"ai_sentiment_scores\": {\n        \"negative\": 0.03,\n        \"neutral\": 0.95,\n        \"positive\": 0.02\n      },\n      \"ai_entities\": [\n        { \"name\": \"Example Corp\", \"type\": \"ORG\" }\n      ],\n      \"ai_summary\": \"A brief AI-generated summary of the article content.\",\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,298,311,320,333,346,357,363,371,399,405,418,431,444,457,465,478,489,495,501,507,518],{"__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,292,295],{"class":77,"line":285},13,[75,287,288],{"class":160},"      \"authors\"",[75,290,291],{"class":154},": [",[75,293,294],{"class":205},"\"John Doe\"",[75,296,297],{"class":154},"],\n",[75,299,301,304,306,309],{"class":77,"line":300},14,[75,302,303],{"class":160},"      \"ai_sentiment\"",[75,305,164],{"class":154},[75,307,308],{"class":205},"\"neutral\"",[75,310,170],{"class":154},[75,312,314,317],{"class":77,"line":313},15,[75,315,316],{"class":160},"      \"ai_sentiment_scores\"",[75,318,319],{"class":154},": {\n",[75,321,323,326,328,331],{"class":77,"line":322},16,[75,324,325],{"class":160},"        \"negative\"",[75,327,164],{"class":154},[75,329,330],{"class":160},"0.03",[75,332,170],{"class":154},[75,334,336,339,341,344],{"class":77,"line":335},17,[75,337,338],{"class":160},"        \"neutral\"",[75,340,164],{"class":154},[75,342,343],{"class":160},"0.95",[75,345,170],{"class":154},[75,347,349,352,354],{"class":77,"line":348},18,[75,350,351],{"class":160},"        \"positive\"",[75,353,164],{"class":154},[75,355,356],{"class":160},"0.02\n",[75,358,360],{"class":77,"line":359},19,[75,361,362],{"class":154},"      },\n",[75,364,366,369],{"class":77,"line":365},20,[75,367,368],{"class":160},"      \"ai_entities\"",[75,370,190],{"class":154},[75,372,374,377,380,382,385,388,391,393,396],{"class":77,"line":373},21,[75,375,376],{"class":154},"        { ",[75,378,379],{"class":160},"\"name\"",[75,381,164],{"class":154},[75,383,384],{"class":205},"\"Example Corp\"",[75,386,387],{"class":154},", ",[75,389,390],{"class":160},"\"type\"",[75,392,164],{"class":154},[75,394,395],{"class":205},"\"ORG\"",[75,397,398],{"class":154}," }\n",[75,400,402],{"class":77,"line":401},22,[75,403,404],{"class":154},"      ],\n",[75,406,408,411,413,416],{"class":77,"line":407},23,[75,409,410],{"class":160},"      \"ai_summary\"",[75,412,164],{"class":154},[75,414,415],{"class":205},"\"A brief AI-generated summary of the article content.\"",[75,417,170],{"class":154},[75,419,421,424,426,429],{"class":77,"line":420},24,[75,422,423],{"class":160},"      \"url\"",[75,425,164],{"class":154},[75,427,428],{"class":205},"\"https:\u002F\u002Fexample.com\u002Farticle\"",[75,430,170],{"class":154},[75,432,434,437,439,442],{"class":77,"line":433},25,[75,435,436],{"class":160},"      \"image\"",[75,438,164],{"class":154},[75,440,441],{"class":205},"\"https:\u002F\u002Fexample.com\u002Fimage.jpg\"",[75,443,170],{"class":154},[75,445,447,450,452,455],{"class":77,"line":446},26,[75,448,449],{"class":160},"      \"publishedAt\"",[75,451,164],{"class":154},[75,453,454],{"class":205},"\"2024-12-01T10:00:00Z\"",[75,456,170],{"class":154},[75,458,460,463],{"class":77,"line":459},27,[75,461,462],{"class":160},"      \"source\"",[75,464,319],{"class":154},[75,466,468,471,473,476],{"class":77,"line":467},28,[75,469,470],{"class":160},"        \"name\"",[75,472,164],{"class":154},[75,474,475],{"class":205},"\"News Source\"",[75,477,170],{"class":154},[75,479,481,484,486],{"class":77,"line":480},29,[75,482,483],{"class":160},"        \"url\"",[75,485,164],{"class":154},[75,487,488],{"class":205},"\"https:\u002F\u002Fexample.com\"\n",[75,490,492],{"class":77,"line":491},30,[75,493,494],{"class":154},"      }\n",[75,496,498],{"class":77,"line":497},31,[75,499,500],{"class":154},"    }\n",[75,502,504],{"class":77,"line":503},32,[75,505,506],{"class":154},"  ],\n",[75,508,510,513,515],{"class":77,"line":509},33,[75,511,512],{"class":160},"  \"nextPage\"",[75,514,164],{"class":154},[75,516,517],{"class":160},"2\n",[75,519,521],{"class":77,"line":520},34,[75,522,124],{"class":154},[15,524,526],{"id":525},"key-features","Key Features",[27,528,530],{"id":529},"multi-country-support","Multi-Country Support",[11,532,533],{},"Access news from 244 countries:",[65,535,537],{"className":67,"code":536,"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,538,539,544,549,553,558],{"__ignoreMap":70},[75,540,541],{"class":77,"line":78},[75,542,543],{},"\u002F\u002F Get news from France\n",[75,545,546],{"class":77,"line":84},[75,547,548],{},"fetch(`${API_URL}?apikey=${API_KEY}&country=fr`)\n",[75,550,551],{"class":77,"line":90},[75,552,94],{"emptyLinePlaceholder":93},[75,554,555],{"class":77,"line":97},[75,556,557],{},"\u002F\u002F Get news from Japan\n",[75,559,560],{"class":77,"line":103},[75,561,562],{},"fetch(`${API_URL}?apikey=${API_KEY}&country=jp`)\n",[27,564,566],{"id":565},"category-filtering","Category Filtering",[11,568,569],{},"Filter news by category:",[65,571,573],{"className":67,"code":572,"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,574,575,580,585,589,594],{"__ignoreMap":70},[75,576,577],{"class":77,"line":78},[75,578,579],{},"\u002F\u002F Get technology news\n",[75,581,582],{"class":77,"line":84},[75,583,584],{},"fetch(`${API_URL}?apikey=${API_KEY}&category=technology`)\n",[75,586,587],{"class":77,"line":90},[75,588,94],{"emptyLinePlaceholder":93},[75,590,591],{"class":77,"line":97},[75,592,593],{},"\u002F\u002F Get sports news\n",[75,595,596],{"class":77,"line":103},[75,597,598],{},"fetch(`${API_URL}?apikey=${API_KEY}&category=sports`)\n",[27,600,602],{"id":601},"search-functionality","Search Functionality",[11,604,605],{},"Search for specific topics:",[65,607,609],{"className":67,"code":608,"language":69,"meta":70,"style":70},"\u002F\u002F Search for articles about AI\nfetch(`${API_URL}?apikey=${API_KEY}&q=artificial+intelligence`)\n",[72,610,611,616],{"__ignoreMap":70},[75,612,613],{"class":77,"line":78},[75,614,615],{},"\u002F\u002F Search for articles about AI\n",[75,617,618],{"class":77,"line":84},[75,619,620],{},"fetch(`${API_URL}?apikey=${API_KEY}&q=artificial+intelligence`)\n",[15,622,624],{"id":623},"best-practices","Best Practices",[35,626,627,634,640,646],{},[38,628,629,633],{},[630,631,632],"strong",{},"Cache responses"," - Store API responses to reduce unnecessary requests",[38,635,636,639],{},[630,637,638],{},"Handle errors gracefully"," - Always check for error responses",[38,641,642,645],{},[630,643,644],{},"Respect rate limits"," - Monitor your usage to stay within your plan limits",[38,647,648,651],{},[630,649,650],{},"Use pagination"," - For large result sets, use pagination parameters",[15,653,655],{"id":654},"next-steps","Next Steps",[11,657,658],{},"Now that you've made your first request, here are some things to explore:",[660,661,662,670,678],"ul",{},[38,663,664,665,669],{},"Check out our ",[42,666,668],{"href":667},"\u002Fdocs","API Documentation"," for detailed endpoint information",[38,671,672,673,677],{},"Explore different ",[42,674,676],{"href":675},"\u002Fpricing","pricing plans"," to find the right fit",[38,679,680],{},"Join our community to share tips and get support",[15,682,684],{"id":683},"need-help","Need Help?",[11,686,687],{},"If you have questions or need assistance:",[660,689,690,696,699],{},[38,691,692,693],{},"Visit our ",[42,694,695],{"href":667},"documentation",[38,697,698],{},"Contact our support team",[38,700,701],{},"Check out our other blog posts for tips and tutorials",[11,703,704],{},"Happy coding! 🚀",[706,707,708],"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":710},[711,712,717,722,723,724],{"id":17,"depth":84,"text":18},{"id":24,"depth":84,"text":25,"children":713},[714,715,716],{"id":29,"depth":90,"text":30},{"id":59,"depth":90,"text":60},{"id":138,"depth":90,"text":139},{"id":525,"depth":84,"text":526,"children":718},[719,720,721],{"id":529,"depth":90,"text":530},{"id":565,"depth":90,"text":566},{"id":601,"depth":90,"text":602},{"id":623,"depth":84,"text":624},{"id":654,"depth":84,"text":655},{"id":683,"depth":84,"text":684},"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":726},{"loc":731},"blog\u002Fgetting-started-with-allnewsapi","guide","XTZ9pmxHaQlHta28LrmrDNZDVAnlliIk1AHnZW6pciM",1785081518130]