API
Countries Info API
Welcome to the Countries Info API—your reliable source for comprehensive country data! Designed to support developers, researchers, and businesses, this API provides detailed information on countries worldwide. Whether you’re building a travel app, e-commerce platform, or analytics tool, the Countries Info API offers a wide array of endpoints to access essential data such as exchange rates, holidays, time zones, and more.
The API caters to a wide range of programming languages, including but not limited to: C, Clojure, C#, GO, Java, JavaScript, Kotlin, Node.js, Objective-C, OCaml, PHP, PowerShell, Python, R, RapidQL, Ruby, Shell, and Swift.
Introduction
API Overview
This API is designed to help developers, researchers, and businesses integrate comprehensive country data into their applications quickly and efficiently. With endpoints providing details on exchange rates, holidays, time zones, and more, the Countries Info API delivers essential data in a seamless, easy-to-use format.
Key Features:
The Countries Info API provides several endpoints for retrieving accurate, up-to-date country-related information. Here are some of the key endpoints available:
Country Information – /country-info
Retrieve essential details about a country, including population, area, and demographic statistics.
Amenity Information – /amenity
Access information on key amenities within a specified country, such as hospitals, schools, and other public resources.
Distance Calculation – /distance
Calculate the distance between two locations within a country, ideal for travel, logistics, or location-based applications.
Directions – /directions
Obtain route directions between two locations within a country, supporting various travel modes like driving, walking, and bicycling.
Trending Topics – /trending
Retrieve trending topics or popular searches within a country, valuable for media and news-related applications.
Exchange Rate – /xchange-rate
Convert currency between different types using real-time exchange rate data, essential for financial and e-commerce applications.
Holiday Information – /holiday
Access a list of official holidays for a specific country, helping to plan projects or events around public holidays.
Time Zone Details – /time-zone
Access detailed time zone information for a country, including UTC offset and current local time, useful for scheduling and global applications.
Additional Highlights:
Diverse Endpoints: Access various country-specific data points, from currency conversion to trending topics, holidays, and directions.
High Availability: Dependable, always-online access through the trusted RapidAPI marketplace.
Custom Error Handling: Thoughtful error messages for smooth troubleshooting and an improved user experience.
Endpoints
Endpoints Overview
Country Info
The Country Info provides comprehensive and reliable information about countries worldwide. Access details such as capital cities, population, languages, currency, time zones, and more with a simple query. This API supports both GET and POST requests, offering versatility for different integration needs.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | Yes | The name of the country you want information about. This can be in any case (uppercase/lowercase) and will be trimmed automatically. |
Python Requests Example:
import requests
url = "https://countries-info-api.p.rapidapi.com/country-info"
querystring = {"country":"Canada"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "countries-info-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())Response Example:
{
"country_info": {
"ISO": { "alpha2": "CA", "alpha3": "CAN" },
"altSpellings": ["CA"],
"area": 9984670,
"borders": ["USA"],
"callingCodes": ["1"],
"capital": "Ottawa",
"capital_latlng": [45.421106, -75.690308],
"currencies": ["CAD"],
"demonym": "Canadian",
"flag": "",
"geoJSON": {
"features": [
{
"geometry": {
"coordinates": [
[
[
[-63.6645, 46.55001],
[-62.9393, 46.41587],
[-62.01208, 46.44314],
[-62.50391, 46.03339],
[-62.87433, 45.96818],
[-64.1428, 46.39265],
[-64.39261, 46.72747],
[-64.01486, 47.03601],
[-63.6645, 46.55001]
]
],
[
[
[-61.806305, 49.10506],
[-62.29318, 49.08717],
[-63.58926, 49.40069],
[-64.51912, 49.87304],
[-64.17322, 49.95718],
[-62.85829, 49.70641],
[-61.835585, 49.28855],
[-61.806305, 49.10506]
]
],
[
[
[-123.510002, 48.510011],
[-124.012891, 48.370846],
[-125.655013, 48.825005],
[-125.954994, 49.179996],
[-126.850004, 49.53],
[-127.029993, 49.814996],
[-128.059336, 49.994959],
[-128.444584, 50.539138],
[-128.358414, 50.770648],
[-127.308581, 50.552574],
[-126.695001, 50.400903],
[-125.755007, 50.295018],
[-125.415002, 49.950001],
[-124.920768, 49.475275],
[-123.922509, 49.062484],
[-123.510002, 48.510011]
]
],
[
[
[-56.134036, 50.68701],
[-56.795882, 49.812309],
[-56.143105, 50.150117],
[-55.471492, 49.935815],
[-55.822401, 49.587129],
[-54.935143, 49.313011],
[-54.473775, 49.556691],
[-53.476549, 49.249139],
[-53.786014, 48.516781],
[-53.086134, 48.687804],
[-52.958648, 48.157164],
[-52.648099, 47.535548],
[-53.069158, 46.655499],
[-53.521456, 46.618292],
[-54.178936, 46.807066],
[-53.961869, 47.625207],
[-54.240482, 47.752279],
[-55.400773, 46.884994],
[-55.997481, 46.91972],
[-55.291219, 47.389562],
[-56.250799, 47.632545],
[-57.325229, 47.572807],
[-59.266015, 47.603348],
[-59.419494, 47.899454],
[-58.796586, 48.251525],
[-59.231625, 48.523188],
[-58.391805, 49.125581],
[-57.35869, 50.718274],
[-56.73865, 51.287438],
[-55.870977, 51.632094],
[-55.406974, 51.588273],
[-55.600218, 51.317075],
[-56.134036, 50.68701]
]
],
[
[
[-132.710008, 54.040009],
[-131.74999, 54.120004],
[-132.04948, 52.984621],
[-131.179043, 52.180433],
[-131.57783, 52.182371],
[-132.180428, 52.639707],
[-132.549992, 53.100015],
[-133.054611, 53.411469],
[-133.239664, 53.85108],
[-133.180004, 54.169975],
[-132.710008, 54.040009]
]
],
[
[
[-79.26582, 62.158675],
[-79.65752, 61.63308],
[-80.09956, 61.7181],
[-80.36215, 62.01649],
[-80.315395, 62.085565],
[-79.92939, 62.3856],
[-79.52002, 62.36371],
[-79.26582, 62.158675]
]
],
[
[
[-81.89825, 62.7108],
[-83.06857, 62.15922],
[-83.77462, 62.18231],
[-83.99367, 62.4528],
[-83.25048, 62.91409],
[-81.87699, 62.90458],
[-81.89825, 62.7108]
]
],
[
[
[-85.161308, 65.657285],
[-84.975764, 65.217518],
[-84.464012, 65.371772],
[-83.882626, 65.109618],
[-82.787577, 64.766693],
[-81.642014, 64.455136],
[-81.55344, 63.979609],
[-80.817361, 64.057486],
[-80.103451, 63.725981],
[-80.99102, 63.411246],
[-82.547178, 63.651722],
[-83.108798, 64.101876],
[-84.100417, 63.569712],
[-85.523405, 63.052379],
[-85.866769, 63.637253],
[-87.221983, 63.541238],
[-86.35276, 64.035833],
[-86.224886, 64.822917],
[-85.883848, 65.738778],
[-85.161308, 65.657285]
]
],
[
[
[-75.86588, 67.14886],
[-76.98687, 67.09873],
[-77.2364, 67.58809],
[-76.81166, 68.14856],
[-75.89521, 68.28721],
[-75.1145, 68.01036],
[-75.10333, 67.58202],
[-75.21597, 67.44425],
[-75.86588, 67.14886]
]
],
[
[
[-95.647681, 69.10769],
[-96.269521, 68.75704],
[-97.617401, 69.06003],
[-98.431801, 68.9507],
[-99.797401, 69.40003],
[-98.917401, 69.71003],
[-98.218261, 70.14354],
[-97.157401, 69.86003],
[-96.557401, 69.68003],
[-96.257401, 69.49003],
[-95.647681, 69.10769]
]
],
[
[
[-90.5471, 69.49766],
[-90.55151, 68.47499],
[-89.21515, 69.25873],
[-88.01966, 68.61508],
[-88.31749, 67.87338],
[-87.35017, 67.19872],
[-86.30607, 67.92146],
[-85.57664, 68.78456],
[-85.52197, 69.88211],
[-84.10081, 69.80539],
[-82.62258, 69.65826],
[-81.28043, 69.16202],
[-81.2202, 68.66567],
[-81.96436, 68.13253],
[-81.25928, 67.59716],
[-81.38653, 67.11078],
[-83.34456, 66.41154],
[-84.73542, 66.2573],
[-85.76943, 66.55833],
[-86.0676, 66.05625],
[-87.03143, 65.21297],
[-87.32324, 64.77563],
[-88.48296, 64.09897],
[-89.91444, 64.03273],
[-90.70398, 63.61017],
[-90.77004, 62.96021],
[-91.93342, 62.83508],
[-93.15698, 62.02469],
[-94.24153, 60.89865],
[-94.62931, 60.11021],
[-94.6846, 58.94882],
[-93.21502, 58.78212],
[-92.76462, 57.84571],
[-92.29703, 57.08709],
[-90.89769, 57.28468],
[-89.03953, 56.85172],
[-88.03978, 56.47162],
[-87.32421, 55.99914],
[-86.07121, 55.72383],
[-85.01181, 55.3026],
[-83.36055, 55.24489],
[-82.27285, 55.14832],
[-82.4362, 54.28227],
[-82.12502, 53.27703],
[-81.40075, 52.15788],
[-79.91289, 51.20842],
[-79.14301, 51.53393],
[-78.60191, 52.56208],
[-79.12421, 54.14145],
[-79.82958, 54.66772],
[-78.22874, 55.13645],
[-77.0956, 55.83741],
[-76.54137, 56.53423],
[-76.62319, 57.20263],
[-77.30226, 58.05209],
[-78.51688, 58.80458],
[-77.33676, 59.85261],
[-77.77272, 60.75788],
[-78.10687, 62.31964],
[-77.41067, 62.55053],
[-75.69621, 62.2784],
[-74.6682, 62.18111],
[-73.83988, 62.4438],
[-72.90853, 62.10507],
[-71.67708, 61.52535],
[-71.37369, 61.13717],
[-69.59042, 61.06141],
[-69.62033, 60.22125],
[-69.2879, 58.95736],
[-68.37455, 58.80106],
[-67.64976, 58.21206],
[-66.20178, 58.76731],
[-65.24517, 59.87071],
[-64.58352, 60.33558],
[-63.80475, 59.4426],
[-62.50236, 58.16708],
[-61.39655, 56.96745],
[-61.79866, 56.33945],
[-60.46853, 55.77548],
[-59.56962, 55.20407],
[-57.97508, 54.94549],
[-57.3332, 54.6265],
[-56.93689, 53.78032],
[-56.15811, 53.64749],
[-55.75632, 53.27036],
[-55.68338, 52.14664],
[-56.40916, 51.7707],
[-57.12691, 51.41972],
[-58.77482, 51.0643],
[-60.03309, 50.24277],
[-61.72366, 50.08046],
[-63.86251, 50.29099],
[-65.36331, 50.2982],
[-66.39905, 50.22897],
[-67.23631, 49.51156],
[-68.51114, 49.06836],
[-69.95362, 47.74488],
[-71.10458, 46.82171],
[-70.25522, 46.98606],
[-68.65, 48.3],
[-66.55243, 49.1331],
[-65.05626, 49.23278],
[-64.17099, 48.74248],
[-65.11545, 48.07085],
[-64.79854, 46.99297],
[-64.47219, 46.23849],
[-63.17329, 45.73902],
[-61.52072, 45.88377],
[-60.51815, 47.00793],
[-60.4486, 46.28264],
[-59.80287, 45.9204],
[-61.03988, 45.26525],
[-63.25471, 44.67014],
[-64.24656, 44.26553],
[-65.36406, 43.54523],
[-66.1234, 43.61867],
[-66.16173, 44.46512],
[-64.42549, 45.29204],
[-66.02605, 45.25931],
[-67.13741, 45.13753],
[-67.79134, 45.70281],
[-67.79046, 47.06636],
[-68.23444, 47.35486],
[-68.905, 47.185],
[-69.237216, 47.447781],
[-69.99997, 46.69307],
[-70.305, 45.915],
[-70.66, 45.46],
[-71.08482, 45.30524],
[-71.405, 45.255],
[-71.50506, 45.0082],
[-73.34783, 45.00738],
[-74.867, 45.00048],
[-75.31821, 44.81645],
[-76.375, 44.09631],
[-76.5, 44.018459],
[-76.820034, 43.628784],
[-77.737885, 43.629056],
[-78.72028, 43.625089],
[-79.171674, 43.466339],
[-79.01, 43.27],
[-78.92, 42.965],
[-78.939362, 42.863611],
[-80.247448, 42.3662],
[-81.277747, 42.209026],
[-82.439278, 41.675105],
[-82.690089, 41.675105],
[-83.02981, 41.832796],
[-83.142, 41.975681],
[-83.12, 42.08],
[-82.9, 42.43],
[-82.43, 42.98],
[-82.137642, 43.571088],
[-82.337763, 44.44],
[-82.550925, 45.347517],
[-83.592851, 45.816894],
[-83.469551, 45.994686],
[-83.616131, 46.116927],
[-83.890765, 46.116927],
[-84.091851, 46.275419],
[-84.14212, 46.512226],
[-84.3367, 46.40877],
[-84.6049, 46.4396],
[-84.543749, 46.538684],
[-84.779238, 46.637102],
[-84.87608, 46.900083],
[-85.652363, 47.220219],
[-86.461991, 47.553338],
[-87.439793, 47.94],
[-88.378114, 48.302918],
[-89.272917, 48.019808],
[-89.6, 48.01],
[-90.83, 48.27],
[-91.64, 48.14],
[-92.61, 48.45],
[-93.63087, 48.60926],
[-94.32914, 48.67074],
[-94.64, 48.84],
[-94.81758, 49.38905],
[-95.15609, 49.38425],
[-95.15907, 49],
[-97.22872, 49.0007],
[-100.65, 49],
[-104.04826, 48.99986],
[-107.05, 49],
[-110.05, 49],
[-113, 49],
[-116.04818, 49],
[-117.03121, 49],
[-120, 49],
[-122.84, 49],
[-122.97421, 49.002538],
[-124.91024, 49.98456],
[-125.62461, 50.41656],
[-127.43561, 50.83061],
[-127.99276, 51.71583],
[-127.85032, 52.32961],
[-129.12979, 52.75538],
[-129.30523, 53.56159],
[-130.51497, 54.28757],
[-130.53611, 54.80278],
[-129.98, 55.285],
[-130.00778, 55.91583],
[-131.70781, 56.55212],
[-132.73042, 57.69289],
[-133.35556, 58.41028],
[-134.27111, 58.86111],
[-134.945, 59.27056],
[-135.47583, 59.78778],
[-136.47972, 59.46389],
[-137.4525, 58.905],
[-138.34089, 59.56211],
[-139.039, 60],
[-140.013, 60.27682],
[-140.99778, 60.30639],
[-140.9925, 66.00003],
[-140.986, 69.712],
[-139.12052, 69.47102],
[-137.54636, 68.99002],
[-136.50358, 68.89804],
[-135.62576, 69.31512],
[-134.41464, 69.62743],
[-132.92925, 69.50534],
[-131.43136, 69.94451],
[-129.79471, 70.19369],
[-129.10773, 69.77927],
[-128.36156, 70.01286],
[-128.13817, 70.48384],
[-127.44712, 70.37721],
[-125.75632, 69.48058],
[-124.42483, 70.1584],
[-124.28968, 69.39969],
[-123.06108, 69.56372],
[-122.6835, 69.85553],
[-121.47226, 69.79778],
[-119.94288, 69.37786],
[-117.60268, 69.01128],
[-116.22643, 68.84151],
[-115.2469, 68.90591],
[-113.89794, 68.3989],
[-115.30489, 67.90261],
[-113.49727, 67.68815],
[-110.798, 67.80612],
[-109.94619, 67.98104],
[-108.8802, 67.38144],
[-107.79239, 67.88736],
[-108.81299, 68.31164],
[-108.16721, 68.65392],
[-106.95, 68.7],
[-106.15, 68.8],
[-105.34282, 68.56122],
[-104.33791, 68.018],
[-103.22115, 68.09775],
[-101.45433, 67.64689],
[-99.90195, 67.80566],
[-98.4432, 67.78165],
[-98.5586, 68.40394],
[-97.66948, 68.57864],
[-96.11991, 68.23939],
[-96.12588, 67.29338],
[-95.48943, 68.0907],
[-94.685, 68.06383],
[-94.23282, 69.06903],
[-95.30408, 69.68571],
[-96.47131, 70.08976],
[-96.39115, 71.19482],
[-95.2088, 71.92053],
[-93.88997, 71.76015],
[-92.87818, 71.31869],
[-91.51964, 70.19129],
[-92.40692, 69.69997],
[-90.5471, 69.49766]
]
],
[
[
[-114.16717, 73.12145],
[-114.66634, 72.65277],
[-112.44102, 72.9554],
[-111.05039, 72.4504],
[-109.92035, 72.96113],
[-109.00654, 72.63335],
[-108.18835, 71.65089],
[-107.68599, 72.06548],
[-108.39639, 73.08953],
[-107.51645, 73.23598],
[-106.52259, 73.07601],
[-105.40246, 72.67259],
[-104.77484, 71.6984],
[-104.46476, 70.99297],
[-102.78537, 70.49776],
[-100.98078, 70.02432],
[-101.08929, 69.58447],
[-102.73116, 69.50402],
[-102.09329, 69.11962],
[-102.43024, 68.75282],
[-104.24, 68.91],
[-105.96, 69.18],
[-107.12254, 69.11922],
[-109, 68.78],
[-111.534149, 68.630059],
[-113.3132, 68.53554],
[-113.85496, 69.00744],
[-115.22, 69.28],
[-116.10794, 69.16821],
[-117.34, 69.96],
[-116.67473, 70.06655],
[-115.13112, 70.2373],
[-113.72141, 70.19237],
[-112.4161, 70.36638],
[-114.35, 70.6],
[-116.48684, 70.52045],
[-117.9048, 70.54056],
[-118.43238, 70.9092],
[-116.11311, 71.30918],
[-117.65568, 71.2952],
[-119.40199, 71.55859],
[-118.56267, 72.30785],
[-117.86642, 72.70594],
[-115.18909, 73.31459],
[-114.16717, 73.12145]
]
],
[
[
[-104.5, 73.42],
[-105.38, 72.76],
[-106.94, 73.46],
[-106.6, 73.6],
[-105.26, 73.64],
[-104.5, 73.42]
]
],
[
[
[-76.34, 73.102685],
[-76.251404, 72.826385],
[-77.314438, 72.855545],
[-78.39167, 72.876656],
[-79.486252, 72.742203],
[-79.775833, 72.802902],
[-80.876099, 73.333183],
[-80.833885, 73.693184],
[-80.353058, 73.75972],
[-78.064438, 73.651932],
[-76.34, 73.102685]
]
],
[
[
[-86.562179, 73.157447],
[-85.774371, 72.534126],
[-84.850112, 73.340278],
[-82.31559, 73.750951],
[-80.600088, 72.716544],
[-80.748942, 72.061907],
[-78.770639, 72.352173],
[-77.824624, 72.749617],
[-75.605845, 72.243678],
[-74.228616, 71.767144],
[-74.099141, 71.33084],
[-72.242226, 71.556925],
[-71.200015, 70.920013],
[-68.786054, 70.525024],
[-67.91497, 70.121948],
[-66.969033, 69.186087],
[-68.805123, 68.720198],
[-66.449866, 68.067163],
[-64.862314, 67.847539],
[-63.424934, 66.928473],
[-61.851981, 66.862121],
[-62.163177, 66.160251],
[-63.918444, 64.998669],
[-65.14886, 65.426033],
[-66.721219, 66.388041],
[-68.015016, 66.262726],
[-68.141287, 65.689789],
[-67.089646, 65.108455],
[-65.73208, 64.648406],
[-65.320168, 64.382737],
[-64.669406, 63.392927],
[-65.013804, 62.674185],
[-66.275045, 62.945099],
[-68.783186, 63.74567],
[-67.369681, 62.883966],
[-66.328297, 62.280075],
[-66.165568, 61.930897],
[-68.877367, 62.330149],
[-71.023437, 62.910708],
[-72.235379, 63.397836],
[-71.886278, 63.679989],
[-73.378306, 64.193963],
[-74.834419, 64.679076],
[-74.818503, 64.389093],
[-77.70998, 64.229542],
[-78.555949, 64.572906],
[-77.897281, 65.309192],
[-76.018274, 65.326969],
[-73.959795, 65.454765],
[-74.293883, 65.811771],
[-73.944912, 66.310578],
[-72.651167, 67.284576],
[-72.92606, 67.726926],
[-73.311618, 68.069437],
[-74.843307, 68.554627],
[-76.869101, 68.894736],
[-76.228649, 69.147769],
[-77.28737, 69.76954],
[-78.168634, 69.826488],
[-78.957242, 70.16688],
[-79.492455, 69.871808],
[-81.305471, 69.743185],
[-84.944706, 69.966634],
[-87.060003, 70.260001],
[-88.681713, 70.410741],
[-89.51342, 70.762038],
[-88.467721, 71.218186],
[-89.888151, 71.222552],
[-90.20516, 72.235074],
[-89.436577, 73.129464],
[-88.408242, 73.537889],
[-85.826151, 73.803816],
[-86.562179, 73.157447]
]
],
[
[
[-100.35642, 73.84389],
[-99.16387, 73.63339],
[-97.38, 73.76],
[-97.12, 73.47],
[-98.05359, 72.99052],
[-96.54, 72.56],
[-96.72, 71.66],
[-98.35966, 71.27285],
[-99.32286, 71.35639],
[-100.01482, 71.73827],
[-102.5, 72.51],
[-102.48, 72.83],
[-100.43836, 72.70588],
[-101.54, 73.36],
[-100.35642, 73.84389]
]
],
[
[
[-93.196296, 72.771992],
[-94.269047, 72.024596],
[-95.409856, 72.061881],
[-96.033745, 72.940277],
[-96.018268, 73.43743],
[-95.495793, 73.862417],
[-94.503658, 74.134907],
[-92.420012, 74.100025],
[-90.509793, 73.856732],
[-92.003965, 72.966244],
[-93.196296, 72.771992]
]
],
[
[
[-120.46, 71.383602],
[-123.09219, 70.90164],
[-123.62, 71.34],
[-125.928949, 71.868688],
[-125.5, 72.292261],
[-124.80729, 73.02256],
[-123.94, 73.68],
[-124.91775, 74.29275],
[-121.53788, 74.44893],
[-120.10978, 74.24135],
[-117.55564, 74.18577],
[-116.58442, 73.89607],
[-115.51081, 73.47519],
[-116.76794, 73.22292],
[-119.22, 72.52],
[-120.46, 71.82],
[-120.46, 71.383602]
]
],
[
[
[-93.612756, 74.979997],
[-94.156909, 74.592347],
[-95.608681, 74.666864],
[-96.820932, 74.927623],
[-96.288587, 75.377828],
[-94.85082, 75.647218],
[-93.977747, 75.29649],
[-93.612756, 74.979997]
]
],
[
[
[-98.5, 76.72],
[-97.735585, 76.25656],
[-97.704415, 75.74344],
[-98.16, 75],
[-99.80874, 74.89744],
[-100.88366, 75.05736],
[-100.86292, 75.64075],
[-102.50209, 75.5638],
[-102.56552, 76.3366],
[-101.48973, 76.30537],
[-99.98349, 76.64634],
[-98.57699, 76.58859],
[-98.5, 76.72]
]
],
[
[
[-108.21141, 76.20168],
[-107.81943, 75.84552],
[-106.92893, 76.01282],
[-105.881, 75.9694],
[-105.70498, 75.47951],
[-106.31347, 75.00527],
[-109.7, 74.85],
[-112.22307, 74.41696],
[-113.74381, 74.39427],
[-113.87135, 74.72029],
[-111.79421, 75.1625],
[-116.31221, 75.04343],
[-117.7104, 75.2222],
[-116.34602, 76.19903],
[-115.40487, 76.47887],
[-112.59056, 76.14134],
[-110.81422, 75.54919],
[-109.0671, 75.47321],
[-110.49726, 76.42982],
[-109.5811, 76.79417],
[-108.54859, 76.67832],
[-108.21141, 76.20168]
]
],
[
[
[-94.684086, 77.097878],
[-93.573921, 76.776296],
[-91.605023, 76.778518],
[-90.741846, 76.449597],
[-90.969661, 76.074013],
[-89.822238, 75.847774],
[-89.187083, 75.610166],
[-87.838276, 75.566189],
[-86.379192, 75.482421],
[-84.789625, 75.699204],
[-82.753445, 75.784315],
[-81.128531, 75.713983],
[-80.057511, 75.336849],
[-79.833933, 74.923127],
[-80.457771, 74.657304],
[-81.948843, 74.442459],
[-83.228894, 74.564028],
[-86.097452, 74.410032],
[-88.15035, 74.392307],
[-89.764722, 74.515555],
[-92.422441, 74.837758],
[-92.768285, 75.38682],
[-92.889906, 75.882655],
[-93.893824, 76.319244],
[-95.962457, 76.441381],
[-97.121379, 76.751078],
[-96.745123, 77.161389],
[-94.684086, 77.097878]
]
],
[
[
[-116.198587, 77.645287],
[-116.335813, 76.876962],
[-117.106051, 76.530032],
[-118.040412, 76.481172],
[-119.899318, 76.053213],
[-121.499995, 75.900019],
[-122.854924, 76.116543],
[-122.854925, 76.116543],
[-121.157535, 76.864508],
[-119.103939, 77.51222],
[-117.570131, 77.498319],
[-116.198587, 77.645287]
]
],
[
[
[-93.840003, 77.519997],
[-94.295608, 77.491343],
[-96.169654, 77.555111],
[-96.436304, 77.834629],
[-94.422577, 77.820005],
[-93.720656, 77.634331],
[-93.840003, 77.519997]
]
],
[
[
[-110.186938, 77.697015],
[-112.051191, 77.409229],
[-113.534279, 77.732207],
[-112.724587, 78.05105],
[-111.264443, 78.152956],
[-109.854452, 77.996325],
[-110.186938, 77.697015]
]
],
[
[
[-109.663146, 78.601973],
[-110.881314, 78.40692],
[-112.542091, 78.407902],
[-112.525891, 78.550555],
[-111.50001, 78.849994],
[-110.963661, 78.804441],
[-109.663146, 78.601973]
]
],
[
[
[-95.830295, 78.056941],
[-97.309843, 77.850597],
[-98.124289, 78.082857],
[-98.552868, 78.458105],
[-98.631984, 78.87193],
[-97.337231, 78.831984],
[-96.754399, 78.765813],
[-95.559278, 78.418315],
[-95.830295, 78.056941]
]
],
[
[
[-100.060192, 78.324754],
[-99.670939, 77.907545],
[-101.30394, 78.018985],
[-102.949809, 78.343229],
[-105.176133, 78.380332],
[-104.210429, 78.67742],
[-105.41958, 78.918336],
[-105.492289, 79.301594],
[-103.529282, 79.165349],
[-100.825158, 78.800462],
[-100.060192, 78.324754]
]
],
[
[
[-87.02, 79.66],
[-85.81435, 79.3369],
[-87.18756, 79.0393],
[-89.03535, 78.28723],
[-90.80436, 78.21533],
[-92.87669, 78.34333],
[-93.95116, 78.75099],
[-93.93574, 79.11373],
[-93.14524, 79.3801],
[-94.974, 79.37248],
[-96.07614, 79.70502],
[-96.70972, 80.15777],
[-96.01644, 80.60233],
[-95.32345, 80.90729],
[-94.29843, 80.97727],
[-94.73542, 81.20646],
[-92.40984, 81.25739],
[-91.13289, 80.72345],
[-89.45, 80.509322],
[-87.81, 80.32],
[-87.02, 79.66]
]
],
[
[
[-68.5, 83.106322],
[-65.82735, 83.02801],
[-63.68, 82.9],
[-61.85, 82.6286],
[-61.89388, 82.36165],
[-64.334, 81.92775],
[-66.75342, 81.72527],
[-67.65755, 81.50141],
[-65.48031, 81.50657],
[-67.84, 80.9],
[-69.4697, 80.61683],
[-71.18, 79.8],
[-73.2428, 79.63415],
[-73.88, 79.430162],
[-76.90773, 79.32309],
[-75.52924, 79.19766],
[-76.22046, 79.01907],
[-75.39345, 78.52581],
[-76.34354, 78.18296],
[-77.88851, 77.89991],
[-78.36269, 77.50859],
[-79.75951, 77.20968],
[-79.61965, 76.98336],
[-77.91089, 77.022045],
[-77.88911, 76.777955],
[-80.56125, 76.17812],
[-83.17439, 76.45403],
[-86.11184, 76.29901],
[-87.6, 76.42],
[-89.49068, 76.47239],
[-89.6161, 76.95213],
[-87.76739, 77.17833],
[-88.26, 77.9],
[-87.65, 77.970222],
[-84.97634, 77.53873],
[-86.34, 78.18],
[-87.96192, 78.37181],
[-87.15198, 78.75867],
[-85.37868, 78.9969],
[-85.09495, 79.34543],
[-86.50734, 79.73624],
[-86.93179, 80.25145],
[-84.19844, 80.20836],
[-83.408696, 80.1],
[-81.84823, 80.46442],
[-84.1, 80.58],
[-87.59895, 80.51627],
[-89.36663, 80.85569],
[-90.2, 81.26],
[-91.36786, 81.5531],
[-91.58702, 81.89429],
[-90.1, 82.085],
[-88.93227, 82.11751],
[-86.97024, 82.27961],
[-85.5, 82.652273],
[-84.260005, 82.6],
[-83.18, 82.32],
[-82.42, 82.86],
[-81.1, 83.02],
[-79.30664, 83.13056],
[-76.25, 83.172059],
[-75.71878, 83.06404],
[-72.83153, 83.23324],
[-70.665765, 83.169781],
[-68.5, 83.106322]
]
]
],
"type": "MultiPolygon"
},
"id": "CAN",
"properties": { "name": "Canada" },
"type": "Feature"
}
],
"type": "FeatureCollection"
},
"languages": ["en", "fr"],
"latlng": [60, -95],
"name": "Canada",
"nativeName": "Canada",
"population": 35540419,
"provinces": [
"Alberta",
"British Columbia",
"Manitoba",
"New Brunswick",
"Newfoundland",
"Northwest Territories",
"Nova Scotia",
"Nunavut",
"Ontario",
"Prince Edward Island",
"Quebec",
"Saskatchewan",
"Yukon Territory"
],
"region": "Americas",
"subregion": "Northern America",
"timezones": [
"UTC−08:00",
"UTC−07:00",
"UTC−06:00",
"UTC−05:00",
"UTC−04:00",
"UTC−03:00"
],
"tld": [".ca"],
"translations": {
"de": "Kanada",
"es": "Canadá",
"fr": "Canada",
"it": "Canada",
"ja": "カナダ"
},
"wiki": "http://en.wikipedia.org/wiki/canada"
}
} Find Amenities
Provides a list of nearby health facilities or amenities based on the specified location, facility type, and country. This endpoint is useful for finding health services or specific amenities within a country or city.
Options:
aerodrome, bar, cafe, fast_food, pub, restaurant, college, driving_school, school, university, bank, atm, pharmacy, etc..
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | Yes | The name of the country where the search will take place (case-insensitive). |
| type | string | Yes | Type of facility to search for, defaulting to "hospital" (e.g., "clinic", "pharmacy"). Options: aerodrome, bar, cafe, fast_food, pub, restaurant, college, driving_school, school, university, bank, atm, pharmacy, etc.. |
| state | string | Yes | Name of the state or region for a more localized search. |
| city | string | Yes | Name of the city within the specified state. |
| limit | int | Optional | Maximum number of results to return, defaulting to 10. |
Python Requests Example:
import requests
url = "https://countries-info-api.p.rapidapi.com/amenity"
querystring = {"country":"USA","type":"hospital","state":"new york","city":"new york","limit":"10"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "countries-info-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())Response Example:
{
"facilities": [
{
"address": {
"city": "Bronx",
"housenumber": "111",
"postcode": "10467",
"street": "East 210th Street"
},
"lat": 40.8800853,
"lon": -73.8798439,
"name": "Montefiore Medical Center West Campus Moses Division Hospital",
"phone": "+1...",
"website": "https://www.montefiore.org/west"
},
{
"address": {
"city": "Bronx",
"housenumber": "1300",
"postcode": "10461",
"street": "Waters Place"
},
"lat": 40.8464723,
"lon": -73.8388275,
"name": "New York City Children's Center Bronx Campus",
"phone": "+1...",
"website": "https://www.omh.ny.gov/omhweb/facilities/nyccc/bcpc/"
},
{
"address": {
"city": "Wards Island",
"housenumber": "600",
"postcode": "10029",
"street": "East 125th Street"
},
"lat": 40.7865276,
"lon": -73.9322574,
"name": "Kirby Forensic Psychiatric Center",
"phone": "+1...",
"website": "https://www.omh.ny.gov/omhweb/facilities/krpc/"
},
{
"address": {
"city": "Bronx",
"housenumber": "3424",
"postcode": "10467",
"street": "Kossuth Avenue"
},
"lat": 40.8803581,
"lon": -73.8813965,
"name": "North Central Bronx Hospital",
"phone": "+1...",
"website": "https://www.nychealthandhospitals.org/northcentralbronx/"
},
{
"address": {
"city": "New York",
"housenumber": "13",
"postcode": "10029",
"street": "Hell Gate Circle"
},
"lat": 40.7851459,
"lon": -73.9279094,
"name": "George Rosenfeld Center for Recovery",
"phone": "+1...",
"website": "https://odysseyhousenyc.org/george-rosenfeld-center-for-recovery/"
},
{
"address": {
"city": "New Hyde Park",
"housenumber": "269-01",
"postcode": "11040",
"street": "76th Avenue"
},
"lat": 40.7538889,
"lon": -73.7083333,
"name": "Cohen\u2019s Children\u2019s Medical Center",
"phone": "+1...",
"website": "https://childrenshospital.northwell.edu/"
},
{
"address": {
"city": "New York",
"housenumber": "30",
"postcode": "10011",
"street": "7th Avenue"
},
"lat": 40.7377778,
"lon": -74.0008333,
"name": "Lenox Health Greenwich Village",
"phone": "+1...",
"website": "https://www.northwell.edu/lenox-health-greenwich-village"
},
{
"address": {
"city": "New York",
"housenumber": "420",
"postcode": "10021",
"street": "East 76th Street"
},
"lat": 40.7697091,
"lon": -73.9529748,
"name": "Gracie Square Hospital",
"phone": "+1...",
"website": "https://www.nygsh.org/"
},
{
"address": {
"city": "New York",
"housenumber": "1230",
"postcode": "10021",
"street": "York Avenue"
},
"lat": 40.7620381,
"lon": -73.9553606,
"name": "Rockefeller University Hospital",
"phone": "+1...",
"website": "https://rucares.org/"
},
{
"address": {
"city": "New York",
"housenumber": "310",
"postcode": "10003",
"street": "East 14th Street"
},
"lat": 40.7318799,
"lon": -73.9845807,
"name": "New York Eye and Ear Infirmary of Mount Sinai",
"phone": "+1...",
"website": "http://www.nyee.edu/"
}
]
} Geo Distance
The /distance endpoint calculates the driving distance and duration between two geographic locations based on latitude and longitude coordinates. It uses the OSRM (Open Source Routing Machine) API for retrieving accurate driving data.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| lat1 | int | Yes | Latitude of the starting point. |
| lon1 | int | Yes | Longitude of the starting point. |
| lat2 | int | Yes | Latitude of the destination point. |
| lon2 | int | Yes | Longitude of the destination point. |
| unit | string | Optional | Unit of measurement for the distance. Valid options are: 'km' - kilometers 'mi' - miles 'ft' - feet 'yd' - yards |
Python Requests Example:
import requests
url = "https://countries-info-api.p.rapidapi.com/distance"
querystring = {"lat1":"40.748817","lon1":"-73.985428","lat2":"34.052235","lon2":"-118.243683","unit":"mi"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "countries-info-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())
Response Example:
{
"distance":"2794.81 mi",
"duration":"49h 37min 54s",
"unit":"mi"
} Geo Directions
The /directions endpoint provides step-by-step driving directions, including the total distance and duration between two geographic locations. It relies on the OSRM (Open Source Routing Machine) API for accurate routing data and offers an option to choose between kilometers and miles for distance units.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| lat1 | int | Yes | Latitude of the starting point. |
| lon1 | int | Yes | Longitude of the starting point. |
| lat2 | int | Yes | Latitude of the destination point. |
| lon2 | int | Yes | Longitude of the destination point. |
| unit | string | Optional | Unit of measurement for the distance. Valid options are: 'km' - kilometers 'mi' - miles. |
Python Requests Example:
import requests
url = "https://countries-info-api.p.rapidapi.com/directions"
querystring = {"lat1":"40.748817","lon1":"-73.985428","lat2":"34.052235","lon2":"-118.243683","unit":"km"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "countries-info-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())Response Example:
{
"distance": "4497.81 km",
"duration": "49h 37min 54s",
"steps": [
{
"direction": "depart",
"distance": "1.18 km",
"duration": "2min 35s",
"instruction": "West 34th Street",
"location": [-73.985425, 40.748821]
},
{
"direction": "turn",
"distance": "0.17 km",
"duration": "0min 22s",
"instruction": "Dyer Avenue",
"location": [-73.997611, 40.753946]
},
{
"direction": "on ramp",
"distance": "0.15 km",
"duration": "0min 16s",
"instruction": "",
"location": [-73.996397, 40.755115]
},
{
"direction": "merge",
"distance": "0.03 km",
"duration": "0min 4s",
"instruction": "Lincoln Tunnel Expressway",
"location": [-73.995113, 40.756005]
},
{
"direction": "fork",
"distance": "5.94 km",
"duration": "6min 49s",
"instruction": "Lincoln Tunnel Expressway",
"location": [-73.994969, 40.75627]
},
{
"direction": "off ramp",
"distance": "0.49 km",
"duration": "0min 30s",
"instruction": "",
"location": [-74.042412, 40.776574]
},
{
"direction": "fork",
"distance": "0.15 km",
"duration": "0min 7s",
"instruction": "",
"location": [-74.046071, 40.77983]
},
{
"direction": "merge",
"distance": "16.40 km",
"duration": "12min 7s",
"instruction": "",
"location": [-74.04664, 40.781132]
},
{
"direction": "merge",
"distance": "28.45 km",
"duration": "20min 58s",
"instruction": "",
"location": [-74.189079, 40.87099]
},
{
"direction": "off ramp",
"distance": "0.37 km",
"duration": "0min 30s",
"instruction": "",
"location": [-74.486204, 40.896413]
},
{
"direction": "merge",
"distance": "21.18 km",
"duration": "15min 10s",
"instruction": "Christopher Columbus Highway",
"location": [-74.48902, 40.899]
},
{
"direction": "fork",
"distance": "41.74 km",
"duration": "31min 9s",
"instruction": "Christopher Columbus Highway",
"location": [-74.721227, 40.902694]
},
{
"direction": "fork",
"distance": "0.28 km",
"duration": "0min 11s",
"instruction": "",
"location": [-75.137333, 40.981828]
},
{
"direction": "merge",
"distance": "0.12 km",
"duration": "0min 5s",
"instruction": "",
"location": [-75.137944, 40.984285]
},
{
"direction": "fork",
"distance": "8.40 km",
"duration": "7min 49s",
"instruction": "",
"location": [-75.13831, 40.985357]
},
{
"direction": "fork",
"distance": "512.12 km",
"duration": "5h 48min 43s",
"instruction": "",
"location": [-75.217349, 40.984766]
},
{
"direction": "fork",
"distance": "7.26 km",
"duration": "5min 12s",
"instruction": "",
"location": [-80.747073, 41.128673]
},
{
"direction": "off ramp",
"distance": "0.78 km",
"duration": "1min 2s",
"instruction": "",
"location": [-80.828279, 41.110944]
},
{
"direction": "fork",
"distance": "0.72 km",
"duration": "1min 6s",
"instruction": "",
"location": [-80.836944, 41.112812]
},
{
"direction": "merge",
"distance": "351.56 km",
"duration": "3h 54min 28s",
"instruction": "Ohio Turnpike",
"location": [-80.843161, 41.116887]
},
{
"direction": "new name",
"distance": "218.57 km",
"duration": "2h 26min 50s",
"instruction": "Indiana Toll Road",
"location": [-84.805714, 41.628633]
},
{
"direction": "off ramp",
"distance": "0.96 km",
"duration": "1min 17s",
"instruction": "",
"location": [-87.228396, 41.591702]
},
{
"direction": "fork",
"distance": "0.17 km",
"duration": "0min 13s",
"instruction": "",
"location": [-87.232965, 41.588706]
},
{
"direction": "fork",
"distance": "22.92 km",
"duration": "19min 37s",
"instruction": "",
"location": [-87.233185, 41.587248]
},
{
"direction": "off ramp",
"distance": "0.32 km",
"duration": "0min 16s",
"instruction": "",
"location": [-87.501246, 41.574248]
},
{
"direction": "fork",
"distance": "0.36 km",
"duration": "0min 18s",
"instruction": "",
"location": [-87.505066, 41.574364]
},
{
"direction": "fork",
"distance": "0.55 km",
"duration": "0min 27s",
"instruction": "",
"location": [-87.509404, 41.5743]
},
{
"direction": "merge",
"distance": "0.83 km",
"duration": "0min 42s",
"instruction": "Borman Expressway",
"location": [-87.515967, 41.574712]
},
{
"direction": "new name",
"distance": "1.33 km",
"duration": "1min 7s",
"instruction": "Kingery Expressway",
"location": [-87.525359, 41.577185]
},
{
"direction": "off ramp",
"distance": "2.42 km",
"duration": "2min 3s",
"instruction": "",
"location": [-87.541251, 41.577932]
},
{
"direction": "fork",
"distance": "0.52 km",
"duration": "0min 26s",
"instruction": "",
"location": [-87.570244, 41.578065]
},
{
"direction": "merge",
"distance": "7.82 km",
"duration": "6min 37s",
"instruction": "Tri-State Tollway",
"location": [-87.576457, 41.577834]
},
{
"direction": "fork",
"distance": "233.91 km",
"duration": "2h 40min 58s",
"instruction": "",
"location": [-87.669886, 41.578256]
},
{
"direction": "fork",
"distance": "15.42 km",
"duration": "10min 15s",
"instruction": "",
"location": [-90.32135, 41.440332]
},
{
"direction": "fork",
"distance": "131.96 km",
"duration": "1h 30min 3s",
"instruction": "",
"location": [-90.490296, 41.457568]
},
{
"direction": "new name",
"distance": "164.20 km",
"duration": "1h 51min 3s",
"instruction": "",
"location": [-91.891961, 41.687499]
},
{
"direction": "fork",
"distance": "191.77 km",
"duration": "2h 8min 25s",
"instruction": "",
"location": [-93.777208, 41.59752]
},
{
"direction": "fork",
"distance": "571.98 km",
"duration": "6h 0min 1s",
"instruction": "",
"location": [-95.834326, 41.231874]
},
{
"direction": "fork",
"distance": "286.47 km",
"duration": "2h 58min 42s",
"instruction": "",
"location": [-102.136374, 41.036115]
},
{
"direction": "fork",
"distance": "16.02 km",
"duration": "11min 30s",
"instruction": "Heartland Expressway",
"location": [-104.91952, 39.851128]
},
{
"direction": "merge",
"distance": "5.65 km",
"duration": "4min 3s",
"instruction": "",
"location": [-105.079382, 39.786562]
},
{
"direction": "fork",
"distance": "801.77 km",
"duration": "8h 32min 44s",
"instruction": "",
"location": [-105.142501, 39.777395]
},
{
"direction": "fork",
"distance": "1.91 km",
"duration": "2min 33s",
"instruction": "",
"location": [-112.599121, 38.579705]
},
{
"direction": "merge",
"distance": "258.90 km",
"duration": "2h 39min 46s",
"instruction": "Veterans Memorial Highway",
"location": [-112.604999, 38.565796]
},
{
"direction": "new name",
"distance": "131.03 km",
"duration": "1h 23min 0s",
"instruction": "Las Vegas Freeway",
"location": [-114.050018, 36.817918]
},
{
"direction": "off ramp",
"distance": "0.15 km",
"duration": "0min 6s",
"instruction": "",
"location": [-115.159656, 36.168053]
},
{
"direction": "new name",
"distance": "6.03 km",
"duration": "4min 19s",
"instruction": "I-15 HOV Lanes",
"location": [-115.159998, 36.166707]
},
{
"direction": "merge",
"distance": "61.98 km",
"duration": "42min 19s",
"instruction": "Las Vegas Freeway",
"location": [-115.180848, 36.117159]
},
{
"direction": "new name",
"distance": "9.14 km",
"duration": "6min 5s",
"instruction": "Mojave Freeway",
"location": [-115.391479, 35.607342]
},
{
"direction": "fork",
"distance": "242.36 km",
"duration": "2h 41min 50s",
"instruction": "Mojave Freeway",
"location": [-115.424758, 35.529621]
},
{
"direction": "new name",
"distance": "2.47 km",
"duration": "1min 38s",
"instruction": "Barstow and Mojave Freeway (Heavy Traffic Route)",
"location": [-117.42077, 34.376471]
},
{
"direction": "new name",
"distance": "18.26 km",
"duration": "12min 10s",
"instruction": "Mojave Freeway",
"location": [-117.436662, 34.35854]
},
{
"direction": "new name",
"distance": "0.86 km",
"duration": "0min 34s",
"instruction": "Barstow and Mojave Freeway (Heavy Traffic Route)",
"location": [-117.431969, 34.241579]
},
{
"direction": "fork",
"distance": "0.24 km",
"duration": "0min 9s",
"instruction": "",
"location": [-117.42513, 34.236341]
},
{
"direction": "fork",
"distance": "23.67 km",
"duration": "16min 18s",
"instruction": "",
"location": [-117.423262, 34.234865]
},
{
"direction": "off ramp",
"distance": "0.79 km",
"duration": "1min 3s",
"instruction": "",
"location": [-117.545069, 34.071111]
},
{
"direction": "merge",
"distance": "43.37 km",
"duration": "31min 4s",
"instruction": "San Bernardino Freeway",
"location": [-117.55092, 34.067543]
},
{
"direction": "fork",
"distance": "21.33 km",
"duration": "15min 18s",
"instruction": "San Bernardino Freeway",
"location": [-118.004303, 34.064658]
},
{
"direction": "merge",
"distance": "0.71 km",
"duration": "0min 36s",
"instruction": "Santa Ana Freeway",
"location": [-118.226134, 34.052738]
},
{
"direction": "off ramp",
"distance": "0.40 km",
"duration": "0min 27s",
"instruction": "",
"location": [-118.233677, 34.053816]
},
{
"direction": "new name",
"distance": "0.15 km",
"duration": "0min 17s",
"instruction": "Arcadia Street",
"location": [-118.237841, 34.054532]
},
{
"direction": "turn",
"distance": "0.52 km",
"duration": "0min 46s",
"instruction": "North Los Angeles Street",
"location": [-118.239171, 34.05527]
},
{
"direction": "turn",
"distance": "0.14 km",
"duration": "0min 17s",
"instruction": "East 1st Street",
"location": [-118.242411, 34.051518]
},
{
"direction": "arrive",
"distance": "0.00 km",
"duration": "0min 0s",
"instruction": "West 1st Street",
"location": [-118.243574, 34.052343]
}
]
} Trending Stories
The /trending endpoint retrieves a list of trending news stories for a specified country and language. It supports filtering news based on optional keywords and allows setting a limit on the number of results. The endpoint uses the Google News Feed API to fetch trending stories, providing information such as title, link, publication date, description, and source for each news item.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | Yes | Country code (e.g., US, GB) to filter news by country. Defaults to 'US'. |
| language | string | Optional | Language code (e.g., en, fr) for the news language. Defaults to 'en'. |
| keywords | string | Yes | Keywords to search for specific news topics. If not provided, it fetches general top headlines. |
| limit | int | Optional | Number of news items to return. Defaults to 10. |
Python Requests Example:
import requests
url = "https://countries-info-api.p.rapidapi.com/trending"
querystring = {"country":"US","language":"en","keywords":"AI News","limit":"10"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "countries-info-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())Response Example:
{
"trending_stories": [
{
"description": "Graph-based AI model maps the future of innovation",
"link": "https://accounts.google.com/ServiceLogin?hl=en-US&continue=https://news.google.com/rss/articles/CBMif0FVX3lxTE9HbnBsTFRabjN2emxENW5uNGpERm5sazIwdTgwb1pWeDdLU3o1NHhIRmttTHVZUWJ6Sm5lcU85bHFmVC1WYUFDRHBCbXA3QnFidUhsWFlrQ255Mm85c1R1cGpJU2pqUUZzSF9iZXphYkx3bXp0ZXFRQ1JQNno0Z3M?oc%3D5&gae=cb-",
"pubDate": "Tue, 12 Nov 2024 20:45:00 GMT",
"source": "MIT News",
"title": "Graph-based AI model maps the future of innovation - MIT News"
},
{
"description": "SoundHound AI Enunciates Q3 Beat-And-Raise, But Stock Falls",
"link": "https://accounts.google.com/ServiceLogin?hl=en-US&continue=https://news.google.com/rss/articles/CBMikAFBVV95cUxPWVRLcllqN1JmQWtUa1ZSZ1pfYjExeXgtaFRUVE9xRUF6Zmk4anhYNGcyZXdRMUI0RksxWFFHYkNwVnd2ZWdHVjRZRTNsWTJfV1Y0NEJBM0pHcUtjbUFvdzBnTllPWVc3bnAwTHUxVGE5dEk5emVsOTFmakc3cTB4LV9VRlZfWUwzQ1NHeFRibnE?oc%3D5&gae=cb-",
"pubDate": "Tue, 12 Nov 2024 22:52:00 GMT",
"source": "Investor's Business Daily",
"title": "SoundHound AI Enunciates Q3 Beat-And-Raise, But Stock Falls - Investor's Business Daily"
},
{
"description": "SoundHound AI Reports Record Third Quarter Revenue, Up 89%, Exceeding $25 Million; Raises Outlook",
"link": "https://accounts.google.com/ServiceLogin?hl=en-US&continue=https://news.google.com/rss/articles/CBMi4wFBVV95cUxQSDdIRmdxR2U5RlRlWFhVOVN3M25SSWhuSm8zLThiVm9EYWZWeEhYQWUtZW4xQUNNUE5zZlRZbU9pSzVlMXNRZnlmWlB2QVpSRlUzSTJ0QTEtRVBHekI3cFFxWS1IcEN4c3NBYTBpcGlKbHlYYXFzUXlobTZsamhBRDVEOERRU0dvQzJKUWluLUttQlk1WjF4eEdNUHFlaXZ4S0F0eDBIUHo1N1dObjFVQ1E5MlMycHpBaGpwZlJkLVdPd0JibGN4Q05fSkMyS3RkSEt6dlg3czZyV2M3a2dVaHcxWQ?oc%3D5&gae=cb-",
"pubDate": "Tue, 12 Nov 2024 21:08:00 GMT",
"source": "Business Wire",
"title": "SoundHound AI Reports Record Third Quarter Revenue, Up 89%, Exceeding $25 Million; Raises Outlook - Business Wire"
},
{
"description": "SoundHound AI Revenue Soars 89% to Record $25.1M, Diversifies Customer Base in Q3 | SOUN Stock News",
"link": "https://accounts.google.com/ServiceLogin?hl=en-US&continue=https://news.google.com/rss/articles/CBMivwFBVV95cUxOYnhjY0JJckZwMk5QdU82S016VVpXd0tIMHlQQU5MdHFfak5EUWNPckp5Z2Eydk0zXzBJa0Q1Y0JfZ3hheFFIWC1iZHpkcG9lTGlPOXAtQ1JYdXMyTVg5bk9uUk9HWVUyQmRaRXo5RlcyRWFnUlVqeDZDbWpiU2pXcVl4NjlMUXRFTlQwNlhuWjlZMGVCTUNVSzk0bkxfamYyTzRQWnh2aGp5UXJNd1Z4MHNOdUU4VVM2VklGR1dySQ?oc%3D5&gae=cb-",
"pubDate": "Tue, 12 Nov 2024 21:08:00 GMT",
"source": "StockTitan",
"title": "SoundHound AI Revenue Soars 89% to Record $25.1M, Diversifies Customer Base in Q3 | SOUN Stock News - StockTitan"
},
{
"description": "How I addressed racial bias in my company\u2019s AI algorithm",
"link": "https://accounts.google.com/ServiceLogin?hl=en-US&continue=https://news.google.com/rss/articles/CBMiiAFBVV95cUxNRFdsdWRlVlZjODhfRHFnV1BYbzFCd2Fsa0FXTWZXN2d0UE5XMjJ1aWItUHRvMm5CMGhBd1ItRWxxbFRUc3dEQnQ5XzZLVkRVa2dlYXR5Qlp4U2hRQUdhNGVLYkE2YkRNMWJXRTRuMkduOFZFZjZtcE9ZdWRvbm5EUy1VNndDTG1r?oc%3D5&gae=cb-",
"pubDate": "Wed, 13 Nov 2024 09:32:29 GMT",
"source": "STAT",
"title": "How I addressed racial bias in my company\u2019s AI algorithm - STAT"
},
{
"description": "The AI Tipping Point: Half of CFOs will axe AI investment if it doesn't show ROI next year",
"link": "https://accounts.google.com/ServiceLogin?hl=en-US&continue=https://news.google.com/rss/articles/CBMifEFVX3lxTE5TZmlXM0NVLVFKZnVQcEhUcGUzb2xhYkpfWk43Yy00RzcwWVhiNlBMUnN2d3I3ZkdnVGlBcDRXRmpqVE1tdWx5SGx1MllERjNQNGZOc2hNUVp2UFN1UWxJWXRaQ0RZdExEMWZTWHhocm5UeGwzZjRwbHJnXzk?oc%3D5&gae=cb-",
"pubDate": "Wed, 13 Nov 2024 08:00:00 GMT",
"source": "Yahoo Finance",
"title": "The AI Tipping Point: Half of CFOs will axe AI investment if it doesn't show ROI next year - Yahoo Finance"
},
{
"description": "AI protein-prediction tool AlphaFold3 is now open source",
"link": "https://accounts.google.com/ServiceLogin?hl=en-US&continue=https://news.google.com/rss/articles/CBMiX0FVX3lxTE84dWJsS0hrRG1OXzh0TERRWEtlV1FwbHRySWt0R0JwVjNUSVA2N3FHNnVpTkR6QWlBT0YyTThydVUxSjFiUDZfX3V2b1A4UC14Y0ZScnFmX1p5QThLbndN?oc%3D5&gae=cb-",
"pubDate": "Mon, 11 Nov 2024 13:25:39 GMT",
"source": "Nature.com",
"title": "AI protein-prediction tool AlphaFold3 is now open source - Nature.com"
},
{
"description": "AI Can Save Humanity\u2014Or End It",
"link": "https://accounts.google.com/ServiceLogin?hl=en-US&continue=https://news.google.com/rss/articles/CBMiowFBVV95cUxOVzBtbXZLR1htT3dUd19vWEw4b1N6QVJxX2ctOThsNUJVSlQ2MmYySzFPZXM3RGRNQ1Y0TENvaW8xQ0g2aXNOa2ZCYlNlMkE2cS15b2RjdVByc3EzdFNEaUFzM2hNNFhINi1ZU0tLTkhNLW93SGZuejlCaDB1MTFaSFVfVVpZR0JIODdyWHNhNjQySTZvTi1UWUNkZC1xT2dhd3lR?oc%3D5&gae=cb-",
"pubDate": "Tue, 12 Nov 2024 15:59:00 GMT",
"source": "The Atlantic",
"title": "AI Can Save Humanity\u2014Or End It - The Atlantic"
},
{
"description": "NVIDIA and SoftBank Corp. Accelerate Japan\u2019s Journey to Global AI Powerhouse",
"link": "https://accounts.google.com/ServiceLogin?hl=en-US&continue=https://news.google.com/rss/articles/CBMipwFBVV95cUxNVWx4MFVoTU9iNXJuOFpEaEtleHlzSy1JR3lCWWtodE1ETXpEb3QwWmFJMWwtM2JFUGdaVTh1eDVCWk5KUVh4RTNQb0ZSMjRnaWlvZU5tVFdZN0V3WTE4ZXVGMGREUTZ2a1B6U1dZTDNDMzZLUUdVbnhGZmZxRDVBcGFOcVV3Tmtic25YamlMdHpNUHl0dzg5OHJfMXd6REI1TE4zbU1xbw?oc%3D5&gae=cb-",
"pubDate": "Wed, 13 Nov 2024 02:06:39 GMT",
"source": "NVIDIA Blog",
"title": "NVIDIA and SoftBank Corp. Accelerate Japan\u2019s Journey to Global AI Powerhouse - NVIDIA Blog"
},
{
"description": "SoftBank first to receive new Nvidia chips for supercomputer",
"link": "https://accounts.google.com/ServiceLogin?hl=en-US&continue=https://news.google.com/rss/articles/CBMitgFBVV95cUxOLVRsM0s3eDdnYVY2OUNIWEYzVUhmV3ZyVG53cjVuTTZJQTFSRVdZaFRvSHdBYVB6UHNsdWpJaU1pNzNZZVBrMHpLakJ5d180VXdWMXNqeEJOTUVmLUJnOW9wV1kzTDRXOE1fbVBuZkhRRnRRRkhZX05XMVhMVXhFY050blFGemY0b1VsTnVIQk5CWkpBSldyNzdBbEdHbjZzbDFyTEFBazhKTkJpc1N5bFBDZjZFZw?oc%3D5&gae=cb-",
"pubDate": "Wed, 13 Nov 2024 07:01:00 GMT",
"source": "Reuters",
"title": "SoftBank first to receive new Nvidia chips for supercomputer - Reuters"
}
]
} XChange Rate
Fetches the current exchange rate between two currencies and calculates the converted amount based on a specified value.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| amount | int | Optional | The amount in currency_from to convert |
| currency_from | string | Yes | The currency code to convert from (e.g., USD, GBP). |
| currency_to | string | Yes | The currency code to convert to (e.g., EUR, JPY). |
Python Requests Example:
import requests
url = "https://countries-info-api.p.rapidapi.com/xchange-rate"
querystring = {"amount":"1","currency_from":"USD","currency_to":"GBP"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "countries-info-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())Response Example:
{
"converted_amount":0.783,
"currency_from":"USD",
"currency_to":"GBP",
"exchange_rate":0.783
} Public Holidays
Retrieves a list of public holidays for a specified country and year.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| year | string | Optional | The year for which to fetch holidays. |
| country | string | Yes | The country code for which to fetch holidays (e.g., US, FR, CA). |
Python Requests Example:
import requests
url = "https://countries-info-api.p.rapidapi.com/holiday"
querystring = {"country":"US"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "countries-info-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())Response Example:
{
"holidays": [
{
"date": "2024-01-01",
"description": "New Year's Day in US",
"name": "New Year's Day"
},
{
"date": "2024-01-15",
"description": "Martin Luther King Jr. Day in US",
"name": "Martin Luther King Jr. Day"
},
{
"date": "2024-02-19",
"description": "Washington's Birthday in US",
"name": "Washington's Birthday"
},
{
"date": "2024-05-27",
"description": "Memorial Day in US",
"name": "Memorial Day"
},
{
"date": "2024-06-19",
"description": "Juneteenth National Independence Day in US",
"name": "Juneteenth National Independence Day"
},
{
"date": "2024-07-04",
"description": "Independence Day in US",
"name": "Independence Day"
},
{
"date": "2024-09-02",
"description": "Labor Day in US",
"name": "Labor Day"
},
{
"date": "2024-10-14",
"description": "Columbus Day in US",
"name": "Columbus Day"
},
{
"date": "2024-11-11",
"description": "Veterans Day in US",
"name": "Veterans Day"
},
{
"date": "2024-11-28",
"description": "Thanksgiving in US",
"name": "Thanksgiving"
},
{
"date": "2024-12-25",
"description": "Christmas Day in US",
"name": "Christmas Day"
}
]
} Timezone
Retrieves the current local time and timezone information for a specified location.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| location | string | Yes | The name of the location (e.g., New York, Tokyo) for which to fetch the timezone and current time. |
Python Requests Example:
import requests
url = "https://countries-info-api.p.rapidapi.com/time-zone"
querystring = {"location":"Douala"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "countries-info-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())Response Example:
{
"current_local_time":"2024-11-13 11:11:30",
"location":"Douala",
"time_zone":"Africa/Douala",
"utc_offset":"UTC +1.00"
} Subscribe to Countries Info API
Subscribe to Countries Info API
Subscribe to Countries Info API
Subscribe to Countries Info API