{
  "openapi": "3.0.1",
  "info": {
    "title": "Private Company Search API - Find and Enrich Companies",
    "description": "Search and enrich private companies by keywords, industry, employee size, headquarters location, revenue, funding and ownership. Pay per result. Bring your own API key.",
    "version": "0.1",
    "x-build-id": "SHLBwAx0inOcadqfh"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nabeelbaghoor~private-company-search-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nabeelbaghoor-private-company-search-api",
        "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/nabeelbaghoor~private-company-search-api/runs": {
      "post": {
        "operationId": "runs-sync-nabeelbaghoor-private-company-search-api",
        "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/nabeelbaghoor~private-company-search-api/run-sync": {
      "post": {
        "operationId": "run-sync-nabeelbaghoor-private-company-search-api",
        "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": {
          "searchMode": {
            "title": "Mode",
            "enum": [
              "search",
              "enrich"
            ],
            "type": "string",
            "description": "Search discovers companies by criteria and pages through the matches. Enrich looks up specific companies you already know by domain or company id.",
            "default": "search"
          },
          "keywords": {
            "title": "Keywords",
            "type": "string",
            "description": "Comma-separated keywords describing what a company does, e.g. `industrial automation, robotics`. Companies matching any keyword are returned. Search mode only."
          },
          "keywordsExclude": {
            "title": "Exclude keywords",
            "type": "string",
            "description": "Comma-separated keywords to exclude. Companies matching any of these are filtered out. Search mode only."
          },
          "employeesMin": {
            "title": "Minimum employees",
            "minimum": 0,
            "type": "integer",
            "description": "Only companies with at least this many employees. Leave blank for no lower bound."
          },
          "employeesMax": {
            "title": "Maximum employees",
            "minimum": 0,
            "type": "integer",
            "description": "Only companies with at most this many employees. Leave blank for no upper bound."
          },
          "hqCountry": {
            "title": "HQ country",
            "type": "string",
            "description": "Restrict to a headquarters country, e.g. `United States`. Search mode only."
          },
          "hqState": {
            "title": "HQ state or region",
            "type": "string",
            "description": "Restrict to a headquarters state or region, e.g. `California`. Search mode only."
          },
          "hqCity": {
            "title": "HQ city",
            "type": "string",
            "description": "Restrict to a headquarters city, e.g. `Austin`. Search mode only."
          },
          "revenueMin": {
            "title": "Minimum revenue (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only companies with at least this estimated annual revenue in USD. Leave blank for no lower bound."
          },
          "revenueMax": {
            "title": "Maximum revenue (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only companies with at most this estimated annual revenue in USD. Leave blank for no upper bound."
          },
          "foundedMin": {
            "title": "Founded from (year)",
            "minimum": 1800,
            "type": "integer",
            "description": "Only companies founded in or after this year, e.g. `2010`. Leave blank for no lower bound."
          },
          "foundedMax": {
            "title": "Founded to (year)",
            "minimum": 1800,
            "type": "integer",
            "description": "Only companies founded in or before this year, e.g. `2024`. Leave blank for no upper bound."
          },
          "businessModels": {
            "title": "Business models",
            "type": "string",
            "description": "Comma-separated business model tags to match, e.g. `saas, hardware, marketplace`. Search mode only."
          },
          "ownership": {
            "title": "Ownership",
            "enum": [
              "any",
              "investor_backed",
              "bootstrapped",
              "public",
              "private_equity",
              "other"
            ],
            "type": "string",
            "description": "Filter by ownership structure. Search mode only.",
            "default": "any"
          },
          "endCustomer": {
            "title": "End customer",
            "enum": [
              "any",
              "b2b",
              "b2c",
              "both"
            ],
            "type": "string",
            "description": "Filter by who the company sells to. Search mode only.",
            "default": "any"
          },
          "rawFilters": {
            "title": "Advanced raw filters",
            "type": "object",
            "description": "Advanced escape hatch. A JSON object merged verbatim over the built request body (raw values win), sent straight to the search endpoint. Use this to pass provider filters not surfaced as fields above. See the README for details. Search mode only."
          },
          "domain": {
            "title": "Domains to enrich",
            "type": "string",
            "description": "Comma-separated website domains to enrich, e.g. `acme.com, example.io`. One record is returned per resolved company. Enrich mode only."
          },
          "companyUid": {
            "title": "Company id",
            "type": "string",
            "description": "A single provider company id (uid) to enrich. Optional alternative to a domain. Enrich mode only."
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Stop after this many records (1-5,000). Search pages automatically until this cap or the results run out. You are charged per result returned."
          },
          "apiKey": {
            "title": "API key",
            "type": "string",
            "description": "Your company data provider API key. Required. Provisioned by the provider (enterprise access). Stored securely and never logged."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}