{
  "openapi": "3.0.1",
  "info": {
    "title": "B2B Company Search API - Firmographics, Revenue, Employees",
    "description": "Search a B2B company database by name, website, industry code, revenue, employee count, location, funding and employee growth, and export company records to a dataset. Pay per result. Bring your own API key.",
    "version": "0.1",
    "x-build-id": "GV4lZXdrGbNRiynV2"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nabeelbaghoor~b2b-company-search-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nabeelbaghoor-b2b-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~b2b-company-search-api/runs": {
      "post": {
        "operationId": "runs-sync-nabeelbaghoor-b2b-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~b2b-company-search-api/run-sync": {
      "post": {
        "operationId": "run-sync-nabeelbaghoor-b2b-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": {
          "companyName": {
            "title": "Company name",
            "type": "string",
            "description": "Company name to match, e.g. `Acme Robotics`."
          },
          "companyWebsite": {
            "title": "Company website",
            "type": "string",
            "description": "Company website in `http://www.example.com` format. Accepts a comma-separated list of websites."
          },
          "companyDescription": {
            "title": "Company description keywords",
            "type": "string",
            "description": "Space-separated words matched against the company description, e.g. `warehouse automation robotics`."
          },
          "industryCodes": {
            "title": "Industry",
            "type": "string",
            "description": "Top-level industry tags to match. Accepts a comma-separated list, e.g. `Software, Manufacturing`."
          },
          "industryKeywords": {
            "title": "Industry keywords",
            "type": "string",
            "description": "Industry keywords associated with a company. Supports the `AND` and `OR` operators, e.g. `software AND logistics`."
          },
          "sicCodes": {
            "title": "SIC codes",
            "type": "string",
            "description": "Four-digit SIC industry codes. Accepts a comma-separated list, e.g. `3661, 7372`."
          },
          "naicsCodes": {
            "title": "NAICS codes",
            "type": "string",
            "description": "Four-digit NAICS industry codes. Accepts a comma-separated list, e.g. `5182, 3345`."
          },
          "primaryIndustriesOnly": {
            "title": "Primary industry only",
            "type": "boolean",
            "description": "When enabled, only return companies whose primary industry matches the industry filter, rather than any of their industries.",
            "default": false
          },
          "revenue": {
            "title": "Revenue bands",
            "type": "string",
            "description": "Annual revenue bands to match. Accepts a comma-separated list of band values. Use the minimum and maximum below for an exact range instead."
          },
          "revenueMin": {
            "title": "Minimum revenue (thousands USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum annual revenue, expressed in thousands of US dollars, e.g. `1000` for 1 million USD."
          },
          "revenueMax": {
            "title": "Maximum revenue (thousands USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum annual revenue, expressed in thousands of US dollars, e.g. `500000` for 500 million USD."
          },
          "employeeCount": {
            "title": "Employee bands",
            "type": "string",
            "description": "Employee-count bands to match. Accepts a comma-separated list of band values. Use the minimum and maximum below for a granular range instead."
          },
          "employeeRangeMin": {
            "title": "Minimum employees",
            "type": "string",
            "description": "Minimum employee count, e.g. `50`. Use together with the maximum to set a range."
          },
          "employeeRangeMax": {
            "title": "Maximum employees",
            "type": "string",
            "description": "Maximum employee count, e.g. `1000`. Use together with the minimum to set a range."
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Country of the company's primary address, e.g. `United States`."
          },
          "state": {
            "title": "State or province",
            "type": "string",
            "description": "State or province of the company's address, e.g. `California`."
          },
          "zipCode": {
            "title": "ZIP or postal code",
            "type": "string",
            "description": "ZIP or postal code of the company's address, e.g. `94105`."
          },
          "zipCodeRadiusMiles": {
            "title": "ZIP code radius (miles)",
            "minimum": 0,
            "type": "integer",
            "description": "Used together with the ZIP code above: return companies within this many miles of it."
          },
          "metroRegion": {
            "title": "Metro area",
            "type": "string",
            "description": "US and Canada metro areas to match. Accepts a comma-separated list."
          },
          "continent": {
            "title": "Continent",
            "type": "string",
            "description": "Continent of the company's primary address, e.g. `Europe`."
          },
          "excludedRegions": {
            "title": "Excluded regions",
            "type": "string",
            "description": "US and Canada states and metro areas to exclude. Accepts a comma-separated list."
          },
          "locationSearchType": {
            "title": "Location match type",
            "enum": [
              "HQ",
              "Person",
              "PersonOrHQ",
              "PersonAndHQ",
              "PersonThenHQ"
            ],
            "type": "string",
            "description": "How the location filters are applied: against the headquarters, against any employee location, or a combination."
          },
          "companyType": {
            "title": "Company type",
            "type": "string",
            "description": "Company types to match, e.g. `private, public`. Accepts a comma-separated list."
          },
          "businessModel": {
            "title": "Business model",
            "type": "array",
            "description": "Restrict to companies with these business models. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "B2B",
                "B2C",
                "B2G"
              ]
            },
            "default": []
          },
          "companyRanking": {
            "title": "Company ranking",
            "type": "string",
            "description": "Ranking list IDs to match, for example a Fortune 500 list ID. Accepts a comma-separated list."
          },
          "fundingAmountMin": {
            "title": "Minimum funding (thousands USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum total funding, expressed in thousands of US dollars, e.g. `1000` for 1 million USD."
          },
          "fundingAmountMax": {
            "title": "Maximum funding (thousands USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum total funding, expressed in thousands of US dollars."
          },
          "fundingStartDate": {
            "title": "Funding from (date)",
            "type": "string",
            "description": "Only companies funded on or after this date, in `YYYY-MM-DD` format."
          },
          "fundingEndDate": {
            "title": "Funding to (date)",
            "type": "string",
            "description": "Only companies funded on or before this date, in `YYYY-MM-DD` format."
          },
          "oneYearEmployeeGrowthRateMin": {
            "title": "Minimum 1-year employee growth",
            "type": "string",
            "description": "Minimum one-year employee growth rate, as a percentage, e.g. `20`."
          },
          "oneYearEmployeeGrowthRateMax": {
            "title": "Maximum 1-year employee growth",
            "type": "string",
            "description": "Maximum one-year employee growth rate, as a percentage."
          },
          "twoYearEmployeeGrowthRateMin": {
            "title": "Minimum 2-year employee growth",
            "type": "string",
            "description": "Minimum two-year employee growth rate, as a percentage."
          },
          "twoYearEmployeeGrowthRateMax": {
            "title": "Maximum 2-year employee growth",
            "type": "string",
            "description": "Maximum two-year employee growth rate, as a percentage."
          },
          "techAttributeTagList": {
            "title": "Technologies used",
            "type": "string",
            "description": "Technology product tag IDs the company must use. Accepts a comma-separated list."
          },
          "excludeTechAttributeTagList": {
            "title": "Technologies to exclude",
            "type": "string",
            "description": "Technology product tag IDs to exclude. Accepts a comma-separated list."
          },
          "excludeDefunctCompanies": {
            "title": "Exclude defunct companies",
            "type": "boolean",
            "description": "When enabled, companies flagged as defunct are removed from the results.",
            "default": false
          },
          "companyId": {
            "title": "Company ID",
            "type": "string",
            "description": "Look up one or more companies directly by their provider company ID."
          },
          "parentId": {
            "title": "Parent company ID",
            "type": "string",
            "description": "Return companies whose parent is this company ID."
          },
          "ultimateParentId": {
            "title": "Ultimate parent company ID",
            "type": "string",
            "description": "Return companies whose ultimate parent is this company ID."
          },
          "sort": {
            "title": "Sort by",
            "enum": [
              "-revenue",
              "revenue",
              "-employeeCount",
              "employeeCount",
              "name",
              "-name"
            ],
            "type": "string",
            "description": "Sort order for the result set. The default is revenue, highest first."
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Stop after this many company records (1-5,000). Paged automatically at 100 per page. You are charged per result returned."
          },
          "rawAttributes": {
            "title": "Advanced raw criteria",
            "type": "object",
            "description": "Power users: a JSON object of raw search criteria merged over the fields above, verbatim. Use this for criteria not exposed as fields, e.g. `{ \"itDepartmentBudgetMin\": 500, \"companyTicker\": [\"ACME\"], \"subUnitTypes\": \"subsidiary\" }`."
          },
          "clientId": {
            "title": "Client ID",
            "type": "string",
            "description": "Your OAuth2 client ID, generated in the data provider's admin portal. Required. Used with the Client secret below to obtain a short-lived access token."
          },
          "apiKey": {
            "title": "Client secret",
            "type": "string",
            "description": "Your OAuth2 client secret. Required. Stored securely and never logged."
          },
          "scope": {
            "title": "OAuth scopes",
            "type": "string",
            "description": "Optional. A space-delimited list of scopes to request, which must be a subset of those configured for your application. Leave blank to receive all configured scopes."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}