API DOCUMENTATION

DEVELOPER REFERENCE • REST API • INTEGRATION GUIDE

Complete API reference for integrating with Quinas Network Intelligence platform

QUICK START

1. Get API Key

Manage API Keys →

2. Make Your First Request

# Get system statistics

curl https://api.quinas.cloud/api/stats \\

-H "Authorization: Bearer YOUR_API_KEY"

AUTHENTICATION

All API requests require authentication using your API key. You can obtain an API key from your account settings.

Bearer Token

Use API key as Bearer token in Authorization header

Authorization: Bearer YOUR_API_KEY

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.quinas.cloud/api/stats

X-API-Key Header

Pass API key directly in X-API-Key header

X-API-Key: YOUR_API_KEY

curl -H "X-API-Key: YOUR_API_KEY" https://api.quinas.cloud/api/stats

API ENDPOINTS

POST/api/search

Search Hosts

Search for network hosts by IP, domain, or service criteria

Parameters

Name	Type	Required	Description
query	string	Yes	Search query (IP, domain, service)
filters	object	No	Optional filters
limit	number	No	Results limit (default: 20)
offset	number	No	Results offset (default: 0)

Example

curl -X POST https://api.quinas.cloud/api/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "query": "apache",
    "filters": {"country_code": "PT"},
    "limit": 50
  }'

GET/api/host/{ip}

Host Details

Get detailed information about a specific IP address

Parameters

Name	Type	Required	Description
ip	string	Yes	IP address to query

Example

curl https://api.quinas.cloud/api/host/193.136.128.1 \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/asn/{asn}

ASN Details

Get detailed information about an Autonomous System Number

Parameters

Name	Type	Required	Description
asn	string	Yes	ASN number to query

Example

curl https://api.quinas.cloud/api/asn/AS1930 \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/analytics/overview

Analytics Overview

Get comprehensive analytics overview including total hosts, scans, and trends

Example

curl https://api.quinas.cloud/api/analytics/overview \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/analytics/countries

Country Analytics

Get analytics data grouped by country

Example

curl https://api.quinas.cloud/api/analytics/countries \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/analytics/services

Service Analytics

Get analytics data grouped by network services

Example

curl https://api.quinas.cloud/api/analytics/services \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/analytics/asns

ASN Analytics

Get analytics data grouped by Autonomous System Numbers

Example

curl https://api.quinas.cloud/api/analytics/asns \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/stats

System Statistics

Get current system statistics and health metrics

Example

curl https://api.quinas.cloud/api/stats \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/api/export

Export Data

Export search results or analytics data in various formats

Parameters

Name	Type	Required	Description
type	string	Yes	Export type (search, analytics)
format	string	Yes	Format (csv, json, xml)
query	object	No	Search query for search exports

Example

curl -X POST https://api.quinas.cloud/api/export \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "search",
    "format": "csv",
    "query": {"service": "apache"}
  }'