API Documentation

The darknetworld.com API allows market administrators to programmatically submit mirror URLs for their sites. This ensures that our listings remain current and accurate, providing users with reliable access points.

To use the API, you must first obtain an API token by contacting our administrator. The API uses Bearer token authentication and requires all requests to be sent as JSON.

All API requests must include an authorization header with your unique API token:

Obtaining an API Token

To get your API token:

1. Contact the darknetworld.com admin via Jabber (OMEMO):
2. Provide your site details and official URL for verification
3. Upon verification, you'll receive your unique API token

Request Body

The request body must be a JSON object with a mirrors field. You can submit mirror URLs in either of two formats:

Example with JSON Array:

{
  "mirrors": [
    "http://mirror1.example.onion",
    "http://mirror2.example.onion"
  ]
}

Example with Comma-Separated String:

{
  "mirrors": "http://mirror1.example.onion, http://mirror2.example.onion"
}

Successful requests will receive a 200 OK response with a JSON object containing:

{
  "message": "Mirrors added successfully",
  "mirrors": [
    "http://existingmirror.onion",
    "http://mirror1.example.onion",
    "http://mirror2.example.onion"
  ]
}

For API token requests, questions, or support, contact the darknetworld.com administrator:

Please include detailed information about your site and use case when requesting an API token.