{
  "openapi": "3.0.1",
  "info": {
    "title": "DIFC Public Register Scraper - Dubai Companies & Directors",
    "description": "Export companies from the DIFC (Dubai International Financial Centre) Public Register: name, registration number, status, legal structure, activities, address, licence validity, directors, shareholders, secretaries, auditors, share capital. Search, whole register, newest, monitor.",
    "version": "0.1",
    "x-build-id": "CHnsWFY0wSoSQ0xsi"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~difc-public-register-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-difc-public-register-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/scrapersdelight~difc-public-register-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-difc-public-register-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/scrapersdelight~difc-public-register-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-difc-public-register-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "register",
              "newest"
            ],
            "type": "string",
            "description": "Search = the names, numbers or links in Search terms. Whole register = every company matching the filters below (about 14,600 with no filters). Newest = highest registration numbers first.",
            "default": "register"
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Used in Search mode. Each line is a company name or part of one (e.g. \"bank\"), a registration number (e.g. \"2403\"), or a difc.com company link. Names match anywhere in the registered name.",
            "items": {
              "type": "string"
            }
          },
          "statuses": {
            "title": "Status",
            "type": "array",
            "description": "Only companies with these register statuses (e.g. Active). Empty = every status.",
            "items": {
              "type": "string",
              "enum": [
                "Active",
                "Dissolved",
                "Inactive - Struck Off",
                "Voluntary Struck Off",
                "De-registered",
                "Not Renewed",
                "Dissolved - Voluntary Strike off",
                "Pending Voluntary Strike off",
                "Pending Strike Off",
                "Pending Dissolution",
                "Struck Off (Continued)",
                "Dissolved (merger)",
                "Inactive - DFSA Lic. Wdn",
                "Pending De-registration",
                "Inactive - Suspended",
                "Suspended by DFSA",
                "Under Provisional Liquidation"
              ]
            },
            "default": []
          },
          "licenceType": {
            "title": "Licence type",
            "enum": [
              "any",
              "Regulated",
              "NonRegulated"
            ],
            "type": "string",
            "description": "The register's own Type filter: Regulated (DFSA-regulated financial firms) or Non Regulated. Any = both.",
            "default": "any"
          },
          "legalStructures": {
            "title": "Legal structure",
            "type": "array",
            "description": "Only these legal structures (e.g. FRC = Recognised Company, a branch of a foreign company). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "LTD",
                "LTD IC",
                "LTD PCC",
                "LTD SPC",
                "LTD Supra National",
                "Public Company",
                "FRC",
                "Foundation",
                "LLC",
                "LLP",
                "RLLP",
                "LP",
                "RLP",
                "GP",
                "RP",
                "NPIO"
              ],
              "enumTitles": [
                "LTD (Private Company)",
                "LTD IC (Private Company)",
                "LTD PCC (Private Company)",
                "LTD SPC (Special Purpose Company)",
                "LTD Supra National (Supra National Entity)",
                "Public Company",
                "FRC (Recognised Company)",
                "Foundation",
                "LLC (Limited Liability Company)",
                "LLP (Limited Liability Partnership)",
                "RLLP (Recognized Limited Liability Partnership)",
                "LP (Limited Partnership)",
                "RLP (Recognized Limited Partnership)",
                "GP (General Partnership)",
                "RP (Recognized Partnership)",
                "NPIO (Non Profit Incorporated Organisation)"
              ]
            },
            "default": []
          },
          "sectors": {
            "title": "Sector",
            "type": "array",
            "description": "Only these register sectors. Empty = all three.",
            "items": {
              "type": "string",
              "enum": [
                "Financial - related",
                "Non - financial",
                "Retail"
              ],
              "enumTitles": [
                "Financial - related",
                "Non - financial",
                "Retail"
              ]
            },
            "default": []
          },
          "incorporatedFrom": {
            "title": "Registered on or after",
            "type": "string",
            "description": "Only companies registered on or after this date: YYYY-MM-DD or a period such as \"30 days\". Empty = no lower bound."
          },
          "incorporatedTo": {
            "title": "Registered on or before",
            "type": "string",
            "description": "Only companies registered on or before this date: YYYY-MM-DD or a period such as \"1 year\". Empty = no upper bound."
          },
          "activityKeywords": {
            "title": "Activity keywords",
            "type": "array",
            "description": "Keep a company only if its licensed activities, nature of business or name contain one of these words (e.g. \"holding\", \"advising\"). Empty = no keyword filter.",
            "items": {
              "type": "string"
            }
          },
          "includeDetails": {
            "title": "Include directors, shareholders & full entry",
            "type": "boolean",
            "description": "Adds directors, shareholders, secretaries, auditors, partners or members, share capital, trading and former names, licence validity, financial year end and website. One extra call per company.",
            "default": true
          },
          "monitorMode": {
            "title": "Monitor mode",
            "enum": [
              "off",
              "new",
              "changes"
            ],
            "type": "string",
            "description": "New = only companies no earlier run delivered (new registrations). Changes = new companies plus companies whose status, name, address, activities, legal form or sector changed.",
            "default": "off"
          },
          "monitorStoreName": {
            "title": "Monitor memory name",
            "type": "string",
            "description": "Name of the storage that remembers delivered companies. Use a different name for each separate schedule. Empty = the default store."
          },
          "skipExistingOnFirstRun": {
            "title": "First run: record only",
            "type": "boolean",
            "description": "With a monitor on: the first run records the companies in scope without delivering or charging them, so later runs deliver only what is new or changed.",
            "default": false
          },
          "resetMonitor": {
            "title": "Reset monitor memory",
            "type": "boolean",
            "description": "Forget what earlier runs delivered for this scope and start again.",
            "default": false
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Any HTTPS endpoint that accepts a JSON POST: receives the run's delivered companies (up to 100) when the run delivers at least one."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "A Slack incoming-webhook URL: posts a short list of the delivered companies when the run delivers at least one."
          },
          "teamsWebhookUrl": {
            "title": "Microsoft Teams webhook URL",
            "type": "string",
            "description": "A Teams Workflows webhook URL (\"When a Teams webhook request is received\"): posts an Adaptive Card listing the delivered companies."
          },
          "maxResults": {
            "title": "Max companies",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Stop after this many companies are delivered. 0 = no limit (the whole register is about 14,600 companies).",
            "default": 100
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Core fields only (current officers, no history arrays or data-protection block): smaller rows for spreadsheets and AI/MCP pipelines.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 12,
            "type": "integer",
            "description": "Register calls in flight at once (1-12). The default 6 reads about 3 companies a second with details.",
            "default": 6
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Requests go out directly first. This proxy (default: residential, UAE) is used only if the register refuses a direct request, with a small per-run spending cap.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "AE"
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}