Get Dork Details

Retrieve detailed information about a specific dork, including usage instructions and warnings.

Request

bash

curl -X GET "https://dorklist.com/api/v1/dork?id=660e8400-e29b-41d4-a716-446655440001" \
  -H "Authorization: Bearer dk_your_api_key_here"

Query Parameters

Parameter	Type	Required	Description
id	string (UUID)	Required	The unique identifier of the dork

Response

Dork Detail Object

The response includes all fields from the basic dork object plus additional details:

Field	Type	Description
id	string (UUID)	Unique dork identifier
title	string	Dork display title
query	string	The Google dork query
description	string	What the dork does
what_it_does	string \| null	Detailed explanation of the dork's function
use_cases	string[] \| null	Array of example use cases
how_to_steps	string[] \| null	Step-by-step usage instructions
custom_warning	string \| null	Any specific warnings for this dork
category	object	Full category object
is_pro	boolean	Whether this is a Pro-exclusive dork
slug	string	URL-friendly identifier

Example Response

json

{
  "success": true,
  "data": {
    "dork": {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "title": "SQL Error Messages",
      "query": "site:example.com intext:\"sql syntax\" | intext:\"mysql_fetch\"",
      "description": "Find pages exposing SQL error messages that may reveal database information",
      "what_it_does": "This dork searches for pages that contain SQL error messages, which often appear when database queries fail. These errors can reveal information about the database structure, table names, and potentially sensitive data.",
      "use_cases": [
        "Identifying potential SQL injection vulnerabilities",
        "Finding misconfigured database connections",
        "Discovering exposed debug information",
        "Security auditing of web applications"
      ],
      "how_to_steps": [
        "Replace 'example.com' with your target domain",
        "Run the search in Google",
        "Review results for exposed error messages",
        "Document findings and report to site owner"
      ],
      "custom_warning": "Only use this dork on domains you have permission to test. Unauthorized scanning may be illegal.",
      "category": {
        "id": "550e8400-e29b-41d4-a716-446655440001",
        "name": "Vulnerability Scanning",
        "icon": "shield-alert"
      },
      "is_pro": false,
      "slug": "sql-error-messages",
      "created_at": "2024-01-20T14:30:00.000Z"
    }
  }
}

Error Responses

Missing ID Parameter

json

{
  "success": false,
  "error": {
    "code": "MISSING_PARAMETER",
    "message": "Dork ID is required"
  }
}

Dork Not Found

json

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Dork not found"
  }
}

Get Dork Details

Request

Query Parameters

Response

Dork Detail Object

Example Response

Error Responses

Missing ID Parameter

Dork Not Found

Next Steps

Saved Dorks →

Error Codes →