GET
/categories

List Categories

Retrieve all available dork categories.

Request

bash
curl -X GET "https://dorklist.com/api/v1/categories" \
-H "Authorization: Bearer dk_your_api_key_here"

Parameters

This endpoint does not accept any parameters.

Response

Response Body

FieldTypeDescription
successbooleanWhether the request was successful
data.categoriesarrayArray of category objects

Category Object

FieldTypeDescription
idstring (UUID)Unique category identifier
namestringCategory display name
iconstringIcon name for the category
sort_ordernumberDisplay order position
created_atstring (ISO 8601)When the category was created

Example Response

json
{
"success": true,
"data": {
"categories": [
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"name": "Vulnerability Scanning",
"icon": "shield-alert",
"sort_order": 1,
"created_at": "2024-01-15T10:30:00.000Z"
},
{
"id": "550e8400-e29b-41d4-a716-446655440002",
"name": "Files & Exposures",
"icon": "file-warning",
"sort_order": 2,
"created_at": "2024-01-15T10:30:00.000Z"
},
{
"id": "550e8400-e29b-41d4-a716-446655440003",
"name": "Bug Bounty",
"icon": "bug",
"sort_order": 3,
"created_at": "2024-01-15T10:30:00.000Z"
},
{
"id": "550e8400-e29b-41d4-a716-446655440004",
"name": "OSINT",
"icon": "search",
"sort_order": 4,
"created_at": "2024-01-15T10:30:00.000Z"
},
{
"id": "550e8400-e29b-41d4-a716-446655440005",
"name": "Recruitment",
"icon": "users",
"sort_order": 5,
"created_at": "2024-01-15T10:30:00.000Z"
},
{
"id": "550e8400-e29b-41d4-a716-446655440006",
"name": "SEO",
"icon": "trending-up",
"sort_order": 6,
"created_at": "2024-01-15T10:30:00.000Z"
}
]
}
}

Common Use Cases

  • Building a category filter UI for dork selection
  • Fetching category IDs to filter dorks by category
  • Displaying category names alongside dork results