List Dorks

Retrieve dorks with pagination, filtering by category, and search functionality.

Request

bash

# Basic request
curl -X GET "https://dorklist.com/api/v1/dorks" \
  -H "Authorization: Bearer dk_your_api_key_here"
# With parameters
curl -X GET "https://dorklist.com/api/v1/dorks?page=1&limit=20&category_id=550e8400-e29b-41d4-a716-446655440001&search=sql" \
  -H "Authorization: Bearer dk_your_api_key_here"

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for pagination
limit	integer	20	Number of results per page (max: 100)
category_id	string (UUID)	—	Filter by category ID
search	string	—	Search in title, description, and query

Response

Response Body

Field	Type	Description
success	boolean	Whether the request was successful
data.dorks	array	Array of dork objects
pagination.page	integer	Current page number
pagination.limit	integer	Results per page
pagination.total	integer	Total number of results
pagination.hasMore	boolean	Whether more pages exist

Dork Object

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
category_id	string (UUID)	Category this dork belongs to
category	object	Nested category object (name, icon)
is_pro	boolean	Whether this is a Pro-exclusive dork
slug	string	URL-friendly identifier
created_at	string (ISO 8601)	When the dork was created

Example Response

json

{
  "success": true,
  "data": {
    "dorks": [
      {
        "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",
        "category_id": "550e8400-e29b-41d4-a716-446655440001",
        "category": {
          "name": "Vulnerability Scanning",
          "icon": "shield-alert"
        },
        "is_pro": false,
        "slug": "sql-error-messages",
        "created_at": "2024-01-20T14:30:00.000Z"
      },
      {
        "id": "660e8400-e29b-41d4-a716-446655440002",
        "title": "Exposed Config Files",
        "query": "site:example.com ext:env | ext:config | ext:ini",
        "description": "Search for exposed configuration files",
        "category_id": "550e8400-e29b-41d4-a716-446655440002",
        "category": {
          "name": "Files & Exposures",
          "icon": "file-warning"
        },
        "is_pro": false,
        "slug": "exposed-config-files",
        "created_at": "2024-01-20T14:35:00.000Z"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "hasMore": true
  }
}

Examples

Filter by Category

bash

curl -X GET "https://dorklist.com/api/v1/dorks?category_id=550e8400-e29b-41d4-a716-446655440003" \
  -H "Authorization: Bearer dk_your_api_key_here"

Search Dorks

bash

curl -X GET "https://dorklist.com/api/v1/dorks?search=password+file" \
  -H "Authorization: Bearer dk_your_api_key_here"

Paginate Results

bash

# Get page 2 with 50 results per page
curl -X GET "https://dorklist.com/api/v1/dorks?page=2&limit=50" \
  -H "Authorization: Bearer dk_your_api_key_here"

List Dorks

Request

Query Parameters

Response

Response Body

Dork Object

Example Response

Examples

Filter by Category

Search Dorks

Paginate Results

Next Steps

Get Dork Details →

Saved Dorks →