BinaryEdge API

Security / API Key Intermediate HTTPS CORS
Varies by plan (check documentation)

Overview

BinaryEdge is a cybersecurity platform that continuously scans the entire internet and exposes the results through its API. You can search for internet-connected hosts, open ports, services, and vulnerabilities using simple queries. Security researchers and developers use it to monitor exposed assets and discover threats.

💡

Beginner Tip

Use the /v2/query/search endpoint with simple field queries like "port:22 country:US" to get started quickly. Be aware that free-tier accounts have strict rate limits — cache results locally to avoid hitting them.

Available Data

BinaryEdge data via REST API
JSON-formatted response data
Requires API key authentication

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from BinaryEdge",
    "description": "Provide access to BinaryEdge 40fy scanning platform",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

total Total number of results matching the query.
query The original query string that was searched.
events Array of host/service objects matching the search criteria.
events[].ip IP address of the discovered host.
events[].port Open port number found on the host.
events[].timestamp ISO 8601 timestamp of when the scan result was recorded.

Implementation Example

const url = "https://docs.binaryedge.io/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

429 Too Many Requests You have exceeded your plan's request quota.
Check your remaining credits via /v2/user/subscription and upgrade your plan or add delays between requests.
400 Bad Request The query syntax is malformed or contains unsupported fields.
Review the BinaryEdge query language docs and test your query in the web UI first.
401 Unauthorized The X-Key header is missing or the API key is invalid.
Pass your API key in the X-Key header: -H "X-Key: YOUR_API_KEY".

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 10/20
🔒 Security 15/15
🛠 Developer XP 17/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS YES
Category Security
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →