مستندات API

کلید ‌API را از کجا پیدا کنم؟

می‌توانید کلیدهای API خود را در داشبورد کاربری ایجاد و مدیریت کنید. برای ساخت یک کلید جدید، به مسیر داشبورد > دسترسی API بروید. این کلید را محرمانه نگه دارید؛ در صورت افشا شدن، فوراً آن را بازسازی کنید یا یک کلید جدید ایجاد کنید.

GET

Query Threat Intelligence

Retrieve detailed intelligence data for a specific indicator of compromise (IOC).

Request URL
https://threathunt.irancti.ir/api/{entity}/{value}

Path Parameters

Parameter Type Description
entity string The type of IOC. Allowed values: ip-address, domain, url, hash.
value string The actual value of the IOC (e.g., 1.1.1.1 or example.com).

Headers

{
  "api-key": "Q0DOOy9mdo00n7-Jkg02ifCTtZeh46sukH4"
}

Example Response

200 OK
{
    "data": [
        {
            "id": 1,
            "created": "2026-06-01T07:35:46.820Z",
            "modified": "2026-06-01T07:35:46.820Z",
            "published": "2026-06-01T07:35:46.812Z",
            "first_seen": "2026-06-01T07:35:46.812Z",
            "last_seen": "2026-06-01T07:35:46.812Z",
            "value": "1.1.1.1",
            "total_sightings": 156,
            "abusedb_score": 8,
            "abusedb_total_reports": null,
            "abusedb_number_distinct_user": null,
            "abusedb_last_reported": null
        }
    ],
    "count": 1
}

Response Fields

  • data: Array of threat objects matching the query.
  • count: Integer representing the number of records returned.