{
  "openapi": "3.0.1",
  "info": {
    "title": "Username Checker & Search — OSINT Across 3000+ Sites (Maigret)",
    "description": "Username search across 3000+ social, forum, gaming, dating and developer sites, with a profile URL per hit. Open-source Maigret engine (MIT), rated 5.0★. Free plan: top 100 sites. Paid plans: all 3000+ and cheaper per profile (Bronze 20%, Silver 35%, Gold+ 48% off). JSON/CSV/Excel, API.",
    "version": "1.0",
    "x-build-id": "davghNgMWyiqVThPA"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ntriqpro~maigret-actor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ntriqpro-maigret-actor",
        "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/ntriqpro~maigret-actor/runs": {
      "post": {
        "operationId": "runs-sync-ntriqpro-maigret-actor",
        "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/ntriqpro~maigret-actor/run-sync": {
      "post": {
        "operationId": "run-sync-ntriqpro-maigret-actor",
        "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": {
          "usernames": {
            "title": "Usernames",
            "type": "array",
            "description": "One or more usernames to search across social networks and websites. Add a whole investigation list here — each username is searched in turn and all results land in the same dataset. Free plan: each run searches the top 100 sites and returns up to 25 results (the first 3 inputs). Paid Apify plans search up to all 3000+ sites and receive the full result set. Pricing: when the run's price list includes the per-username search fee (username-checked), each username whose search completes is charged once, even if no profile is found; a search that fails on our side is not charged. The run's status message states the maximum search fee before the first search.",
            "items": {
              "type": "string"
            }
          },
          "username": {
            "title": "Single username (legacy)",
            "type": "string",
            "description": "A single username to search. Kept for backwards compatibility — prefer the Usernames field above, which accepts a list."
          },
          "maxUsernames": {
            "title": "Max usernames per run",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Safety cap on how many usernames a single run will search. Extra usernames beyond this limit are skipped. Runtime scales with the number of usernames you actually supply (roughly 2 minutes each at the default 500 sites), so keep your run timeout in mind for large batches. Default: 100. Free plan: each run returns up to 25 results (the first 3 inputs). Paid Apify plans receive the full result set."
          },
          "topSites": {
            "title": "Top N sites to check",
            "minimum": 0,
            "maximum": 3000,
            "type": "integer",
            "description": "Limit search to top N sites by Alexa rank. Set 0 to search all 3000+ sites (slow). Default: 500. Free plan: at most the top 100 sites are searched. A value from 1 to 100 is used as is; 0 or any value above 100 is lowered to 100. Paid Apify plans search the depth you set here, up to all 3000+ sites."
          },
          "timeout": {
            "title": "Request timeout (seconds)",
            "minimum": 5,
            "maximum": 120,
            "type": "integer",
            "description": "Time in seconds to wait for each site response. Default: 30."
          },
          "tags": {
            "title": "Filter by tags (include)",
            "type": "string",
            "description": "Comma-separated list of site tags to include (e.g. 'social,coding,video'). Leave empty to check all."
          },
          "excludeTags": {
            "title": "Filter by tags (exclude)",
            "type": "string",
            "description": "Comma-separated list of site tags to exclude."
          },
          "sites": {
            "title": "Specific sites to check",
            "type": "string",
            "description": "Comma-separated list of specific site names to check (e.g. 'GitHub,Twitter,Instagram'). Leave empty to use topSites. Free plan: at most 100 of the named sites are searched per username."
          },
          "noRecursion": {
            "title": "Disable recursive search",
            "type": "boolean",
            "description": "Disable recursive search for additional usernames/IDs found during the search. Faster but less thorough."
          },
          "extractProfileFields": {
            "title": "Extract profile details (opt-in)",
            "type": "boolean",
            "description": "Off by default. When off, results contain account-existence evidence only (site name, profile URL, status). Turn on to also save personal profile details found on the page — full name, bio, avatar image, location and other extracted identifiers. Free plan: each kind of detail is shown once (the first profile that has it) and the rest are counted in the closing notice; paid plans get the details on every profile. No extra charge either way. You become the data controller for any personal data you collect this way, so only enable it when you have a lawful basis (GDPR/CCPA/PIPA).",
            "default": false
          },
          "printNotFound": {
            "title": "Include 'not found' results",
            "type": "boolean",
            "description": "Also save sites where the username was NOT found in the dataset."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}