{
  "openapi": "3.0.1",
  "info": {
    "title": "Public Profile Research Tool — Spokeo Alternative",
    "description": "Research public profile references from a name, organization, and optional location. Export source URLs, titles, snippets, relevance cues, and timestamps for authorized, human-reviewed research.",
    "version": "0.2",
    "x-build-id": "VzcRgrrQh8NH8kNRk"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~spokeo-alternative/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-spokeo-alternative",
        "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/khadinakbar~spokeo-alternative/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-spokeo-alternative",
        "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/khadinakbar~spokeo-alternative/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-spokeo-alternative",
        "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",
        "required": [
          "authorizedUseConfirmed",
          "searches"
        ],
        "properties": {
          "authorizedUseConfirmed": {
            "title": "Authorized public-source use confirmed",
            "type": "boolean",
            "description": "Set true only when you are looking up yourself, a consented subject, or conducting lawful public-interest research. The default is false and the Actor will reject the run unless it is true. Do not use the result for employment, housing, credit, insurance, eligibility, law-enforcement, or other regulated decisions.",
            "default": false
          },
          "searches": {
            "title": "Broad name searches",
            "minItems": 1,
            "maxItems": 5,
            "type": "array",
            "description": "Provide one to five broad name searches, for example {\"fullName\":\"Linus Torvalds\",\"organization\":\"Linux\",\"location\":\"Finland\"}. fullName is required; organization and location are optional disambiguation hints and must be broad, not a street address, phone number, email address, profile URL, postal code, or birth date. The Actor turns each request into public source-site queries and does not query a people-data broker.",
            "items": {
              "type": "object",
              "properties": {
                "fullName": {
                  "title": "Full name",
                  "type": "string",
                  "description": "A broad person name to use in a public-source search, for example Linus Torvalds. Required; names containing email addresses, phone numbers, URLs, postal codes, or birth dates are rejected. This name is used only for the current bounded run and is not repeated in key-value output beyond the source-linked evidence rows."
                },
                "organization": {
                  "title": "Organization hint",
                  "type": "string",
                  "description": "Optional broad employer, project, school, or organization hint, for example Linux. It helps narrow public source results but is not verified as current employment or affiliation. Leave blank when an organization is unknown rather than entering an address or account identifier."
                },
                "location": {
                  "title": "Broad location hint",
                  "type": "string",
                  "description": "Optional broad city, region, or country hint, for example Finland. It helps disambiguate public result pages but must not be a street address, postal code, phone number, email address, or URL. Leave blank when a broad location is not needed."
                }
              },
              "required": [
                "fullName"
              ]
            }
          },
          "profileSources": {
            "title": "Public source sites",
            "minItems": 1,
            "maxItems": 7,
            "type": "array",
            "description": "Choose the public source-site families to query: LinkedIn, GitHub, X, Instagram, Facebook, YouTube, or Wikipedia. GitHub and Wikipedia use source-native APIs, while social sources use owner-managed public-search providers with a public-page recovery route. Results are reviewable evidence rather than a claim that a person controls an account; choose fewer sites to reduce queries and event-charged rows.",
            "items": {
              "type": "string",
              "enum": [
                "linkedin",
                "github",
                "x",
                "instagram",
                "facebook",
                "youtube",
                "wikipedia"
              ]
            },
            "default": [
              "linkedin",
              "github",
              "x",
              "wikipedia"
            ]
          },
          "maxResultsPerSearch": {
            "title": "Maximum evidence records per name",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Caps accepted source-linked evidence rows for each name search. Defaults to 3 and accepts 1 to 5, so a maximum of 25 billable result rows can be persisted in one run. A row is charged only after its source URL and required output fields validate; Apify platform usage is additional.",
            "default": 3
          },
          "networkMode": {
            "title": "Public-page recovery network route",
            "enum": [
              "auto",
              "direct",
              "residential"
            ],
            "type": "string",
            "description": "Controls the source-native and final public-page recovery route, not the owner-managed provider APIs. Choose auto for direct retrieval followed by Apify Residential when needed, direct to avoid Residential usage, or residential to start public-page recovery through Residential. Defaults to auto; Residential usage is separate Apify platform usage and provider credentials never appear in Actor input.",
            "default": "auto"
          },
          "retrievalStrategy": {
            "title": "Managed retrieval strategy",
            "enum": [
              "automatic",
              "public-only",
              "scrapecreators-first",
              "harvestapi-first",
              "sociavault-first"
            ],
            "type": "string",
            "description": "Controls the owner-managed search-provider order for LinkedIn, X, Instagram, Facebook, and YouTube. Automatic uses the cost-ranked ScrapeCreators, LinkedIn-only HarvestAPI, SociaVault chain. Choose a provider-first option for deterministic routing with compatible fallbacks, or public-only to use DuckDuckGo Lite for social sources. GitHub and Wikipedia keep their source-native routes. Defaults to automatic; provider credentials remain owner-managed.",
            "default": "automatic"
          },
          "countryCode": {
            "title": "Search and fallback country",
            "pattern": "^[A-Za-z]{2}$",
            "type": "string",
            "description": "Two-letter country code used for public search localization and any Residential recovery route, for example US. Defaults to US and accepts ISO-style two-letter codes. It guides result localization but does not assert that a person is located in that country.",
            "default": "US"
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}