Examples

• Get the number of objects in the Pan-STARRS DR1 catalogue (json format):

  https://cats.oas.inaf.it/panssdr1_mini/?n_objects&json

  {"status":0, "errmsg":"", "qry":"SELECT count(*) as n_objs FROM panss_mini", "n_objs_found":1919106885, "n_objs":1919106885, "db":"TOCatsweb", "catname": "panss_mini", "catview":"panss_mini_healp_nest_10", "is_hips":false, "order_cat":10}
  

• Get the number of objects in the Gaia DR3 catalogue (at HiPS order 9) in a 0.5 degrees radius cone:

  https://cats.oas.inaf.it/gaiadr3_hips9/radius=0.5&ra=253.645&dec=-42.362?n_objects

• Get the number of objects in the Gaia DR3 catalogue (parent catalogue) in a 6 arcmin radius cone:

  https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.645&dec=-42.362?n_objects

• Retrieve the data of the objects in the Gaia DR3 catalogue (parent catalogue) in a 6 arcmin radius cone (limit the number of returned objects with maxobjs or limit - def. 10,000):

  https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.645&dec=-42.362?maxobjs=100

• Retrieve the data of the objects in the SkyMapper DR1 catalogue (HiPS order 3) in a 100 degrees cone:

  https://cats.oas.inaf.it/skymapperdr1_hips3/radius=100&ra=238.976&dec=-48.952?maxobjs=1000

Query using cURL

Note: you can also use wget, but curl is preferable.

curl -o mycat.vot 'https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.816&dec=-42.192&limit=100'
curl -o mycat.csv 'https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.816&dec=-42.192&limit=100&csv'

curl -H "Accept: application/json" -H "Content-Type: application/json" \
     -o mycat.json \
     -X GET "https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.816&dec=-42.192&limit=100&json"

or (better for use in a script - note the use of the -d option!)

curl -G https://cats.oas.inaf.it/gaiadr3/ \
  -o mycat.vot \
  -d radius=0.1 -d ra=253.816 -d dec=-42.192 -d limit=100

A simple Python script

#!/usr/bin/env python
# Python 2 using "urllib"
#
import urllib, json
url = "https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.816&dec=-42.192&limit=100&json"
response = urllib.urlopen(url)
output = json.loads(response.read())
print output

#!/usr/bin/env python
# Python 3 using "urllib"
#
from urllib.request import urlopen
url = "https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.816&dec=-42.192&limit=100&json"
response = urlopen(url)
print(response.read())

#!/usr/bin/env python
# Python 3 using "requests"
#
import requests
url = "https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.816&dec=-42.192&limit=100&json"
response = requests.get(url)
print(response.json())

# HTML output
#
url = "https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.816&dec=-42.192&limit=100&html"
response = requests.get(url)
print(response.text)

A simple Julia script

# Eventually first run `import Pkg; Pkg.add("HTTP")`
using HTTP
r = HTTP.get("https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.816&dec=-42.192&limit=100&json")
println(String(r.body))

A simple PHP script

1. Simplest ( requesting json)

echo file_get_contents("https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.816&dec=-42.192&limit=100&json");

2. Same request but using cURL functions

#!/usr/bin/env php
<?php
$ch = curl_init();
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
curl_setopt( $ch, CURLOPT_URL,
    'https://cats.oas.inaf.it/gaiadr3/radius=0.1&ra=253.816&dec=-42.192&limit=100&json'
);
$json = curl_exec( $ch );
echo $json;
curl_close( $ch );
?>

3. cURL programmatic, returning VOTable (default)

#!/usr/bin/env php
<?php
$url = 'https://cats.oas.inaf.it';
$cat = 'gaiadr3';

$qry = http_build_query(array(
   'radius' => '0.1',
   'ra'     => '253.816',
   'dec'    => '-42.192',
   'limit'  => '100'
));

$ch = curl_init();
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
curl_setopt( $ch, CURLOPT_URL, "$url/$cat/$qry" );
$vot = curl_exec( $ch );
echo $vot;
curl_close( $ch );
?>