{"id":1591,"date":"2023-08-29T06:09:51","date_gmt":"2023-08-29T00:39:51","guid":{"rendered":"https:\/\/newsdata.io\/blog\/?p=1591"},"modified":"2024-09-17T12:20:28","modified_gmt":"2024-09-17T06:50:28","slug":"how-to-make-your-first-request-with-newsdata-io","status":"publish","type":"post","link":"https:\/\/newsdata.io\/blog\/how-to-make-your-first-request-with-newsdata-io\/","title":{"rendered":"How to Make Your First API Request With NewsData.io"},"content":{"rendered":"[vc_row type=”in_container” full_screen_row_position=”middle” column_margin=”default” column_direction=”default” column_direction_tablet=”default” column_direction_phone=”default” scene_position=”center” text_color=”dark” text_align=”left” row_border_radius=”none” row_border_radius_applies=”bg” overflow=”visible” overlay_strength=”0.3″ gradient_direction=”left_to_right” shape_divider_position=”bottom” bg_image_animation=”none”][vc_column column_padding=”no-extra-padding” column_padding_tablet=”inherit” column_padding_phone=”inherit” column_padding_position=”all” bottom_margin=”220″ column_element_direction_desktop=”default” column_element_spacing=”default” desktop_text_alignment=”default” tablet_text_alignment=”default” phone_text_alignment=”default” sticky_content=”true” sticky_content_functionality=”js” background_color_opacity=”1″ background_hover_color_opacity=”1″ column_backdrop_filter=”none” column_shadow=”none” column_border_radius=”none” column_link_target=”_self” column_position=”default” gradient_direction=”left_to_right” overlay_strength=”0.3″ width=”1\/4″ tablet_width_inherit=”default” animation_type=”default” bg_image_animation=”none” border_type=”simple” column_border_width=”none” column_border_style=”solid” column_padding_type=”default” gradient_type=”default” offset=”vc_hidden-sm vc_hidden-xs”][\/vc_column][vc_column right_padding_desktop=”40″ right_padding_tablet=”0″ right_padding_phone=”0″ top_margin=”-240″ top_margin_tablet=”-180″ top_margin_phone=”-135″ column_element_direction_desktop=”default” column_element_spacing=”default” desktop_text_alignment=”default” tablet_text_alignment=”default” phone_text_alignment=”default” background_color_opacity=”1″ background_hover_color_opacity=”1″ column_backdrop_filter=”none” column_shadow=”none” column_border_radius=”none” column_link_target=”_self” column_position=”default” el_class=”text_block_wrapper” gradient_direction=”left_to_right” overlay_strength=”0.3″ width=”3\/4″ tablet_width_inherit=”default” animation_type=”default” bg_image_animation=”none” border_type=”simple” column_border_width=”none” column_border_style=”solid” column_padding_type=”advanced” gradient_type=”default” offset=”vc_col-lg-9 vc_col-md-12″][image_with_animation image_url=”1783″ image_size=”full” animation_type=”entrance” animation=”None” animation_movement_type=”transform_y” hover_animation=”none” alignment=”” border_radius=”10px” box_shadow=”small_depth” image_loading=”default” max_width=”100%” max_width_mobile=”default”][vc_column_text css=”.vc_custom_1726551306461{padding-bottom: 20px !important;}”]In this article, we\u2019ll walk you through the process of making your first API request.[\/vc_column_text][vc_column_text css=”.vc_custom_1713347729445{padding-bottom: 20px !important;}”]\n

Initial Steps<\/b><\/h2>\n[\/vc_column_text][vc_column_text css=”.vc_custom_1726552405757{padding-bottom: 20px !important;}”]The data retrieval process begins with below mentioned steps:<\/p>\n

1. Account Creation<\/b><\/h3>\n

Sign up for an account on NewsData.io to obtain your unique API key.<\/p>\n

2. Choosing the Endpoint<\/b><\/h3>\n

A variety of endpoints are provided, each catering to specific types of news data.<\/p>\n

For instance, the \u201clatest<\/strong><\/a>\u201d endpoint retrieves the latest news articles<\/strong> across various sources.<\/p>\n

3. Constructing the API Request URL<\/b><\/h3>\n

To construct the API request URL combine the base URL with the chosen endpoint. This forms the foundation of your API call.<\/p>\n

https:\/\/newsdata.io\/api\/1\/latest?apikey=Your_API_KEY&q=YOUR_QUERY<\/code><\/p>\n

4. Adding Query Parameters<\/b><\/h3>\n

Query parameters are the building blocks of an effective API request. They help narrow down your search to specific criteria, making your results more relevant.<\/p>\n

For instance, In the \u201clatest<\/strong>\u201d endpoint, you can use parameters like \u201ccountry,\u201d \u201ccategory,\u201d or \u201cq<\/a>\u201d (keywords) to tailor your results.<\/p>\n

5. Including API Key<\/b><\/h3>\n

Insert your API key to the URL as a parameter, ensuring NewsData.io recognizes your request as authorized.<\/p>\n

6. Making the API Request<\/b><\/h3>\n

You can use tools like cURL, Python, or API client software to send your request. Once dispatched, you await the response.[\/vc_column_text][divider line_type=”Full Width Line” line_thickness=”1″ divider_color=”extra-color-3″][vc_column_text css=”.vc_custom_1726555773542{padding-bottom: 20px !important;}”]\n

First API Request With Postman<\/b><\/h2>\n[\/vc_column_text][vc_column_text css=”.vc_custom_1726552500779{padding-bottom: 20px !important;}”]Let\u2019s understand how users can make the first request with Postman.<\/p>\n

Given below is the base parameter that users have to enter:<\/p>\n

https:\/\/newsdata.io\/api\/1\/latest?apikey=YOUR_API_KEY<\/code><\/p>\n

You can further add more parameters and advance search options provided like q, qInTitle, qInMeta<\/a>, etc.[\/vc_column_text][vc_column_text css=”.vc_custom_1726552507312{padding-bottom: 20px !important;}”]To help you understand better, here is an example with the query of football.<\/p>\n

The news article retrieval request would be;<\/p>\n

https:\/\/newsdata.io\/api\/1\/latest?apikey=YOUR_API_KEY&q=football<\/code>[\/vc_column_text][image_with_animation image_url=”4847″ image_size=”full” animation_type=”entrance” animation=”None” animation_movement_type=”transform_y” hover_animation=”none” alignment=”” border_radius=”10px” box_shadow=”small_depth” image_loading=”default” max_width=”100%” max_width_mobile=”default”][vc_column_text css=”.vc_custom_1713349256484{padding-bottom: 20px !important;}”]This query will fetch all the relevant articles on football.[\/vc_column_text][divider line_type=”Full Width Line” line_thickness=”1″ divider_color=”extra-color-3″][vc_column_text css=”.vc_custom_1726555788348{padding-bottom: 20px !important;}”]\n

First API Request With<\/b> cURL<\/b><\/h2>\n[\/vc_column_text][vc_column_text css=”.vc_custom_1726553700050{padding-bottom: 20px !important;}”]To extract data using cURL, follow these steps:<\/p>\n

1. Install cURL on your desktop.
\n2. Construct the Curl command by writing \u201ccurl\u201d and then entering the query.
\nFor example;<\/p>\n

curl https:\/\/newsdata.io\/api\/1\/latest?apikey=YOUR_API_KEY&q=pizza<\/code><\/p>\n

3. cURL will extract all the data of your query in JSON format.[\/vc_column_text][image_with_animation image_url=”3766″ image_size=”full” animation_type=”entrance” animation=”None” animation_movement_type=”transform_y” hover_animation=”none” alignment=”” border_radius=”10px” box_shadow=”small_depth” image_loading=”default” max_width=”100%” max_width_mobile=”default”][vc_column_text css=”.vc_custom_1726553721073{padding-bottom: 20px !important;}”]Additional parameters, such as language, category, and domain name, can also be used.<\/p>\n

To help you understand better, given below is an example.
\nThe given request will look for news stories in English language with the keyword \u201cpizza\u201d published between January 19, 2023, and January 25, 2023.<\/p>\n

https:\/\/newsdata.io\/api\/1\/archive?apikey=YOUR_API_KEY&q=pizza&language=en&from_date=2023-01-19&to_date=2023-01-25<\/code>[\/vc_column_text][image_with_animation image_url=”3767″ image_size=”full” animation_type=”entrance” animation=”None” animation_movement_type=”transform_y” hover_animation=”none” alignment=”” border_radius=”10px” box_shadow=”small_depth” image_loading=”default” max_width=”100%” max_width_mobile=”default”][vc_column_text css=”.vc_custom_1713350817207{padding-bottom: 20px !important;}”]After submitting your request, you will receive a JSON response containing the news articles that meet your search parameters.[\/vc_column_text][divider line_type=”Full Width Line” line_thickness=”1″ divider_color=”extra-color-3″][vc_column_text css=”.vc_custom_1726555804707{padding-bottom: 20px !important;}”]\n

First API Request<\/b> Through NewData.io Dashboard<\/b><\/h2>\n[\/vc_column_text][vc_column_text css=”.vc_custom_1726555216335{padding-bottom: 20px !important;}”]To learn how to extract the articles without coding, follow the steps below:<\/p>\n

1. Account Creation:<\/b> Sign up<\/a> for an account on NewsData.io to obtain your unique API key.
\n\"API<\/p>\n

2. Searching your Query:<\/strong> After account creation, go back to your NewsData.io homepage.<\/p>\n

3. Click on \u201cDashboard\u201d at the top right corner.<\/strong> You will then be redirected to the NewsData.io dashboard. Here, you can fetch data using the search bar(as shown below) as displayed on your screen.<\/p>\n

\n\n