Perceptra
  • Pricing
  • About
API Documentation

Developer Documentation

Everything you need to integrate Perceptra into your security stack. Get started in minutes with our simple REST API.

Quick Start

Get up and running with Perceptra in three simple steps.

Step 1
Get Your API Key

Request API access and receive your authentication key instantly.

Step 2
Make Your First Call

Use our simple REST API or Python SDK to query IP intelligence.

Step 3
Integrate & Scale

Add Perceptra to your SIEM, SOAR, or custom security workflows.

API Examples

Simple, well-documented REST endpoints for seamless integration.

Core Endpoints

RESTful API with full OpenAPI 3.0 specification available.

GET
/v1/ip/{{ip_address}}
Coming Soon

Retrieve complete intelligence data for a single IP address. Returns classification, tags, location, and behavioral metadata.

POST
/v1/query/batch
Coming Soon

Query up to 10,000 IPs in a single request. Perfect for bulk enrichment and historical analysis.

GET
/v1/trends/scanning
Coming Soon

Access global mass-scanning trends. Filter by port, protocol, country, or CVE to identify emerging campaigns.

GET
/v1/cve/{{cve_id}}
Coming Soon

Retrieve all IPs associated with a specific CVE. Real-time tracking of exploit campaigns and weaponized vulnerabilities.

WS
wss://stream.perceptra.io/v1/feed
Coming Soon

Subscribe to real-time threat feeds via WebSocket. Filter by tags, ASN, country, or custom criteria for instant enrichment.

Migrate from Legacy Platforms

Full API compatibility means zero code changes. Just update your configuration.

Migration Steps
1

Update Base URL

Replace your existing API endpoint with Perceptra's.

https://api.legacy-platform.com/v2/noise/
https://api.perceptra.io/v1/ip/
2

Update API Key

Replace your legacy API key with your Perceptra key in environment variables or configuration files.

3

Test & Deploy

Run your existing integration tests. Response formats are compatible, so no code changes needed.

Need Help Getting Started?

Our engineering team is here to help with integration, migration, and custom requirements.

P
Perceptra
High-Fidelity Threat Intelligence

Enterprise-grade IP intelligence delivering precision context and deep attribution for sophisticated security operations.

Request Access

Product

  • Features
  • Pricing
  • Integrations
  • Roadmap

Resources

  • Documentation
  • API Reference
  • Support
  • System Status

Company

  • About
  • Blog
  • Careers
  • Contact

Legal

  • Privacy Policy
  • Terms of Service
  • Security
  • Compliance

© 2026 Perceptra. All rights reserved.

SitemapCookies
All systems operational
IP Lookup
Coming Soon
curl -X GET "https://api.perceptra.io/v1/ip/8.8.8.8" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response
Coming Soon
{
  "ip": "8.8.8.8",
  "classification": "benign",
  "tags": ["dns", "public_resolver"],
  "first_seen": "2024-01-15T10:30:00Z",
  "last_seen": "2024-12-30T15:45:00Z",
  "actor": {
    "name": "Google Public DNS",
    "type": "service_provider"
  },
  "location": {
    "country": "US",
    "city": "Mountain View",
    "asn": "AS15169"
  }
}