{
  "openapi": "3.1.0",
  "info": {
    "title": "PredictLeads API Reference",
    "version": "4-beta",
    "description": "# Introduction\n\nOur API is RESTful and follows the <a target=\"_blank\" rel=\"noopener\" href=\"https://jsonapi.org/\">JSON API specification</a>.\n<br><br>\nFor easier implementation, we provide API description also in\n<a target=\"open_api_schema\" href=\"https://docs.predictleads.com/v4/schemas/open_api_schema.json\">OpenAPI schema (version 3.1.0)</a> JSON format\nand <a target=\"https://docs.predictleads.com/v4/swagger\" href=\"https://docs.predictleads.com/v4/swagger\">OpenAPI SwaggerUI playground</a>.\n<br><br>\nIn order to use our API, you must first <a target=\"_blank\" rel=\"noopener\" href=\"https://predictleads.com/sign_up\">sign up</a>\nto get an authentication key and token.\n<br><br>\nYou can see <a target=\"_blank\" rel=\"noopener\" href=\"https://status.predictleads.com\">live status of our API services</a>.\n\n## Authentication\n\nThe API supports two authentication methods. Your API key and token are available on the\n<a target=\"_blank\" rel=\"noopener\" href=\"https://predictleads.com/subscriptions\">Your Subscription Plans</a> page.\n\n### With OAuth2\n\nPredictLeads supports two OAuth2 flows.\n<br>\n<br>\n- **Authorization Code**\n  <br>\n  For OAuth2 clients, supporting <a target=\"_blank\" rel=\"noopener\" href=\"https://oauth.net/2/dynamic-client-registration/\">Dynamic Client Registration</a> for automatic setup.\n  <br>\n  <br>\n- **Client Credentials**\n  <br>\n  For OAuth2 server-to-server integrations, use the following settings:\n  <br>\n  <br>\n  `Access Token URL`: `https://oauth.predictleads.com/token`\n  <br>\n  `Client ID`: `{your_api_key}`\n  <br>\n  `Client Secret`: `{your_api_token}`\n\n### With HTTP headers\n\nFor direct access, pass your credentials as request headers:\n<br>\n<br>\n`X-Api-Key`: `{your_api_key}`\n<br>\n`X-Api-Token`: `{your_api_token}`\n\n\n## Request Limits\n\nEach account using the API has request limits implemented.\nThe amount of requests one can do each month is limited by the chosen plan. You can track your monthly usage on\n<a target=\"_blank\" rel=\"noopener\" href=\"https://predictleads.com/subscriptions\">Your Subscription Plans</a> page.\n<br><br>\nResponses carry an `X-Credits-Used` header, and MCP tool results include a `credits_used` field, with the credits\nthat request used. Requests rejected before reaching your account (401, 403 and 429) do not include it.\n<br><br>\nOnce the account reaches the limit, all further requests will produce a 402 HTTP error, notifying the user of\nthe reached limit. If you have any further questions regarding the limits, feel free to contact us via\n<a href=\"#contact\">support</a>.\n\n\n## Pagination\n\nResponses with a list of objects are paginated. Use `page` parameter to get more results.\nTotal number of all possible results is displayed inside `meta` property as `count`.\n"
  },
  "servers": [
    {
      "url": "https://predictleads.com/api/v4",
      "description": "Primary API server"
    }
  ],
  "paths": {
    "/companies/{id_or_domain}": {
      "get": {
        "tags": [
          "Companies Dataset"
        ],
        "summary": "Get Company",
        "description": "Returns Company.",
        "parameters": [
          {
            "name": "id_or_domain",
            "in": "path",
            "description": "Company's ID or domain.\n",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Request was successfully processed.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompaniesDataset"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body or parameters.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/BadRequestError"
                }
              }
            }
          },
          "401": {
            "description": "Authentication credentials are invalid or API subscription is not activated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnauthorizedError"
                }
              }
            }
          },
          "402": {
            "description": "Exceeded the monthly request limit.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/PaymentRequiredError"
                }
              }
            }
          },
          "403": {
            "description": "Request rate over limit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ForbiddenError"
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/NotFoundError"
                }
              }
            }
          },
          "422": {
            "description": "Provided data failed to validate.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnprocessableContentError"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests.",
            "headers": {
              "Retry-After": {
                "description": "Indicates how long to wait before making a new request (in seconds).",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/TooManyRequestsError"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/InternalServerError"
                }
              }
            }
          },
          "503": {
            "description": "Service temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ServiceUnavailableError"
                }
              }
            }
          }
        },
        "operationId": "get_api_v4_company",
        "x-credits-usage": {
          "credits_used_per_unit": 1,
          "unit": "response"
        }
      }
    },
    "/extended_companies/{id_or_domain}": {
      "get": {
        "tags": [
          "Extended Companies Dataset"
        ],
        "summary": "Get Extended Company",
        "description": "Returns Extended Company.",
        "parameters": [
          {
            "name": "id_or_domain",
            "in": "path",
            "description": "ExtendedCompany's ID or domain.\n",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Request was successfully processed.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExtendedCompaniesDataset"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body or parameters.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/BadRequestError"
                }
              }
            }
          },
          "401": {
            "description": "Authentication credentials are invalid or API subscription is not activated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnauthorizedError"
                }
              }
            }
          },
          "402": {
            "description": "Exceeded the monthly request limit.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/PaymentRequiredError"
                }
              }
            }
          },
          "403": {
            "description": "Request rate over limit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ForbiddenError"
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/NotFoundError"
                }
              }
            }
          },
          "422": {
            "description": "Provided data failed to validate.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnprocessableContentError"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests.",
            "headers": {
              "Retry-After": {
                "description": "Indicates how long to wait before making a new request (in seconds).",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/TooManyRequestsError"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/InternalServerError"
                }
              }
            }
          },
          "503": {
            "description": "Service temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ServiceUnavailableError"
                }
              }
            }
          }
        },
        "operationId": "get_api_v4_extended_company",
        "x-credits-usage": {
          "credits_used_per_unit": 2,
          "unit": "response"
        }
      }
    },
    "/companies/{company_id_or_domain}/company_signals": {
      "get": {
        "tags": [
          "Company Signals Dataset"
        ],
        "summary": "Get Company Signals",
        "description": "Returns a list of a company's Company Signals.",
        "parameters": [
          {
            "name": "company_id_or_domain",
            "in": "path",
            "description": "Company's ID or domain.\n",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "first_seen_at_from",
            "in": "query",
            "description": "Only return `CompanySignals` first seen after\ngiven date (ISO 8601).\n",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2024-09-25"
            }
          },
          {
            "name": "first_seen_at_until",
            "in": "query",
            "description": "Only return `CompanySignals` first seen before\ngiven date (ISO 8601).\n",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2024-09-25"
            }
          },
          {
            "name": "categories",
            "in": "query",
            "description": "One or more valid categories.\n\n",
            "required": false,
            "example": "corporate_development,funding,financials",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "oneOf": [
                  {
                    "const": "corporate_development"
                  },
                  {
                    "const": "funding"
                  },
                  {
                    "const": "financials"
                  },
                  {
                    "const": "people"
                  },
                  {
                    "const": "location_and_facilities"
                  },
                  {
                    "const": "strategy"
                  },
                  {
                    "const": "product"
                  },
                  {
                    "const": "tech_stack"
                  },
                  {
                    "const": "market_relationships"
                  },
                  {
                    "const": "recognition"
                  },
                  {
                    "const": "legal_and_risk"
                  },
                  {
                    "const": "other"
                  }
                ]
              },
              "example": [
                "corporate_development",
                "funding",
                "financials"
              ]
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number of shown items.\n<br>\n**NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for\nperformance reasons.\n",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Limit the number of shown items per page.",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 100,
              "maximum": 1000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Request was successfully processed.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompanySignalsDataset"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body or parameters.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/BadRequestError"
                }
              }
            }
          },
          "401": {
            "description": "Authentication credentials are invalid or API subscription is not activated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnauthorizedError"
                }
              }
            }
          },
          "402": {
            "description": "Exceeded the monthly request limit.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/PaymentRequiredError"
                }
              }
            }
          },
          "403": {
            "description": "Request rate over limit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ForbiddenError"
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/NotFoundError"
                }
              }
            }
          },
          "422": {
            "description": "Provided data failed to validate.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnprocessableContentError"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests.",
            "headers": {
              "Retry-After": {
                "description": "Indicates how long to wait before making a new request (in seconds).",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/TooManyRequestsError"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/InternalServerError"
                }
              }
            }
          },
          "503": {
            "description": "Service temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ServiceUnavailableError"
                }
              }
            }
          }
        },
        "operationId": "get_api_v4_companies_company_signals",
        "x-credits-usage": {
          "credits_used_per_unit": 1,
          "unit": "response"
        }
      }
    },
    "/companies/{company_id_or_domain}/website_changes": {
      "get": {
        "tags": [
          "Website Changes Dataset"
        ],
        "summary": "Get Website Changes",
        "description": "Returns a list of changes detected on a company's website, including the markdown difference and AI-generated rationale for each change.",
        "parameters": [
          {
            "name": "company_id_or_domain",
            "in": "path",
            "description": "Company's ID or domain.\n",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number of shown items.\n<br>\n**NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for\nperformance reasons.\n",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Limit the number of shown items per page.",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 50,
              "maximum": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Request was successfully processed.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebsiteChangesDataset"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body or parameters.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/BadRequestError"
                }
              }
            }
          },
          "401": {
            "description": "Authentication credentials are invalid or API subscription is not activated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnauthorizedError"
                }
              }
            }
          },
          "402": {
            "description": "Exceeded the monthly request limit.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/PaymentRequiredError"
                }
              }
            }
          },
          "403": {
            "description": "Request rate over limit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ForbiddenError"
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/NotFoundError"
                }
              }
            }
          },
          "422": {
            "description": "Provided data failed to validate.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnprocessableContentError"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests.",
            "headers": {
              "Retry-After": {
                "description": "Indicates how long to wait before making a new request (in seconds).",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/TooManyRequestsError"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/InternalServerError"
                }
              }
            }
          },
          "503": {
            "description": "Service temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ServiceUnavailableError"
                }
              }
            }
          }
        },
        "operationId": "get_api_v4_companies_website_changes",
        "x-credits-usage": {
          "credits_used_per_unit": 1,
          "unit": "record"
        }
      }
    },
    "/discover/website_changes": {
      "get": {
        "tags": [
          "Website Changes Dataset"
        ],
        "summary": "Discover Website Changes",
        "description": "Returns a list of website changes from all companies, newest first. A change is returned only if one of its events matches all filters.",
        "parameters": [
          {
            "name": "first_seen_at_from",
            "in": "query",
            "description": "Only return `WebsiteChanges` first seen after\ngiven date (ISO 8601).\n",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2024-09-25"
            }
          },
          {
            "name": "first_seen_at_until",
            "in": "query",
            "description": "Only return `WebsiteChanges` first seen before\ngiven date (ISO 8601).\n",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2024-09-25"
            }
          },
          {
            "name": "categories",
            "in": "query",
            "description": "One or more valid categories.\n\n",
            "required": false,
            "example": "strategic_pivot,audience_change,product_launch",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "oneOf": [
                  {
                    "const": "strategic_pivot"
                  },
                  {
                    "const": "audience_change"
                  },
                  {
                    "const": "product_launch"
                  },
                  {
                    "const": "pricing_restructure"
                  },
                  {
                    "const": "leadership_change"
                  },
                  {
                    "const": "acquisition"
                  },
                  {
                    "const": "merger"
                  },
                  {
                    "const": "spin_off"
                  },
                  {
                    "const": "asset_sale"
                  },
                  {
                    "const": "financing_event"
                  },
                  {
                    "const": "public_listing"
                  },
                  {
                    "const": "exchange_delisting"
                  },
                  {
                    "const": "partnership"
                  },
                  {
                    "const": "integration"
                  },
                  {
                    "const": "investor_identified"
                  },
                  {
                    "const": "customer_identified"
                  },
                  {
                    "const": "new_office"
                  },
                  {
                    "const": "market_entry"
                  },
                  {
                    "const": "operational_restructuring"
                  },
                  {
                    "const": "recognition"
                  },
                  {
                    "const": "attends_event"
                  },
                  {
                    "const": "winding_down"
                  },
                  {
                    "const": "other"
                  }
                ]
              },
              "example": [
                "strategic_pivot",
                "audience_change",
                "product_launch"
              ]
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "importance_from",
            "in": "query",
            "description": "Only return website changes with an event of this importance or higher.\n",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10,
              "example": 8
            }
          },
          {
            "name": "importance_to",
            "in": "query",
            "description": "Only return website changes with an event of this importance or lower.\n",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10,
              "example": 10
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number of shown items.\n<br>\n**NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for\nperformance reasons.\n",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Limit the number of shown items per page.",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 10,
              "maximum": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Request was successfully processed.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebsiteChangesDataset"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body or parameters.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/BadRequestError"
                }
              }
            }
          },
          "401": {
            "description": "Authentication credentials are invalid or API subscription is not activated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnauthorizedError"
                }
              }
            }
          },
          "402": {
            "description": "Exceeded the monthly request limit.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/PaymentRequiredError"
                }
              }
            }
          },
          "403": {
            "description": "Request rate over limit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ForbiddenError"
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/NotFoundError"
                }
              }
            }
          },
          "422": {
            "description": "Provided data failed to validate.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnprocessableContentError"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests.",
            "headers": {
              "Retry-After": {
                "description": "Indicates how long to wait before making a new request (in seconds).",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/TooManyRequestsError"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/InternalServerError"
                }
              }
            }
          },
          "503": {
            "description": "Service temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ServiceUnavailableError"
                }
              }
            }
          }
        },
        "operationId": "get_api_v4_discover_website_changes",
        "x-credits-usage": {
          "credits_used_per_unit": 1,
          "unit": "record"
        }
      }
    },
    "/companies/{company_id_or_domain}/subpages": {
      "get": {
        "tags": [
          "Subpages Dataset"
        ],
        "summary": "Get Subpages",
        "description": "Returns a list of a company's Subpages.",
        "parameters": [
          {
            "name": "company_id_or_domain",
            "in": "path",
            "description": "Company's ID or domain.\n",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "first_seen_at_from",
            "in": "query",
            "description": "Only return `Subpages` first seen after\ngiven date (ISO 8601).\n",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2024-09-25"
            }
          },
          {
            "name": "first_seen_at_until",
            "in": "query",
            "description": "Only return `Subpages` first seen before\ngiven date (ISO 8601).\n",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2024-09-25"
            }
          },
          {
            "name": "categories",
            "in": "query",
            "description": "One or more valid categories.\n\n",
            "required": false,
            "example": "blog,news,press",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "blog",
                  "news",
                  "press",
                  "about",
                  "leadership",
                  "jobs",
                  "facebook",
                  "twitter",
                  "linkedin",
                  "instagram",
                  "pinterest",
                  "contact",
                  "playstore",
                  "appstore",
                  "news_outlet",
                  "customers",
                  "partners",
                  "integrations",
                  "case_studies",
                  "portfolio",
                  "suppliers",
                  "testimonials",
                  "login",
                  "support",
                  "pricing",
                  "job_board",
                  "main",
                  "github",
                  "investors",
                  "products",
                  "solutions",
                  "status",
                  "demo",
                  "resources",
                  "events",
                  "developers",
                  "api",
                  "terms",
                  "privacy",
                  "trust",
                  "feedback",
                  "marketplace",
                  "store",
                  "community",
                  "retail",
                  "sitemap",
                  "webinars",
                  "search",
                  "social_media",
                  "updates",
                  "registration",
                  "locations",
                  "external_review",
                  "discord",
                  "youtube",
                  "tiktok",
                  "sec",
                  "review",
                  "subprocessors",
                  "changelog"
                ]
              },
              "example": [
                "blog",
                "news",
                "press"
              ]
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number of shown items.\n<br>\n**NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for\nperformance reasons.\n",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Limit the number of shown items per page.",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 100,
              "maximum": 1000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Request was successfully processed.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubpagesDataset"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body or parameters.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/BadRequestError"
                }
              }
            }
          },
          "401": {
            "description": "Authentication credentials are invalid or API subscription is not activated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnauthorizedError"
                }
              }
            }
          },
          "402": {
            "description": "Exceeded the monthly request limit.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/PaymentRequiredError"
                }
              }
            }
          },
          "403": {
            "description": "Request rate over limit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ForbiddenError"
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/NotFoundError"
                }
              }
            }
          },
          "422": {
            "description": "Provided data failed to validate.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnprocessableContentError"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests.",
            "headers": {
              "Retry-After": {
                "description": "Indicates how long to wait before making a new request (in seconds).",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/TooManyRequestsError"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/InternalServerError"
                }
              }
            }
          },
          "503": {
            "description": "Service temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ServiceUnavailableError"
                }
              }
            }
          }
        },
        "operationId": "get_api_v4_companies_subpages",
        "x-credits-usage": {
          "credits_used_per_unit": 1,
          "unit": "response"
        }
      }
    },
    "/companies/{company_id_or_domain}/sec_financials": {
      "get": {
        "tags": [
          "SEC Financials Dataset"
        ],
        "summary": "Get SEC Financials",
        "description": "Returns a list of a company's periodic SEC filings with the income statement each one reports.",
        "operationId": "get_api_v4_companies_sec_financials",
        "parameters": [
          {
            "name": "company_id_or_domain",
            "in": "path",
            "description": "Company's ID or domain.\n",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number of shown items.\n<br>\n**NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for\nperformance reasons.\n",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Limit the number of shown items per page.",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 10,
              "maximum": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Request was successfully processed.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SECFinancialsDataset"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body or parameters.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/BadRequestError"
                }
              }
            }
          },
          "401": {
            "description": "Authentication credentials are invalid or API subscription is not activated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnauthorizedError"
                }
              }
            }
          },
          "402": {
            "description": "Exceeded the monthly request limit.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/PaymentRequiredError"
                }
              }
            }
          },
          "403": {
            "description": "Request rate over limit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ForbiddenError"
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/NotFoundError"
                }
              }
            }
          },
          "422": {
            "description": "Provided data failed to validate.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnprocessableContentError"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests.",
            "headers": {
              "Retry-After": {
                "description": "Indicates how long to wait before making a new request (in seconds).",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/TooManyRequestsError"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/InternalServerError"
                }
              }
            }
          },
          "503": {
            "description": "Service temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ServiceUnavailableError"
                }
              }
            }
          }
        },
        "x-credits-usage": {
          "credits_used_per_unit": 1,
          "unit": "response"
        }
      }
    },
    "/api_request_logs": {
      "get": {
        "tags": [
          "Api Request Logs"
        ],
        "summary": "Get API request logs",
        "description": "Returns a paginated list of API request log entries for the current subscription.",
        "parameters": [
          {
            "name": "requested_at_from",
            "in": "query",
            "description": "Only return `ApiRequestLogs` requested after\nthe given date (ISO 8601).\n",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2024-09-25"
            }
          },
          {
            "name": "requested_at_until",
            "in": "query",
            "description": "Only return `ApiRequestLogs` requested before\nthe given date (ISO 8601).\n",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2024-09-25"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number of shown items.\n<br>\n**NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for\nperformance reasons.\n",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Limit the number of shown items per page.",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 100,
              "maximum": 1000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Request was successfully processed.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiRequestLogs"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body or parameters.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/BadRequestError"
                }
              }
            }
          },
          "401": {
            "description": "Authentication credentials are invalid or API subscription is not activated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnauthorizedError"
                }
              }
            }
          },
          "402": {
            "description": "Exceeded the monthly request limit.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/PaymentRequiredError"
                }
              }
            }
          },
          "403": {
            "description": "Request rate over limit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ForbiddenError"
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/NotFoundError"
                }
              }
            }
          },
          "422": {
            "description": "Provided data failed to validate.",
            "headers": {
              "X-Credits-Used": {
                "$ref": "#/components/headers/Headers.CreditsUsedHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/UnprocessableContentError"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests.",
            "headers": {
              "Retry-After": {
                "description": "Indicates how long to wait before making a new request (in seconds).",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/TooManyRequestsError"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/InternalServerError"
                }
              }
            }
          },
          "503": {
            "description": "Service temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/x-errorSchemas/ServiceUnavailableError"
                }
              }
            }
          }
        },
        "operationId": "get_api_v4_api_request_logs",
        "x-credits-usage": {
          "credits_used_per_unit": 0,
          "unit": "response"
        }
      }
    }
  },
  "webhooks": {
    "CompanySignalsDataset": {
      "post": {
        "tags": [
          "Company Signals Dataset"
        ],
        "summary": "Receive followed company's Company Signals",
        "description": "Sends a list containing a single followed company's Company Signal.\n<br>\n<br>\n**Triggered when**:\n<br>\n- Found\n",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompanySignalsDataset"
              },
              "examples": {
                "general": {
                  "value": {
                    "data": [
                      {
                        "id": "019ff376-0929-770a-bef2-fdc11f58d6d0",
                        "type": "company_signal",
                        "sources": [
                          "job_openings"
                        ],
                        "category": "people",
                        "subcategory": "department_hiring_surge",
                        "headline": "Hiring surge in Operations",
                        "summary": "Hiring surge in Operations, with 11 new openings in the last 30 days against a usual 1.56 a month.",
                        "evidence": "11 new openings in the last 30 days vs 1.6 monthly average.",
                        "details": {
                          "type": "department_hiring_surge_details",
                          "openings": 11,
                          "department": "Operations",
                          "monthly_average": 1.56
                        },
                        "importance": "high",
                        "sentiment": "positive",
                        "detected_at": "2026-08-12T00:53:46Z",
                        "first_seen_at": null,
                        "company": {
                          "id": "016325d2-479a-79ba-8bc1-5b45b812daab",
                          "type": "company",
                          "domain": "mercor.com",
                          "name": "Mercor",
                          "ticker": null
                        },
                        "detected_on_job_openings": [],
                        "detected_on_sec_filings": []
                      }
                    ],
                    "meta": {
                      "schema_version": "4.2",
                      "record_state": "active"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully."
          }
        }
      }
    },
    "CompanySignalsDeletedDataset": {
      "post": {
        "tags": [
          "Company Signals Deleted Dataset"
        ],
        "summary": "Receive followed company's deleted Company Signals",
        "description": "Sends a list containing a single followed company's deleted Company Signal.\n<br>\n<br>\n**Triggered when**:\n<br>\n- Disapproved\n",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompanySignalsDeletedDataset"
              },
              "examples": {
                "general": {
                  "value": {
                    "data": [
                      {
                        "id": "01a1b222-8f32-7094-b425-b9776092ce17",
                        "type": "company_signal"
                      }
                    ],
                    "meta": {
                      "schema_version": "4.0",
                      "record_state": "deleted"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully."
          }
        }
      }
    }
  },
  "components": {
    "responses": {
      "200": {
        "description": "Request was successfully processed.",
        "headers": {
          "X-Credits-Used": {
            "$ref": "#/components/headers/Headers.CreditsUsedHeader"
          }
        }
      },
      "400": {
        "description": "Invalid request body or parameters.",
        "headers": {
          "X-Credits-Used": {
            "$ref": "#/components/headers/Headers.CreditsUsedHeader"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/x-errorSchemas/BadRequestError"
            }
          }
        }
      },
      "401": {
        "description": "Authentication credentials are invalid or API subscription is not activated.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/x-errorSchemas/UnauthorizedError"
            }
          }
        }
      },
      "402": {
        "description": "Exceeded the monthly request limit.",
        "headers": {
          "X-Credits-Used": {
            "$ref": "#/components/headers/Headers.CreditsUsedHeader"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/x-errorSchemas/PaymentRequiredError"
            }
          }
        }
      },
      "403": {
        "description": "Request rate over limit.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/x-errorSchemas/ForbiddenError"
            }
          }
        }
      },
      "404": {
        "description": "Record not found.",
        "headers": {
          "X-Credits-Used": {
            "$ref": "#/components/headers/Headers.CreditsUsedHeader"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/x-errorSchemas/NotFoundError"
            }
          }
        }
      },
      "422": {
        "description": "Provided data failed to validate.",
        "headers": {
          "X-Credits-Used": {
            "$ref": "#/components/headers/Headers.CreditsUsedHeader"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/x-errorSchemas/UnprocessableContentError"
            }
          }
        }
      },
      "429": {
        "description": "Too many requests.",
        "headers": {
          "Retry-After": {
            "description": "Indicates how long to wait before making a new request (in seconds).",
            "schema": {
              "type": "integer"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/x-errorSchemas/TooManyRequestsError"
            }
          }
        }
      },
      "500": {
        "description": "Internal server error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/x-errorSchemas/InternalServerError"
            }
          }
        }
      },
      "503": {
        "description": "Service temporarily unavailable.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/x-errorSchemas/ServiceUnavailableError"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY"
      },
      "api_token": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-TOKEN"
      },
      "basic": {
        "type": "http",
        "scheme": "basic"
      }
    },
    "headers": {
      "Headers.CreditsUsedHeader": {
        "description": "The credits this request was charged.",
        "schema": {
          "type": "integer"
        }
      }
    },
    "x-errorSchemas": {
      "BadRequestError": {
        "description": "Bad request.",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "message"
            ],
            "properties": {
              "type": {
                "description": "Type of the `BadRequestError` object.",
                "const": "bad_request"
              },
              "message": {
                "description": "Error message.",
                "type": "string"
              }
            }
          }
        },
        "additionalProperties": false,
        "example": {
          "error": {
            "type": "bad_request",
            "message": "..."
          }
        }
      },
      "UnauthorizedError": {
        "description": "Unauthorized.",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "message"
            ],
            "properties": {
              "type": {
                "description": "Type of the `UnauthorizedError` object.",
                "const": "unauthorized"
              },
              "message": {
                "description": "Error message.",
                "type": "string",
                "const": "Authentication failed"
              }
            }
          }
        },
        "additionalProperties": false,
        "example": {
          "error": {
            "type": "unauthorized",
            "message": "..."
          }
        }
      },
      "PaymentRequiredError": {
        "description": "Payment required.",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "message"
            ],
            "properties": {
              "type": {
                "description": "Type of the `PaymentRequiredError` object.",
                "const": "payment_required"
              },
              "message": {
                "description": "Error message.",
                "type": "string"
              }
            }
          }
        },
        "additionalProperties": false,
        "example": {
          "error": {
            "type": "payment_required",
            "message": "You have exceeded the monthly request limit. To minimize your service disruption, you might want to consider upgrading your current API Subscription Plan."
          }
        }
      },
      "ForbiddenError": {
        "description": "Forbidden.",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "message"
            ],
            "properties": {
              "type": {
                "description": "Type of the `ForbiddenError` object.",
                "const": "forbidden"
              },
              "message": {
                "description": "Error message.",
                "type": "string"
              }
            }
          }
        },
        "additionalProperties": false,
        "example": {
          "error": {
            "type": "forbidden",
            "message": "..."
          }
        }
      },
      "NotFoundError": {
        "description": "Not found.",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "message"
            ],
            "properties": {
              "type": {
                "description": "Type of the `NotFoundError` object.",
                "const": "not_found"
              },
              "message": {
                "description": "Error message.",
                "type": "string"
              }
            }
          }
        },
        "additionalProperties": false,
        "example": {
          "error": {
            "type": "not_found",
            "message": "..."
          }
        }
      },
      "UnprocessableContentError": {
        "description": "Unprocessable content.",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "message"
            ],
            "properties": {
              "type": {
                "description": "Type of the `UnprocessableContentError` object.",
                "const": "unprocessable_content"
              },
              "message": {
                "description": "Error message.",
                "type": "string"
              }
            }
          }
        },
        "additionalProperties": false,
        "example": {
          "error": {
            "type": "unprocessable_content",
            "message": "..."
          }
        }
      },
      "TooManyRequestsError": {
        "description": "Too many requests.",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "message"
            ],
            "properties": {
              "type": {
                "description": "Type of the `TooManyRequestsError` object.",
                "const": "too_many_requests"
              },
              "message": {
                "description": "Error message.",
                "type": "string"
              }
            }
          }
        },
        "additionalProperties": false,
        "example": {
          "error": {
            "type": "too_many_requests",
            "message": "Too many requests in a short time period. Please try again later."
          }
        }
      },
      "InternalServerError": {
        "description": "Internal server error.",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "message"
            ],
            "properties": {
              "type": {
                "description": "Type of the `InternalServerError` object.",
                "const": "internal_server_error"
              },
              "message": {
                "description": "Error message.",
                "type": "string"
              }
            }
          }
        },
        "additionalProperties": false,
        "example": {
          "error": {
            "type": "internal_server_error",
            "message": "..."
          }
        }
      },
      "ServiceUnavailableError": {
        "description": "Service unavailable.",
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "message"
            ],
            "properties": {
              "type": {
                "description": "Type of the `ServiceUnavailableError` object.",
                "const": "service_unavailable"
              },
              "message": {
                "description": "Error message.",
                "type": "string"
              }
            }
          }
        },
        "additionalProperties": false,
        "example": {
          "error": {
            "type": "service_unavailable",
            "message": "..."
          }
        }
      }
    },
    "schemas": {
      "CompaniesDataset": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "CompaniesDataset",
        "summary": "Information about companies.\n",
        "description": "Companies Dataset includes data such as Company Name, Meta Title, Meta Description,\nStructured Location Data, Ticker, Parent Company, Language and other basic company information.\n",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/x-subSchemas/Company"
            }
          },
          "meta": {
            "description": "Meta information about `CompaniesDataset` object.\n",
            "type": "object",
            "required": [
              "schema_version",
              "record_state"
            ],
            "properties": {
              "schema_version": {
                "title": "Meta.SchemaVersion",
                "description": "Represents schema version of objects.\n",
                "type": "string"
              },
              "record_state": {
                "title": "Meta.RecordState",
                "description": "Represents record state of objects.\n",
                "type": "string",
                "const": "active"
              },
              "count": {
                "description": "Total number of results.\n<br>\n**NOTE**: Only included in API responses when the request parameter `page` is provided,\nfor performance reasons.\n",
                "type": "integer",
                "example": 344
              }
            }
          }
        },
        "example": {
          "data": [
            {
              "id": "0160c0f9-78d8-7274-9faa-a37a5d7f1ab6",
              "type": "company",
              "domain": "brex.com",
              "name": "Brex Inc.",
              "friendly_name": "Brex",
              "ticker": null,
              "meta_title": "Brex: The Modern Finance Software Platform | Spend Smarter",
              "meta_description": "Simplify expense management with Brex's finance platform. From company cards to banking, Brex helps you drive growth, automate processes, & earn more.",
              "description": "Brex provides a finance platform that includes corporate charge cards, cash management accounts, and tools for expense and travel management. The organization serves founders and finance teams, specifically targeting technology companies. Operating globally across many countries, the organization focuses on automating accounting processes and managing business spending through integrated banking and credit services.",
              "description_short": "Brex is a business financial services provider that serves founders and finance teams.",
              "language": "en",
              "location": "2261 Market Street, San Francisco, CA 94114, United States",
              "location_data": [
                {
                  "id": "01a1369f-e0b2-7425-9f8b-6d9cc200dba6",
                  "type": "company_location_data",
                  "location": "2261 Market Street, San Francisco, CA 94114, United States",
                  "zip_code": "94114",
                  "street_address": "2261 Market Street",
                  "city": "San Francisco",
                  "county": "San Francisco County",
                  "admin_area": "California",
                  "state": "California",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 37.764685,
                  "longitude": -122.43194,
                  "fuzzy_match": false,
                  "category": "headquarters"
                },
                {
                  "id": "01a1369f-e0b2-760c-adec-7c95d8e27f1e",
                  "type": "company_location_data",
                  "location": "50 W Broadway, Salt Lake City, UT 84101, United States",
                  "zip_code": "84119",
                  "street_address": null,
                  "city": "Salt Lake City",
                  "county": "Salt Lake County",
                  "admin_area": "Utah",
                  "state": "Utah",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 40.773201,
                  "longitude": -111.933984,
                  "fuzzy_match": true,
                  "category": "headquarters"
                },
                {
                  "id": "01a1369f-e0b2-78dd-a946-ce2364bb27e8",
                  "type": "company_location_data",
                  "location": "650 S 500 W, Salt Lake City, UT 84101-2380, United States",
                  "zip_code": "84101",
                  "street_address": "650 South 500 West",
                  "city": "Salt Lake City",
                  "county": "Salt Lake County",
                  "admin_area": "Utah",
                  "state": "Utah",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 40.755136,
                  "longitude": -111.905691,
                  "fuzzy_match": false,
                  "category": "headquarters"
                },
                {
                  "id": "01a1369f-e0b2-73de-b25c-ecdb1c53f68e",
                  "type": "company_location_data",
                  "location": "1 Commerce Way, Little Rock, Arkansas 72202, United States",
                  "zip_code": "72202",
                  "street_address": "1 Commerce Way",
                  "city": "Little Rock",
                  "county": "Pulaski County",
                  "admin_area": "Arkansas",
                  "state": "Arkansas",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 34.764932,
                  "longitude": -92.302579,
                  "fuzzy_match": false,
                  "category": "office"
                },
                {
                  "id": "01a1369f-e0b2-7093-99c2-dbb6c7dd96b6",
                  "type": "company_location_data",
                  "location": "Austin, Texas, United States",
                  "zip_code": "78701",
                  "street_address": null,
                  "city": "Austin",
                  "county": "Travis County",
                  "admin_area": "Texas",
                  "state": "Texas",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 30.222346,
                  "longitude": -97.836521,
                  "fuzzy_match": true,
                  "category": "office"
                },
                {
                  "id": "01a1369f-e0b2-7cbc-bc7d-ab5e685f560d",
                  "type": "company_location_data",
                  "location": "District of Columbia, United States",
                  "zip_code": null,
                  "street_address": null,
                  "city": null,
                  "county": null,
                  "admin_area": "District of Columbia",
                  "state": "District of Columbia",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 38.912097,
                  "longitude": -77.014683,
                  "fuzzy_match": true,
                  "category": "service_area"
                },
                {
                  "id": "01a1369f-e0b2-7565-8ab7-3084cfbebbd9",
                  "type": "company_location_data",
                  "location": "New York, United States",
                  "zip_code": "11238",
                  "street_address": null,
                  "city": "New York",
                  "county": "Kings County",
                  "admin_area": "New York",
                  "state": "New York",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 40.68295,
                  "longitude": -73.9708,
                  "fuzzy_match": false,
                  "category": "service_area"
                },
                {
                  "id": "01a1369f-e0b2-7a3f-832f-ace75d815801",
                  "type": "company_location_data",
                  "location": "2261 Market Street, San Francisco, CA 94114, United States",
                  "zip_code": "94114",
                  "street_address": "2261 Market Street",
                  "city": "San Francisco",
                  "county": "San Francisco County",
                  "admin_area": "California",
                  "state": "California",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 37.764685,
                  "longitude": -122.43194,
                  "fuzzy_match": false,
                  "category": "registered_address"
                },
                {
                  "id": "01a1369f-e0b2-7fd3-a049-c6b46116bcaf",
                  "type": "company_location_data",
                  "location": "650 S 500 W, Salt Lake City, UT 84101, United States",
                  "zip_code": "84101",
                  "street_address": "650 South 500 West",
                  "city": "Salt Lake City",
                  "county": "Salt Lake County",
                  "admin_area": "Utah",
                  "state": "Utah",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 40.755136,
                  "longitude": -111.905691,
                  "fuzzy_match": false,
                  "category": "registered_address"
                }
              ],
              "last_extraction_states": [
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-08-14T20:29:21.268003+02:00"
                },
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-08-22T02:21:08.710900+02:00"
                },
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-09-01T02:39:38.301223+02:00"
                },
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-09-11T03:07:01.653616+02:00"
                },
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-10-09T12:40:12.884940+02:00"
                },
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-10-25T23:48:53.904399+01:00"
                }
              ],
              "redirects_to_company": null,
              "redirects_to_company_reason": null,
              "parent_company": {
                "id": "015353a8-fd39-7e43-80fa-f874553b771a",
                "type": "company",
                "domain": "capitalone.com",
                "name": "Capital One Group",
                "ticker": "NYSE:COF-PN"
              },
              "subsidiary_companies": [
                {
                  "id": "017228dc-076b-7596-b07e-faefc8752ef8",
                  "type": "company",
                  "domain": "pry.co",
                  "name": "Pry Financials Inc.",
                  "ticker": null
                },
                {
                  "id": "01776f82-37b5-7adb-add2-7f810abe4689",
                  "type": "company",
                  "domain": "weav.co",
                  "name": "Weav Technologies, Inc.",
                  "ticker": null
                }
              ],
              "similar_companies": [
                {
                  "id": "014ef54b-b9bc-7859-bf70-fda144d0a69b",
                  "type": "company",
                  "domain": "ramp.com",
                  "name": "Ramp Corp.",
                  "ticker": null
                },
                {
                  "id": "0163f658-c47e-732b-a6fa-b8cb036cb5b3",
                  "type": "company",
                  "domain": "airbase.com",
                  "name": "Airbase Inc.",
                  "ticker": null
                },
                {
                  "id": "015353e7-03d5-7433-944a-c58b78378b79",
                  "type": "company",
                  "domain": "expensify.com",
                  "name": "Expensify, Inc.",
                  "ticker": "NASDAQ:EXFY"
                },
                {
                  "id": "01862da7-1a0e-7508-ad04-8edc8fee5e5e",
                  "type": "company",
                  "domain": "navan.com",
                  "name": "Navan, Inc.",
                  "ticker": "NASDAQ:NAVN"
                },
                {
                  "id": "016187f1-7688-7d3e-8e5c-86eebb5b0a37",
                  "type": "company",
                  "domain": "mercury.com",
                  "name": "Mercury Technologies, Inc.",
                  "ticker": null
                }
              ]
            }
          ],
          "meta": {
            "schema_version": "4.1",
            "record_state": "active"
          }
        }
      },
      "ExtendedCompaniesDataset": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "ExtendedCompaniesDataset",
        "summary": "Extended information about companies.\n",
        "description": "The Extended Companies Dataset includes additional company data such as Company size range,\nCompany Logo, Company Slogan, Industry, Company Type and other company information.\n",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/x-subSchemas/ExtendedCompany"
            }
          },
          "meta": {
            "description": "Meta information about `ExtendedCompaniesDataset` object.\n",
            "type": "object",
            "required": [
              "schema_version",
              "record_state"
            ],
            "properties": {
              "schema_version": {
                "title": "Meta.SchemaVersion",
                "description": "Represents schema version of objects.\n",
                "type": "string"
              },
              "record_state": {
                "title": "Meta.RecordState",
                "description": "Represents record state of objects.\n",
                "type": "string",
                "const": "active"
              },
              "count": {
                "description": "Total number of results.\n<br>\n**NOTE**: Only included in API responses when the request parameter `page` is provided,\nfor performance reasons.\n",
                "type": "integer",
                "example": 344
              }
            }
          }
        },
        "example": {
          "data": [
            {
              "id": "0164245a-5850-76aa-ba63-f947a5904cbb",
              "type": "company",
              "domain": "meettippy.com",
              "name": "DirectTIPS Operations, LLC.",
              "friendly_name": "Tippy",
              "ticker": null,
              "meta_title": "Homepage - Tippy",
              "meta_description": "We are tipping experts with optimized solutions for Salons & Spas. Groomers. Fitness. Auto Shops. Your Business. Let us find the best tipping solution for you! Enter your email to get started! Yay Tippy! Winners for Best Work Spaces, Best of Fort Lauderdale 2022! Thank you Fort Lauderdale Magazine and",
              "description": "Tippy provides digital tipping solutions designed for service-based businesses, including salons, spas, grooming facilities, fitness centers, and auto shops. The organization facilitates the collection of gratuities and manages instant payouts to service professionals. To support these operations, the organization integrates with point-of-sale systems and provides standalone kiosks to handle the processing of tips.",
              "description_short": "Tippy provides digital tipping solutions for service-based businesses such as salons, spas, grooming facilities, fitness centers, and auto shops.",
              "language": "en",
              "location": "2755 E Oakland Park Blvd, Fort Lauderdale, Florida 33306, United States",
              "location_data": [
                {
                  "id": "01a0b033-9b07-76c1-9add-771c1429f0be",
                  "type": "company_location_data",
                  "location": "2755 E Oakland Park Blvd, Fort Lauderdale, Florida 33306, United States",
                  "zip_code": "33306",
                  "street_address": "2755 East Oakland Park Boulevard",
                  "city": "Fort Lauderdale",
                  "county": "Broward County",
                  "admin_area": "Florida",
                  "state": "Florida",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 26.16749,
                  "longitude": -80.11004,
                  "fuzzy_match": false,
                  "category": "headquarters"
                },
                {
                  "id": "01a0b033-9b07-7de9-b86c-11b73e76fc12",
                  "type": "company_location_data",
                  "location": "935 Berkshire Blvd, Reading, Pennsylvania 19610, United States",
                  "zip_code": "19606",
                  "street_address": null,
                  "city": "Reading",
                  "county": "Berks County",
                  "admin_area": "Pennsylvania",
                  "state": "Pennsylvania",
                  "country": "United States",
                  "continent": "North America",
                  "latitude": 40.346978,
                  "longitude": -75.924261,
                  "fuzzy_match": true,
                  "category": "unknown"
                }
              ],
              "last_extraction_states": [
                {
                  "status": "processing_error",
                  "status_code": null,
                  "processed_at": "2025-09-28T18:27:10.706385+02:00"
                },
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-03-28T18:54:01.541244+01:00"
                },
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-06-04T18:49:35.324089+02:00"
                },
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-08-04T19:12:11.918288+02:00"
                },
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-10-05T18:19:53.217516+02:00"
                },
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-10-17T03:34:52.592070+02:00"
                }
              ],
              "redirects_to_company": null,
              "redirects_to_company_reason": null,
              "parent_company": null,
              "subsidiary_companies": [],
              "similar_companies": [
                {
                  "id": "015354f5-c0b5-7d77-b7a3-2d9159dcabd6",
                  "type": "company",
                  "domain": "toasttab.com",
                  "name": "Toast Tab, Inc.",
                  "ticker": "NYSE:TOST"
                },
                {
                  "id": "015354e1-3157-7e36-883d-c01e24d001a1",
                  "type": "company",
                  "domain": "squareup.com",
                  "name": "Square Inc.",
                  "ticker": "NYSE:SQ"
                },
                {
                  "id": "0154e099-edd4-7f6d-8309-19a6d70a1153",
                  "type": "company",
                  "domain": "vagaro.com",
                  "name": "Vagaro",
                  "ticker": null
                },
                {
                  "id": "016e3753-f830-758e-b9f4-6dc1608f6ac9",
                  "type": "company",
                  "domain": "joinblvd.com",
                  "name": "Boulevard Labs, Inc.",
                  "ticker": null
                },
                {
                  "id": "0160e4cb-854c-7da2-a745-e6b59e0ea29b",
                  "type": "company",
                  "domain": "glossgenius.com",
                  "name": "GlossGenius",
                  "ticker": null
                }
              ],
              "employees_min": 11,
              "employees_max": 50,
              "social_associated_members": 34,
              "social_logo": "https://media.licdn.com/dms/image/v2/C560BAQHr5TzG8l8HZg/company-logo_200_200/company-logo_200_200/0/1644532656596/directtips_logo?e=2147483647&v=beta&t=xOcm6avQ2hBFivlccvElWIOZFcYMXgp_XP7K-HpAKH8",
              "social_slogan": "Cashless Tipping Solutions For Any Business!",
              "social_description": "We are tipping experts with optimized solutions for any business. The best part? We deposit tips instantly. Some call it magic, we call it expertise.",
              "social_url": "https://www.linkedin.com/company/directtips",
              "social_industry": "Financial Services",
              "social_company_type": "Privately Held",
              "social_headquarters": "Fort Lauderdale, Florida",
              "social_founded": "2016",
              "social_funding_price": "US$ 690.8K",
              "social_funding_last_round_date": "2020-05-20",
              "social_funding_last_round_stage": "Seed",
              "social_crunchbase_url": "https://www.crunchbase.com/organization/directtips",
              "social_ticker": null,
              "social_specialties": [
                "technology",
                "software",
                "service industry",
                "Hospitality",
                "fintech",
                "tipping",
                "digital tipping",
                "cashless tipping",
                "Beauty Industry",
                "Restaurant tipping",
                "and Fitness Tipping"
              ],
              "social_company_id": 11544088,
              "social_stats": [
                {
                  "followers": 2224,
                  "updated_at": "2024-09-30",
                  "associated_members": 27,
                  "employees_min": 11,
                  "employees_max": 50
                },
                {
                  "followers": 2251,
                  "updated_at": "2025-01-31",
                  "associated_members": 27,
                  "employees_min": 11,
                  "employees_max": 50
                },
                {
                  "followers": 2250,
                  "updated_at": "2025-03-31",
                  "associated_members": 27,
                  "employees_min": 11,
                  "employees_max": 50
                },
                {
                  "followers": 2357,
                  "updated_at": "2025-07-31",
                  "associated_members": 31,
                  "employees_min": 11,
                  "employees_max": 50
                },
                {
                  "followers": 2351,
                  "updated_at": "2025-09-30",
                  "associated_members": 31,
                  "employees_min": 11,
                  "employees_max": 50
                },
                {
                  "followers": 2358,
                  "updated_at": "2025-12-31",
                  "associated_members": 32,
                  "employees_min": 11,
                  "employees_max": 50
                },
                {
                  "followers": 2370,
                  "updated_at": "2026-03-31",
                  "associated_members": 32,
                  "employees_min": 11,
                  "employees_max": 50
                },
                {
                  "followers": 2374,
                  "updated_at": "2026-05-31",
                  "associated_members": 34,
                  "employees_min": 11,
                  "employees_max": 50
                }
              ],
              "social_location_data": [
                {
                  "city": "Oakland Park",
                  "state": "Florida",
                  "country": "United States"
                },
                {
                  "city": "Reading",
                  "state": "Pennsylvania",
                  "country": "United States"
                }
              ],
              "naics6_codes": [
                "522320"
              ],
              "revenue_range": "From $10,000,000 to $49,999,999",
              "revenue_range_data": {
                "revenue_range_low": 10000000,
                "revenue_range_high": 49999999
              },
              "revenue_source": "company_size_based_estimate"
            }
          ],
          "meta": {
            "schema_version": "4.0",
            "record_state": "active"
          }
        }
      },
      "CompanySignalsDataset": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "CompanySignalsDataset",
        "summary": "Signals about company activity derived from PredictLeads datasets.\n",
        "description": "PredictLeads Company Signals surface actionable intelligence about companies by\nanalysing patterns across all PredictLeads datasets.\n<br><br>\nEach signal captures a concrete, time-stamped event, such as a hiring surge in a\nspecific job category or a strategic insight extracted from job descriptions, along\nwith a human-readable headline, an importance score, and the evidence behind the\ndetection.\n",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/x-subSchemas/CompanySignal"
            }
          },
          "meta": {
            "description": "Meta information about `CompanySignalsDataset` object.\n",
            "type": "object",
            "required": [
              "schema_version",
              "record_state"
            ],
            "properties": {
              "schema_version": {
                "title": "Meta.SchemaVersion",
                "description": "Represents schema version of objects.\n",
                "type": "string"
              },
              "record_state": {
                "title": "Meta.RecordState",
                "description": "Represents record state of objects.\n",
                "type": "string",
                "const": "active"
              },
              "count": {
                "description": "Total number of results.\n<br>\n**NOTE**: Only included in API responses when the request parameter `page` is provided,\nfor performance reasons.\n",
                "type": "integer",
                "example": 344
              }
            }
          }
        },
        "example": {
          "data": [
            {
              "id": "019ff376-0929-770a-bef2-fdc11f58d6d0",
              "type": "company_signal",
              "sources": [
                "job_openings"
              ],
              "category": "people",
              "subcategory": "department_hiring_surge",
              "headline": "Hiring surge in Operations",
              "summary": "Hiring surge in Operations, with 11 new openings in the last 30 days against a usual 1.56 a month.",
              "evidence": "11 new openings in the last 30 days vs 1.6 monthly average.",
              "details": {
                "type": "department_hiring_surge_details",
                "openings": 11,
                "department": "Operations",
                "monthly_average": 1.56
              },
              "importance": "high",
              "sentiment": "positive",
              "detected_at": "2026-08-12T00:53:46Z",
              "first_seen_at": null,
              "company": {
                "id": "016325d2-479a-79ba-8bc1-5b45b812daab",
                "type": "company",
                "domain": "mercor.com",
                "name": "Mercor",
                "ticker": null
              },
              "detected_on_job_openings": [],
              "detected_on_sec_filings": []
            },
            {
              "id": "019ff376-0929-7818-9a23-bd3108dc0ca0",
              "type": "company_signal",
              "sources": [
                "job_openings"
              ],
              "category": "people",
              "subcategory": "location_hiring_surge",
              "headline": "Hiring surge in California, United States",
              "summary": "Hiring surge in California, United States, with 29 new openings in the last 30 days against a usual 9.37 a month.",
              "evidence": "29 new openings in the last 30 days vs 9.4 monthly average.",
              "details": {
                "type": "location_hiring_surge_details",
                "state": "California",
                "country": "United States",
                "location": "California, United States",
                "openings": 29,
                "location_raw": "San Francisco",
                "monthly_average": 9.37
              },
              "importance": "medium",
              "sentiment": "positive",
              "detected_at": "2026-08-12T00:53:46Z",
              "first_seen_at": null,
              "company": {
                "id": "016325d2-479a-79ba-8bc1-5b45b812daab",
                "type": "company",
                "domain": "mercor.com",
                "name": "Mercor",
                "ticker": null
              },
              "detected_on_job_openings": [],
              "detected_on_sec_filings": []
            },
            {
              "id": "019ff376-1130-7ab1-b24f-2f06c52841d4",
              "type": "company_signal",
              "sources": [
                "job_openings"
              ],
              "category": "financials",
              "subcategory": "profitability",
              "headline": "Achieved profitability",
              "summary": "The company is currently profitable.",
              "evidence": "\"Mercor is a profitable Series C company valued at $10 billion.\"",
              "details": {
                "type": "company_signal_details"
              },
              "importance": "high",
              "sentiment": "positive",
              "detected_at": "2026-08-12T00:53:48Z",
              "first_seen_at": "2026-07-13T21:36:36Z",
              "company": {
                "id": "016325d2-479a-79ba-8bc1-5b45b812daab",
                "type": "company",
                "domain": "mercor.com",
                "name": "Mercor",
                "ticker": null
              },
              "detected_on_job_openings": [
                {
                  "id": "019f5d71-9251-7569-998b-e056d8ebb116",
                  "type": "job_opening"
                }
              ],
              "detected_on_sec_filings": []
            },
            {
              "id": "019ff376-1130-7b0a-8957-acc8f5d288ac",
              "type": "company_signal",
              "sources": [
                "job_openings"
              ],
              "category": "product",
              "subcategory": "product_launch",
              "headline": "Launched APEX benchmark family",
              "summary": "The company has released its APEX benchmark family to measure AI's real-world impact.",
              "evidence": "\"Mercor's APEX benchmark family measures AI's real-world impact on professional work.\"",
              "details": {
                "type": "company_signal_details",
                "product": "APEX benchmark family"
              },
              "importance": "medium",
              "sentiment": "positive",
              "detected_at": "2026-08-12T00:53:48Z",
              "first_seen_at": "2026-07-27T21:59:55Z",
              "company": {
                "id": "016325d2-479a-79ba-8bc1-5b45b812daab",
                "type": "company",
                "domain": "mercor.com",
                "name": "Mercor",
                "ticker": null
              },
              "detected_on_job_openings": [
                {
                  "id": "019fa597-c6ae-768e-ab61-784e3578b7c0",
                  "type": "job_opening"
                }
              ],
              "detected_on_sec_filings": []
            },
            {
              "id": "01a05d24-aebc-716d-a81c-cc3d452dd9de",
              "type": "company_signal",
              "sources": [
                "job_openings"
              ],
              "category": "other",
              "subcategory": "growth_signal",
              "headline": "Building a Strategic Finance team",
              "summary": "Building a Strategic Finance team to elevate planning, resource allocation, and performance assessment as the company scales.",
              "evidence": "\"As we scale, we’re building out a Strategic Finance team to elevate how we plan, allocate resources, and assess performance across the business.\"",
              "details": {
                "type": "company_signal_details"
              },
              "importance": "medium",
              "sentiment": "positive",
              "detected_at": "2026-09-01T13:24:40Z",
              "first_seen_at": "2026-08-14T00:28:06Z",
              "company": {
                "id": "016325d2-479a-79ba-8bc1-5b45b812daab",
                "type": "company",
                "domain": "mercor.com",
                "name": "Mercor",
                "ticker": null
              },
              "detected_on_job_openings": [
                {
                  "id": "019ffdab-87e6-7769-b10a-04dd2675efaa",
                  "type": "job_opening"
                },
                {
                  "id": "01a0ce94-cf04-7fdf-abc1-80668d42fd9f",
                  "type": "job_opening"
                }
              ],
              "detected_on_sec_filings": []
            }
          ],
          "meta": {
            "schema_version": "4.2",
            "record_state": "active"
          }
        }
      },
      "CompanySignalsDeletedDataset": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "CompanySignalsDeletedDataset",
        "description": "Deleted (disapproved) Company Signals.\n",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/x-subSchemas/CompanySignalDeleted"
            }
          },
          "meta": {
            "description": "Meta information about `CompanySignalsDeletedDataset` object.\n",
            "type": "object",
            "required": [
              "schema_version",
              "record_state"
            ],
            "properties": {
              "schema_version": {
                "title": "Meta.SchemaVersion",
                "description": "Represents schema version of objects.\n",
                "type": "string"
              },
              "record_state": {
                "title": "Meta.RecordState",
                "description": "Represents record state of objects.\n",
                "type": "string",
                "const": "deleted"
              },
              "count": {
                "description": "Total number of results.\n<br>\n**NOTE**: Only included in API responses when the request parameter `page` is provided,\nfor performance reasons.\n",
                "type": "integer",
                "example": 344
              }
            }
          }
        },
        "example": {
          "data": [
            {
              "id": "01a1b222-8f32-7094-b425-b9776092ce17",
              "type": "company_signal"
            },
            {
              "id": "01a1b222-98e3-74b4-87e5-05d84927c4f4",
              "type": "company_signal"
            },
            {
              "id": "01a1b222-b8d3-76cd-bcb5-4562d9fd3b16",
              "type": "company_signal"
            },
            {
              "id": "01a1b222-c998-7ac4-92e1-e5e72fefa657",
              "type": "company_signal"
            },
            {
              "id": "01a1b222-dc99-7bff-a27e-c6d753f79749",
              "type": "company_signal"
            }
          ],
          "meta": {
            "schema_version": "4.0",
            "record_state": "deleted"
          }
        }
      },
      "WebsiteChangesDataset": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "WebsiteChangesDataset",
        "summary": "Information about meaningful changes detected on a company's website over time.\n",
        "description": "PredictLeads tracks how company websites change by comparing subpage content snapshots over time.\nThe Website Changes dataset exposes detected changes, including the raw markdown\ndifference and a structured AI rationale explaining the operational or commercial significance of each change.\n",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/x-subSchemas/WebsiteChange"
            }
          },
          "meta": {
            "description": "Meta information about `WebsiteChangesDataset` object.\n",
            "type": "object",
            "required": [
              "schema_version",
              "record_state"
            ],
            "properties": {
              "schema_version": {
                "title": "Meta.SchemaVersion",
                "description": "Represents schema version of objects.\n",
                "type": "string"
              },
              "record_state": {
                "title": "Meta.RecordState",
                "description": "Represents record state of objects.\n",
                "type": "string",
                "const": "active"
              },
              "count": {
                "description": "Total number of results.\n<br>\n**NOTE**: Only included in API responses when the request parameter `page` is provided,\nfor performance reasons.\n",
                "type": "integer",
                "example": 344
              }
            }
          }
        },
        "example": {
          "data": [
            {
              "id": "01a1b227-8ab6-7808-9e20-a6a00c9394dd",
              "type": "website_change",
              "markdown_difference": "--- old\n+++ new\n@@ -2,7 +2,13 @@\n The Finnish Dutch Chamber of Commerce is a unique non-profit organization for Finnish-Dutch relations with business content.\n Learn More\n UPCOMING EVENTS\n-There are no upcoming events at this time\n+[11\n+December\n+2026](https://fdcc.eu/event/fdcc-independence-day-dinner-2026/)\n+FDCC Independence Day Dinner 2026\n+18:00 - 22:00\n+The FDCC Independence Day Dinner 2026 11 December 2026 | 18:00–22:00 The College Hotel in Amsterdam (Roelof Hartstraat 1, 1071 VE Amsterdam)  Business Casual  The Finnish-Dutch Chamber of Commerce is pleased to invite our members to a special evening celebrating Finnish Independence Day. On Friday, 11 December 2026, we will gather at the elegant [...]\n+Find out more\n OUR PATRON MEMBERS\n \")\")\n \")\")",
              "company": {
                "id": "016325cd-8c8b-7870-a38a-3dd1ce71e484",
                "type": "company",
                "domain": "fdcc.eu",
                "name": "Finnish Dutch Chamber of Commerce",
                "ticker": null
              },
              "events": [
                {
                  "id": "01a1b229-4846-7712-aec1-8f8cbdf239ec",
                  "category": "attends_event",
                  "headline": "Hosts Independence Day Dinner 2026",
                  "summary": "Announced the FDCC Independence Day Dinner 2026, to be held 11 December 2026 at The College Hotel in Amsterdam.",
                  "added_evidence": "FDCC Independence Day Dinner 2026 The FDCC Independence Day Dinner 2026 11 December 2026 | 18:00–22:00 The College Hotel in Amsterdam (Roelof Hartstraat 1, 1071 VE Amsterdam)  Business Casual  The Finnish-Dutch Chamber of Commerce is pleased to invite our members to a special evening celebrating Finnish Independence Day. On Friday, 11 December 2026, we will gather at the elegant [...]",
                  "removed_evidence": null,
                  "evidence_type": "added_text",
                  "importance": 2
                }
              ],
              "detected_at": "2026-11-06T18:38:18Z",
              "first_seen_at": "2026-11-06T01:22:10Z"
            },
            {
              "id": "01a1b223-1047-7195-8c0a-c820342aa8db",
              "type": "website_change",
              "markdown_difference": "--- old\n+++ new\n@@ -1,7 +1,7 @@\n We present\n our news\n-Flying Tiger Copenhagen leases nearly 300 m2 in the Mall of Berlin. Learn more ...\n-dsb Deutsche Sanierungsberatung GmbH leases office space for its new corporate headquarters at Schultheiss Quartier. Learn more ...\n+New Yorker on 3 floors and 3000 m2 at the Mall of Berlin starting September 2026.\n+Activate – an interactive gaming experience at the Mall of Berlin. Learn more ...\n We love\n to develop properties\n The Name **HGHI** has always stood for professional management of large commercial properties, efficient management at the highest level, and the planning, design and realization of great visions.\n@@ -10,11 +10,13 @@\n responsible planning of projects for the environment and the social community.\n The tenants as well as the social environment will benefit from the responsible development of the newly built living and working spaces.\n Projects\n-### Potsdamer Straße 163/165\n-Learn more\n ### Mall of Berlin\n Learn more\n ### Schultheiss Quartier\n+Learn more\n+### Tegel Quartier\n+Learn more\n+### Sankt Annen Galerie\n Learn more\n We create\n sustainable added value through the development of real estate projects",
              "company": {
                "id": "016325c5-03ff-78a6-96dc-116911e36789",
                "type": "company",
                "domain": "hghi.de",
                "name": "HGHI Holding",
                "ticker": null
              },
              "events": [
                {
                  "id": "01a1b22a-2867-7c4a-807d-2a6a486ec305",
                  "category": "customer_identified",
                  "headline": "Signs New Yorker for Mall of Berlin",
                  "summary": "Signed New Yorker to a 3,000 sq m store across three floors at Mall of Berlin starting September 2026.",
                  "added_evidence": "New Yorker on 3 floors and 3000 m2 at the Mall of Berlin starting September 2026.",
                  "removed_evidence": null,
                  "evidence_type": "added_text",
                  "importance": 2
                }
              ],
              "detected_at": "2026-11-06T18:33:24Z",
              "first_seen_at": "2026-11-05T12:59:59Z"
            },
            {
              "id": "01a1b21e-83f2-7b17-b681-aa2f68c73eb0",
              "type": "website_change",
              "markdown_difference": "--- old\n+++ new\n@@ -41,6 +41,10 @@\n News\n See all news\n [\n+18 October 2026\n+### Euca wins Boutique Development Award\n+Read More](https://centina.com.au/2026/10/euca-wins-2026-udia-sa-boutique-development-award/)\n+[\n 23 June 2026\n ### 10 Year Commendation\n Read More](https://centina.com.au/2026/06/10yr-commendation/)\n@@ -48,9 +52,5 @@\n 15 June 2026\n ### Building Women Tour\n Read More](https://centina.com.au/2026/06/building-women-tour/)\n-[\n-20 May 2026\n-### Churchill Welcomes New Entertainment Hub\n-Read More](https://centina.com.au/2026/05/churchill-welcomes-new-entertainment-hub/)\n Our Partners\n Sign up to receive the latest news",
              "company": {
                "id": "016325b9-0272-7db8-a008-152bb61d7f3a",
                "type": "company",
                "domain": "centina.com.au",
                "name": "Centina",
                "ticker": null
              },
              "events": [
                {
                  "id": "01a1b220-41ba-79b8-9ba9-3d791cc98fd7",
                  "category": "recognition",
                  "headline": "Euca wins Boutique Development Award",
                  "summary": "Won the Boutique Development Award for Euca.",
                  "added_evidence": "### Euca wins Boutique Development Award",
                  "removed_evidence": null,
                  "evidence_type": "added_text",
                  "importance": 2
                }
              ],
              "detected_at": "2026-11-06T18:28:26Z",
              "first_seen_at": "2026-11-05T16:12:55Z"
            },
            {
              "id": "01a1b21e-83ec-7c99-ab00-69e75a1e0e14",
              "type": "website_change",
              "markdown_difference": "--- old\n+++ new\n@@ -1,3 +1,4 @@\n+\")\n Creating new tradition - new AW26 collection\n Andersen Furniture welcomes you into a universe where the new meets the classic, and where every detail tells its own story. In our Autumn Winter 2026 collection, we explore materials in new ways – wood, metal, and stone come together in beautiful objects, where craftsmanship meets contemporary design.\n Each piece celebrates the unique and the personal. No detail is identical, as we believe it is in diversity that a home finds its character. The collection embraces variety and creates space for everyone – regardless of style, needs, or taste.\n@@ -26,6 +27,7 @@\n Each piece is carefully designed to balance aesthetics, comfort, and functionality — contributing to spaces that feel welcoming, purposeful, and timeless.\n Rooted in the moments where people gather, exchange ideas, and create connections, the collection celebrates the interaction between materials, forms, and people. The collection reflects a shared vision of creating furniture that naturally brings people together and strengthens the feeling of connection and belonging.\n Soft seating collection\n+\")\n Professionals\n We have gathered all our contract and professionals furniture and design interior to make it as easy for you as possible.\n Explore the univers here.\n@@ -34,7 +36,7 @@\n [\n ### Aw26 Collection - Creating new traditions\n AW26 collection](https://andersen-furniture.com/aw26-collection/)\n-[\n+[\")\n ### Gentle geometry - shelf collection\n Shelf collection – Gentle Geometry](https://andersen-furniture.com/shelf-collection-gentle-geometry/)\n [",
              "company": {
                "id": "016325b7-1fef-70ff-bf0c-e48b81848d92",
                "type": "company",
                "domain": "andersen-furniture.com",
                "name": "Andersen Furniture A/S",
                "ticker": null
              },
              "events": [
                {
                  "id": "01a1b220-41bb-7914-96eb-13db559fcbad",
                  "category": "product_launch",
                  "headline": "Launches AW26 collection",
                  "summary": "Launched the Autumn Winter 2026 collection, featuring new furniture and soft seating pieces.",
                  "added_evidence": "\")",
                  "removed_evidence": null,
                  "evidence_type": "added_text",
                  "importance": 3
                }
              ],
              "detected_at": "2026-11-06T18:28:26Z",
              "first_seen_at": "2026-11-05T15:01:50Z"
            },
            {
              "id": "01a1b216-fca8-7ced-a869-b669442c9d13",
              "type": "website_change",
              "markdown_difference": "--- old\n+++ new\n@@ -11,16 +11,18 @@\n Lernen Sie die Vorzüge kennen, die Ihnen die GovConnect als Arbeitgeber bietet. Eine individuelle Förderung, Work-Life-Balance und Gesundheitsmaßnahmen sind nur einige davon.\n Neuigkeiten\n Erfahren Sie mehr über unsere aktuellen Meldungen rund um effiziente Lösungen für Verwaltungen.\n-[ bei Stadt | Land | Bytes 2026\")\n-12.10.2026\n-Stadt | Land | Bytes 2026 - Weil Digitalisierung nur gemeinsam vorangetrieben werden kann ...\n-Das Veranstaltungsteam von Stadt | Land | Bytes lud vom 08. bis 09. Oktober 2026 in das Seminaris Hotel in Lüneburg ein. Neben der niedersächsischen Digitalisierungsstaatssekretärin Anke Pörksen und verschiedenen Speakern waren rund 200 Teilnehmer:innen vor Ort, um sich dringenden Digitalisierungsthemen zu widmen.Mehr\n-[, Patricia Pichottki (Geschäftsführung GovConnect), Martin Kuban (Geschäftsführung ekom21))\")\n-05.10.2026\n-ekom21 und GovConnect: Partner bündeln Kräfte für digitale Ordnungswidrigkeitenverfahren\n-Die kommunalen IT-Dienstleister wissen, dass die Zukunft einer modernen Verwaltung und damit die dringend notwendige Modernisierung staatlicher und kommunaler Prozesse auch in ihrer Verantwortung liegt. Vor diesem Hintergrund streben die IT-Unternehmen ekom21 und GovConnect eine strategische Kooperation im Bereich Ordnungswidrigkeiten Software an.Mehr\n+[\n+28.10.2026\n+Webcast Hund und Halter: pmHundemarke, der digitale Begleiter mit WAU-Faktor am 25.11.2026\n+Die GovConnect lädt Sie herzlich dazu ein, mitzuerleben, wie Sie die pmHundemarke in Ihrer Verwaltung einsetzen können und wie diese im Live-Betrieb genutzt werden kann.Mehr\n+[\n+27.10.2026\n+Land, kommunale Spitzenverbände, Polizei und GovConnect führen elektronischen Datenermittlungsbeleg (eDEB) in Niedersachsen erfolgreich ein\n+Die Polizei Niedersachsen setzt künftig verstärkt auf digitale Verfahren bei der Erfassung von Verkehrsordnungswidrigkeiten: Mit dem elektronischen Datenerermittlungsbeleg (eDEB) können Verstöße ab sofort direkt vor Ort per App aufgenommen und medienbruchfrei an die zuständigen kommunalen Bußgeldstellen übermittelt werden. Der bislang genutzte Papierabreißblock wird damit durch eine moderne elektronische Lösung ersetzt.Mehr\n Alle unsere Neuigkeiten\n Veranstaltungen\n+25.11.2026 10:00 bis 10:30 Uhr\n+Webcast Hund und Halter: pmHundemarke, der digitale Begleiter mit WAU-Faktor am 25.11.2026\n 01.12.2026\n Infotag E-Government und Digitalisierung\n Alle Veranstaltungen",
              "company": {
                "id": "016320ca-3f07-7c45-ae54-b1194ed7a4d3",
                "type": "company",
                "domain": "govconnect.de",
                "name": "GovConnect GmbH",
                "ticker": null
              },
              "events": [
                {
                  "id": "01a1b21b-863f-7a55-9336-f8c9beb738c9",
                  "category": "attends_event",
                  "headline": "Hosts webcast on pmHundemarke on 25 November 2026",
                  "summary": "Hosts a webcast on pmHundemarke, the digital companion, on 25 November 2026.",
                  "added_evidence": "Webcast Hund und Halter: pmHundemarke, der digitale Begleiter mit WAU-Faktor am 25.11.2026 Die GovConnect lädt Sie herzlich dazu ein, mitzuerleben, wie Sie die pmHundemarke in Ihrer Verwaltung einsetzen können und wie diese im Live-Betrieb genutzt werden kann.Mehr",
                  "removed_evidence": null,
                  "evidence_type": "added_text",
                  "importance": 1
                }
              ],
              "detected_at": "2026-11-06T18:20:13Z",
              "first_seen_at": "2026-11-06T03:53:13Z"
            }
          ],
          "meta": {
            "schema_version": "4.4",
            "record_state": "active"
          }
        }
      },
      "SubpagesDataset": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "SubpagesDataset",
        "summary": "Information on how websites are structured, what kind of subpages they have, categories of subpages\n(e.g. blog, careers, about, terms...) and **cleaned text content** from these subpages in markdown format.\n",
        "description": "Since 2021, PredictLeads has detected some\n709 million subpages on about\n82 million websites, with the goal\nto track how their websites are evolving through time.\n<br><br>\nThe Subpages dataset tracks when subpages such as \"about us\", \"blog\", \"careers\", \"api docs\",\n\"customer support\" etc. are added over time.\n",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/x-subSchemas/Subpage"
            }
          },
          "meta": {
            "description": "Meta information about `SubpagesDataset` object.\n",
            "type": "object",
            "required": [
              "schema_version",
              "record_state"
            ],
            "properties": {
              "schema_version": {
                "title": "Meta.SchemaVersion",
                "description": "Represents schema version of objects.\n",
                "type": "string"
              },
              "record_state": {
                "title": "Meta.RecordState",
                "description": "Represents record state of objects.\n",
                "type": "string",
                "const": "active"
              },
              "count": {
                "description": "Total number of results.\n<br>\n**NOTE**: Only included in API responses when the request parameter `page` is provided,\nfor performance reasons.\n",
                "type": "integer",
                "example": 344
              }
            }
          }
        },
        "example": {
          "data": [
            {
              "id": "0157e938-573d-777e-8813-bd7ed4ec1daf",
              "type": "subpage",
              "category": "about",
              "url": "https://groupawheels.com/about-us",
              "text_content": "About Us\n========\n\n[Home](https://groupawheels.com/)About Us\n\n[Group-A Wheels](https://groupawheels.com/)\n\nwho we *are*\n------------\n\nLocated in Lindenhurst, Long Island New York, Group-A / Autotrend is one the nation’s largest tire and wheel warehouse’s, open direct to the public. Most importantly, we are a group of enthusiasts, and we LOVE what we do!\n\nUnlike chain stores, and websites where every item is just a SKU, we pride ourselves in our depth of product and fitment knowledge. Our staff of veterans actually IS the best in the business. You will see.\n\n**In The Warehouse**\n\nOur warehouse has a large selection of tires and wheels to fit your needs AND your desires. Whether it is your car, truck, or SUV/CUV, our warehouse has the best selection of the industry’s top-quality wheel and tire brands to choose from.\n\nFounded in 1983, we have a full staff of veterans in the wheel & tire industry.\n\nPlease feel free to [call one of our tech representatives](tel:(631)%20957-3901) at any time regarding fitments for our wheels and tires regarding your car. Or better yet, if you live within the area, feel free to visit us.\n\nOur warehouse has a showroom which is open to the public, and we also have an installation center on site for our local customers.\n\n**Product Shipping**\n\nIf you do not live in the area, fear not. Our shipping department is shipping all of our products to our customers all day long from our other regional warehouses. We also provide same day shipping on all in-stock products, so our customers will receive their products as quickly as possible.\n\n**Tire & Wheel Packages**\n\nTo match your wheels, we also have a complete lineup of Tire & Wheel Packages specific for your car. Tire & Wheel Packages come mounted and dual-plane high-speed balanced on the latest mounting and balancing machines. Packages ready to be installed in the comfort of your own garage.\n\n**Your One Stop Shop**\n\nAt Group A Autotrend, we aim to become your one-stop-shop for all your premium wheel, tire, and suspension component needs. Our goal is to make the tire buying process simple, straightforward and convenient.\n\n**International Recognition**\n\nThe European market recognizes us for our specialty in Porsche, BMW, Mercedes, and Ferrari, while our unique fitments for Acura NSX, Subaru WRX, and Toyota Supra have given us notoriety in the Japanese market as well.\n\n**Complete your car with high performance suspension components**\n\nGroup A Autotrend can also complete your car’s performance with suspension components from Eibach Springs and Tokico Shocks. Please feel free to browse our extensive inventory of wheels, tires and suspension components by brand, type or vehicle make. Can’t find what you’re looking for? Pick up the phone and call one of our friendly, experienced tech representatives. We’re here to help!\n\nQuestions?\n\nIf you have any questions, or do not see something that you are looking for, please feel free to email or even call us. We would love to hear from you.\n\nCall our customer service line: 1-800-WHEEL99\n\n##### Subscribe for News and Get a Discount\n\nLoading...",
              "first_seen_at": "2016-10-21T21:49:26Z",
              "last_seen_at": "2025-07-25T13:55:15Z",
              "last_extraction_states": [
                {
                  "status": "live",
                  "status_code": 200,
                  "processed_at": "2026-08-16T02:29:19.788165+02:00"
                }
              ],
              "company": {
                "id": "01528600-957b-760c-a127-c8b2c590bfc5",
                "type": "company",
                "domain": "groupawheels.com",
                "name": "GroupAWheels",
                "ticker": null
              }
            }
          ],
          "meta": {
            "schema_version": "4.0",
            "record_state": "active"
          }
        }
      },
      "SECFinancialsDataset": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "SECFinancialsDataset",
        "summary": "The income statement a public company reported on each of its periodic SEC filings.\n",
        "description": "One record per annual (`10-K`, `20-F`, `40-F`) or quarterly (`10-Q`) SEC filing, with the figures\nfor the period it reports on. The same filing is served as a document by the\n<a href=\"https://docs.predictleads.com/guide/sec_filings_dataset\">SEC Filings</a>\ndataset, under the same `id`.\n",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/x-subSchemas/SECFinancial"
            }
          },
          "meta": {
            "description": "Meta information about `SECFinancialsDataset` object.\n",
            "type": "object",
            "required": [
              "schema_version",
              "record_state"
            ],
            "properties": {
              "schema_version": {
                "title": "Meta.SchemaVersion",
                "description": "Represents schema version of objects.\n",
                "type": "string"
              },
              "record_state": {
                "title": "Meta.RecordState",
                "description": "Represents record state of objects.\n",
                "type": "string",
                "const": "active"
              },
              "count": {
                "description": "Total number of results.\n<br>\n**NOTE**: Only included in API responses when the request parameter `page` is provided,\nfor performance reasons.\n",
                "type": "integer",
                "example": 344
              }
            }
          }
        },
        "example": {
          "data": [
            {
              "id": "019d979d-32e5-7697-b63c-7b3832a364cf",
              "type": "sec_financial",
              "form_type": "10-K",
              "filed_at": "2025-07-30",
              "report_date": "2025-06-30",
              "source_url": "https://www.sec.gov/Archives/edgar/data/789019/000095017025100235/msft-20250630.htm",
              "company": {
                "id": "01535453-2122-71a8-997d-04d3e7cc76ed",
                "type": "company",
                "domain": "microsoft.com",
                "name": "Microsoft Corp.",
                "ticker": "NASDAQ:MSFT"
              },
              "income_statement": {
                "period_type": "annual",
                "period_start_date": "2024-07-01",
                "period_end_date": "2025-06-30",
                "revenue": 281724000000.0,
                "cost_of_revenue": 87831000000.0,
                "gross_profit": 193893000000.0,
                "operating_income": 128528000000.0,
                "net_income": 101832000000.0
              }
            }
          ],
          "meta": {
            "schema_version": "4.0",
            "record_state": "active"
          }
        }
      },
      "ApiRequestLogs": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "ApiRequestLogs",
        "description": "Provides a paginated list of API request log entries made by the current subscription.\n",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/x-subSchemas/ApiRequestLog"
            }
          },
          "meta": {
            "description": "Meta information about `ApiRequestLogs` object.\n",
            "type": "object",
            "required": [
              "schema_version",
              "record_state"
            ],
            "properties": {
              "schema_version": {
                "title": "Meta.SchemaVersion",
                "description": "Represents schema version of objects.\n",
                "type": "string"
              },
              "record_state": {
                "title": "Meta.RecordState",
                "description": "Represents record state of objects.\n",
                "type": "string",
                "const": "active"
              },
              "count": {
                "description": "Total number of results.\n<br>\n**NOTE**: Only included in API responses when the request parameter `page` is provided,\nfor performance reasons.\n",
                "type": "integer",
                "example": 344
              }
            }
          }
        },
        "example": {
          "data": [
            {
              "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
              "type": "api_request_log",
              "requested_at": "2024-09-25T16:09:53Z",
              "request_params": {
                "id_or_domain": "stripe.com"
              },
              "request_path": "/api/v4/companies/stripe.com",
              "response_code": 200,
              "credits_used": 1,
              "duration": 45.2
            }
          ],
          "meta": {
            "schema_version": "4.0",
            "record_state": "active",
            "count": 1
          }
        }
      }
    },
    "x-subSchemas": {
      "Company": {
        "title": "Company",
        "description": "The `Company` object.",
        "type": "object",
        "required": [
          "id",
          "type",
          "domain",
          "name",
          "ticker",
          "friendly_name",
          "meta_title",
          "meta_description",
          "description",
          "description_short",
          "language",
          "location",
          "location_data",
          "last_extraction_states",
          "redirects_to_company",
          "redirects_to_company_reason",
          "parent_company",
          "subsidiary_companies",
          "similar_companies"
        ],
        "properties": {
          "id": {
            "description": "ID of the `Company` object.",
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "description": "The type of this object.",
            "const": "company"
          },
          "domain": {
            "description": "Company domain name.",
            "type": "string"
          },
          "name": {
            "description": "Company name if available.",
            "type": [
              "string",
              "null"
            ]
          },
          "ticker": {
            "description": "Company stock symbol (ticker) if available.",
            "type": [
              "string",
              "null"
            ]
          },
          "friendly_name": {
            "description": "Company friendly name.",
            "type": [
              "string",
              "null"
            ]
          },
          "meta_title": {
            "description": "Company website's meta title.",
            "type": [
              "string",
              "null"
            ]
          },
          "meta_description": {
            "description": "Company website's meta description.",
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "description": "Translated and summarized description.",
            "type": [
              "string",
              "null"
            ]
          },
          "description_short": {
            "description": "Short version of the translated and summarized description.",
            "type": [
              "string",
              "null"
            ]
          },
          "language": {
            "description": "`Company` website's language.",
            "type": [
              "string",
              "null"
            ]
          },
          "location": {
            "description": "`Company` location.\n<br>\n**NOTE**: It is built from the `location_data` attributes if present.\n",
            "example": "Menlo Park, California, 94025, United States, Northern America, Americas",
            "type": [
              "string",
              "null"
            ]
          },
          "location_data": {
            "description": "**NOTE**: Currently contains at most one object.",
            "type": "array",
            "items": {
              "title": "CompanyLocationData",
              "description": "The `CompanyLocationData` object.",
              "example": {
                "id": "0196e906-3aab-716c-b14b-9cc5f2778291",
                "type": "company_location_data",
                "location": "4145 SW Watson Ave, Beaverton, Oregon 97005, United States",
                "zip_code": "97005",
                "street_address": "4145 SW Watson Ave",
                "city": "Beaverton",
                "county": "Washington County",
                "admin_area": "Oregon",
                "state": "Oregon",
                "country": "United States",
                "continent": "North America",
                "latitude": 45.489652,
                "longitude": -122.806691,
                "fuzzy_match": false,
                "category": "headquarters"
              },
              "type": "object",
              "required": [
                "id",
                "type",
                "location",
                "zip_code",
                "street_address",
                "city",
                "county",
                "admin_area",
                "state",
                "country",
                "continent",
                "latitude",
                "longitude",
                "fuzzy_match",
                "category"
              ],
              "properties": {
                "id": {
                  "description": "ID of the `CompanyLocationData` object.",
                  "type": "string",
                  "format": "uuid"
                },
                "type": {
                  "description": "Type of the `CompanyLocationData` object.",
                  "const": "company_location_data"
                },
                "location": {
                  "description": "Location as a string.",
                  "example": "4145 SW Watson Ave, Beaverton, Oregon 97005, United States",
                  "type": "string"
                },
                "zip_code": {
                  "description": "ZIP code of the location.",
                  "example": "97005",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "street_address": {
                  "description": "Street address of the location.",
                  "example": "4145 SW Watson Ave",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "city": {
                  "description": "City of the location.",
                  "example": "Beaverton",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "county": {
                  "description": "County of the location.",
                  "example": "Washington County",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "admin_area": {
                  "description": "Administrative area of the location.",
                  "example": "Oregon",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "state": {
                  "description": "State of the location.",
                  "example": "Oregon",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "country": {
                  "description": "Country of the location.",
                  "example": "United States",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "continent": {
                  "description": "Continent of the location.",
                  "example": "North America",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "latitude": {
                  "description": "Latitude coordinate of the location.",
                  "example": 45.489652,
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "longitude": {
                  "description": "Longitude coordinate of the location.",
                  "example": -122.806691,
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "fuzzy_match": {
                  "description": "`true` indicates that location data may not have been extracted accurately.\n<br>\n`false` indicates that location data has been extracted correctly.\n",
                  "type": "boolean",
                  "example": false
                },
                "category": {
                  "description": "Location category.",
                  "example": "headquarters",
                  "type": "string",
                  "enum": [
                    "headquarters",
                    "office",
                    "retail",
                    "facility",
                    "service_area",
                    "registered_address",
                    "unknown"
                  ]
                }
              }
            }
          },
          "last_extraction_states": {
            "description": "Extraction states of the company website's main subpage.",
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "status",
                "status_code",
                "processed_at"
              ],
              "properties": {
                "status": {
                  "description": "Extraction status.",
                  "type": "string"
                },
                "status_code": {
                  "description": "HTTP response status code.",
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "processed_at": {
                  "description": "Date & time (ISO 8601) of when the `Company` was last processed.",
                  "type": "string",
                  "format": "date-time",
                  "example": "2024-09-25T16:09:53Z"
                }
              }
            }
          },
          "redirects_to_company": {
            "title": "Company",
            "description": "The company this company's domain redirects to.",
            "type": [
              "object",
              "null"
            ],
            "required": [
              "id",
              "type",
              "domain",
              "name",
              "ticker"
            ],
            "properties": {
              "id": {
                "description": "ID of the `Company` object.",
                "type": "string",
                "format": "uuid"
              },
              "type": {
                "description": "The type of this object.",
                "const": "company"
              },
              "domain": {
                "description": "Company domain name.",
                "type": "string"
              },
              "name": {
                "description": "Company name if available.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "ticker": {
                "description": "Company stock symbol (ticker) if available.",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "redirects_to_company_reason": {
            "description": "Reason of the redirect.",
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "acquisition_merger",
              "locality",
              "rebranding",
              null
            ]
          },
          "parent_company": {
            "title": "Company",
            "description": "The company's parent company.",
            "type": [
              "object",
              "null"
            ],
            "required": [
              "id",
              "type",
              "domain",
              "name",
              "ticker"
            ],
            "properties": {
              "id": {
                "description": "ID of the `Company` object.",
                "type": "string",
                "format": "uuid"
              },
              "type": {
                "description": "The type of this object.",
                "const": "company"
              },
              "domain": {
                "description": "Company domain name.",
                "type": "string"
              },
              "name": {
                "description": "Company name if available.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "ticker": {
                "description": "Company stock symbol (ticker) if available.",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "subsidiary_companies": {
            "description": "The company's subsidiary companies.",
            "type": "array",
            "items": {
              "title": "Company",
              "description": "A subsidiary company of this company.",
              "type": "object",
              "required": [
                "id",
                "type",
                "domain",
                "name",
                "ticker"
              ],
              "properties": {
                "id": {
                  "description": "ID of the `Company` object.",
                  "type": "string",
                  "format": "uuid"
                },
                "type": {
                  "description": "The type of this object.",
                  "const": "company"
                },
                "domain": {
                  "description": "Company domain name.",
                  "type": "string"
                },
                "name": {
                  "description": "Company name if available.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "ticker": {
                  "description": "Company stock symbol (ticker) if available.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "similar_companies": {
            "description": "Companies similar to this company. Up to 5 are returned.",
            "type": "array",
            "items": {
              "title": "Company",
              "description": "A company similar to this company.",
              "type": "object",
              "required": [
                "id",
                "type",
                "domain",
                "name",
                "ticker"
              ],
              "properties": {
                "id": {
                  "description": "ID of the `Company` object.",
                  "type": "string",
                  "format": "uuid"
                },
                "type": {
                  "description": "The type of this object.",
                  "const": "company"
                },
                "domain": {
                  "description": "Company domain name.",
                  "type": "string"
                },
                "name": {
                  "description": "Company name if available.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "ticker": {
                  "description": "Company stock symbol (ticker) if available.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          }
        }
      },
      "ExtendedCompany": {
        "title": "ExtendedCompany",
        "description": "The `ExtendedCompany` object.",
        "type": "object",
        "required": [
          "id",
          "type",
          "domain",
          "name",
          "ticker",
          "friendly_name",
          "meta_title",
          "meta_description",
          "description",
          "description_short",
          "language",
          "location",
          "location_data",
          "last_extraction_states",
          "redirects_to_company",
          "redirects_to_company_reason",
          "parent_company",
          "subsidiary_companies",
          "similar_companies",
          "employees_min",
          "employees_max",
          "social_associated_members",
          "social_logo",
          "social_slogan",
          "social_description",
          "social_url",
          "social_industry",
          "social_company_type",
          "social_headquarters",
          "social_founded",
          "social_funding_price",
          "social_funding_last_round_date",
          "social_funding_last_round_stage",
          "social_crunchbase_url",
          "social_ticker",
          "social_specialties",
          "social_company_id",
          "social_stats",
          "social_location_data",
          "naics6_codes",
          "revenue_range",
          "revenue_range_data",
          "revenue_source"
        ],
        "properties": {
          "id": {
            "description": "ID of the `Company` object.",
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "description": "The type of this object.",
            "const": "company"
          },
          "domain": {
            "description": "Company domain name.",
            "type": "string"
          },
          "name": {
            "description": "Company name if available.",
            "type": [
              "string",
              "null"
            ]
          },
          "ticker": {
            "description": "Company stock symbol (ticker) if available.",
            "type": [
              "string",
              "null"
            ]
          },
          "friendly_name": {
            "description": "Company friendly name.",
            "type": [
              "string",
              "null"
            ]
          },
          "meta_title": {
            "description": "Company website's meta title.",
            "type": [
              "string",
              "null"
            ]
          },
          "meta_description": {
            "description": "Company website's meta description.",
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "description": "Translated and summarized description.",
            "type": [
              "string",
              "null"
            ]
          },
          "description_short": {
            "description": "Short version of the translated and summarized description.",
            "type": [
              "string",
              "null"
            ]
          },
          "language": {
            "description": "`Company` website's language.",
            "type": [
              "string",
              "null"
            ]
          },
          "location": {
            "description": "`Company` location.\n<br>\n**NOTE**: It is built from the `location_data` attributes if present.\n",
            "example": "Menlo Park, California, 94025, United States, Northern America, Americas",
            "type": [
              "string",
              "null"
            ]
          },
          "location_data": {
            "description": "**NOTE**: Currently contains at most one object.",
            "type": "array",
            "items": {
              "title": "CompanyLocationData",
              "description": "The `CompanyLocationData` object.",
              "example": {
                "id": "0196e906-3aab-716c-b14b-9cc5f2778291",
                "type": "company_location_data",
                "location": "4145 SW Watson Ave, Beaverton, Oregon 97005, United States",
                "zip_code": "97005",
                "street_address": "4145 SW Watson Ave",
                "city": "Beaverton",
                "county": "Washington County",
                "admin_area": "Oregon",
                "state": "Oregon",
                "country": "United States",
                "continent": "North America",
                "latitude": 45.489652,
                "longitude": -122.806691,
                "fuzzy_match": false,
                "category": "headquarters"
              },
              "type": "object",
              "required": [
                "id",
                "type",
                "location",
                "zip_code",
                "street_address",
                "city",
                "county",
                "admin_area",
                "state",
                "country",
                "continent",
                "latitude",
                "longitude",
                "fuzzy_match",
                "category"
              ],
              "properties": {
                "id": {
                  "description": "ID of the `CompanyLocationData` object.",
                  "type": "string",
                  "format": "uuid"
                },
                "type": {
                  "description": "Type of the `CompanyLocationData` object.",
                  "const": "company_location_data"
                },
                "location": {
                  "description": "Location as a string.",
                  "example": "4145 SW Watson Ave, Beaverton, Oregon 97005, United States",
                  "type": "string"
                },
                "zip_code": {
                  "description": "ZIP code of the location.",
                  "example": "97005",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "street_address": {
                  "description": "Street address of the location.",
                  "example": "4145 SW Watson Ave",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "city": {
                  "description": "City of the location.",
                  "example": "Beaverton",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "county": {
                  "description": "County of the location.",
                  "example": "Washington County",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "admin_area": {
                  "description": "Administrative area of the location.",
                  "example": "Oregon",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "state": {
                  "description": "State of the location.",
                  "example": "Oregon",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "country": {
                  "description": "Country of the location.",
                  "example": "United States",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "continent": {
                  "description": "Continent of the location.",
                  "example": "North America",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "latitude": {
                  "description": "Latitude coordinate of the location.",
                  "example": 45.489652,
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "longitude": {
                  "description": "Longitude coordinate of the location.",
                  "example": -122.806691,
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "fuzzy_match": {
                  "description": "`true` indicates that location data may not have been extracted accurately.\n<br>\n`false` indicates that location data has been extracted correctly.\n",
                  "type": "boolean",
                  "example": false
                },
                "category": {
                  "description": "Location category.",
                  "example": "headquarters",
                  "type": "string",
                  "enum": [
                    "headquarters",
                    "office",
                    "retail",
                    "facility",
                    "service_area",
                    "registered_address",
                    "unknown"
                  ]
                }
              }
            }
          },
          "last_extraction_states": {
            "description": "Extraction states of the company website's main subpage.",
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "status",
                "status_code",
                "processed_at"
              ],
              "properties": {
                "status": {
                  "description": "Extraction status.",
                  "type": "string"
                },
                "status_code": {
                  "description": "HTTP response status code.",
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "processed_at": {
                  "description": "Date & time (ISO 8601) of when the `Company` was last processed.",
                  "type": "string",
                  "format": "date-time",
                  "example": "2024-09-25T16:09:53Z"
                }
              }
            }
          },
          "redirects_to_company": {
            "title": "Company",
            "description": "The company this company's domain redirects to.",
            "type": [
              "object",
              "null"
            ],
            "required": [
              "id",
              "type",
              "domain",
              "name",
              "ticker"
            ],
            "properties": {
              "id": {
                "description": "ID of the `Company` object.",
                "type": "string",
                "format": "uuid"
              },
              "type": {
                "description": "The type of this object.",
                "const": "company"
              },
              "domain": {
                "description": "Company domain name.",
                "type": "string"
              },
              "name": {
                "description": "Company name if available.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "ticker": {
                "description": "Company stock symbol (ticker) if available.",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "redirects_to_company_reason": {
            "description": "Reason of the redirect.",
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "acquisition_merger",
              "locality",
              "rebranding",
              null
            ]
          },
          "parent_company": {
            "title": "Company",
            "description": "The company's parent company.",
            "type": [
              "object",
              "null"
            ],
            "required": [
              "id",
              "type",
              "domain",
              "name",
              "ticker"
            ],
            "properties": {
              "id": {
                "description": "ID of the `Company` object.",
                "type": "string",
                "format": "uuid"
              },
              "type": {
                "description": "The type of this object.",
                "const": "company"
              },
              "domain": {
                "description": "Company domain name.",
                "type": "string"
              },
              "name": {
                "description": "Company name if available.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "ticker": {
                "description": "Company stock symbol (ticker) if available.",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "subsidiary_companies": {
            "description": "The company's subsidiary companies.",
            "type": "array",
            "items": {
              "title": "Company",
              "description": "A subsidiary company of this company.",
              "type": "object",
              "required": [
                "id",
                "type",
                "domain",
                "name",
                "ticker"
              ],
              "properties": {
                "id": {
                  "description": "ID of the `Company` object.",
                  "type": "string",
                  "format": "uuid"
                },
                "type": {
                  "description": "The type of this object.",
                  "const": "company"
                },
                "domain": {
                  "description": "Company domain name.",
                  "type": "string"
                },
                "name": {
                  "description": "Company name if available.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "ticker": {
                  "description": "Company stock symbol (ticker) if available.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "similar_companies": {
            "description": "Companies similar to this company. Up to 5 are returned.",
            "type": "array",
            "items": {
              "title": "Company",
              "description": "A company similar to this company.",
              "type": "object",
              "required": [
                "id",
                "type",
                "domain",
                "name",
                "ticker"
              ],
              "properties": {
                "id": {
                  "description": "ID of the `Company` object.",
                  "type": "string",
                  "format": "uuid"
                },
                "type": {
                  "description": "The type of this object.",
                  "const": "company"
                },
                "domain": {
                  "description": "Company domain name.",
                  "type": "string"
                },
                "name": {
                  "description": "Company name if available.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "ticker": {
                  "description": "Company stock symbol (ticker) if available.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "employees_min": {
            "description": "Lower bound number of the company size range.",
            "type": [
              "integer",
              "null"
            ]
          },
          "employees_max": {
            "description": "Upper bound number of the company size range.",
            "type": [
              "integer",
              "null"
            ]
          },
          "social_associated_members": {
            "description": "Number of associated members on the company's social profile.",
            "type": [
              "integer",
              "null"
            ]
          },
          "social_logo": {
            "description": "Company social profile logo URL.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_slogan": {
            "description": "Company social profile slogan.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_description": {
            "description": "Company social profile description.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_url": {
            "description": "Company social profile URL.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_industry": {
            "description": "Company industry from social profile data.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_company_type": {
            "description": "Company ownership structure.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_headquarters": {
            "description": "Company headquarters.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_founded": {
            "description": "Year the company was founded.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_funding_price": {
            "description": "Company funding amount.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_funding_last_round_date": {
            "description": "Company funding last round date.",
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "social_funding_last_round_stage": {
            "description": "Company funding last round stage.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_crunchbase_url": {
            "description": "Company Crunchbase URL.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_ticker": {
            "description": "Company ticker from social profile data.",
            "type": [
              "string",
              "null"
            ]
          },
          "social_specialties": {
            "description": "Company specialties from social profile data.",
            "type": [
              "array",
              "null"
            ]
          },
          "social_company_id": {
            "description": "Company social profile ID.",
            "type": [
              "integer",
              "null"
            ]
          },
          "social_stats": {
            "description": "Follower and employee statistics from the company's social profile over time.",
            "type": [
              "array",
              "null"
            ],
            "items": {
              "title": "SocialStats",
              "description": "The `SocialStats` object.",
              "type": "object",
              "required": [
                "associated_members",
                "followers",
                "updated_at"
              ],
              "properties": {
                "associated_members": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "followers": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "employees_min": {
                  "type": [
                    "integer"
                  ]
                },
                "employees_max": {
                  "type": [
                    "integer"
                  ]
                },
                "updated_at": {
                  "type": [
                    "string"
                  ],
                  "format": "date"
                }
              }
            }
          },
          "social_location_data": {
            "description": "Company locations from the social profile, primary location first.",
            "type": "array",
            "items": {
              "title": "LocationDataLite",
              "description": "The `LocationDataLite` object.",
              "example": {
                "city": "Menlo Park",
                "state": "California",
                "country": "United States"
              },
              "type": "object",
              "required": [
                "city",
                "state",
                "country"
              ],
              "properties": {
                "city": {
                  "description": "City of the location.",
                  "example": "Menlo Park",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "state": {
                  "description": "State of the location.",
                  "example": "California",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "country": {
                  "description": "Country of the location.",
                  "example": "United States",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "naics6_codes": {
            "description": "Company's NAICS codes.",
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "revenue_range": {
            "description": "Estimated revenue range.",
            "type": [
              "string",
              "null"
            ]
          },
          "revenue_range_data": {
            "description": "Revenue range data.",
            "type": "object",
            "properties": {
              "revenue_range_low": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "revenue_range_high": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          },
          "revenue_source": {
            "description": "Where the revenue range figure came from.",
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "sec_filing",
              "wikipedia_infobox",
              "evidence_based_estimate",
              "company_size_based_estimate",
              "manually_reviewed",
              null
            ]
          }
        }
      },
      "CompanySignal": {
        "title": "CompanySignal",
        "description": "The `CompanySignal` object.",
        "type": "object",
        "required": [
          "id",
          "type",
          "sources",
          "category",
          "subcategory",
          "headline",
          "summary",
          "evidence",
          "details",
          "importance",
          "sentiment",
          "detected_at",
          "first_seen_at",
          "company",
          "detected_on_job_openings",
          "detected_on_sec_filings"
        ],
        "properties": {
          "id": {
            "description": "ID of the `CompanySignal` object.",
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "description": "The type of this object.",
            "const": "company_signal"
          },
          "sources": {
            "description": "The data endpoints this signal was derived from.",
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "const": "job_openings",
                  "description": "Signal derived from the job openings dataset."
                },
                {
                  "const": "sec_filings",
                  "description": "Signal derived from SEC filings."
                },
                {
                  "const": "website_changes",
                  "description": "Signal derived from the website changes dataset."
                },
                {
                  "const": "technologies",
                  "description": "Signal derived from the technology detections dataset."
                }
              ]
            }
          },
          "category": {
            "description": "The group the signal's `subcategory` belongs to.",
            "oneOf": [
              {
                "const": "corporate_development",
                "description": "Company acquired another company, merged, sold assets, invested into another company, or spun part of itself off."
              },
              {
                "const": "funding",
                "description": "Company raised financing, named a backer, or went public."
              },
              {
                "const": "financials",
                "description": "Company's reported revenue, earnings, profitability or valuation."
              },
              {
                "const": "people",
                "description": "Company's leadership and workforce: an executive or senior personnel change, headcount and team build-out, or a hiring surge against its prior year's monthly average."
              },
              {
                "const": "location_and_facilities",
                "description": "Company opened, expanded or closed an office, facility or location."
              },
              {
                "const": "strategy",
                "description": "Company changed direction, positioning, pricing, or the market it targets."
              },
              {
                "const": "product",
                "description": "Company launched, is developing, or integrated an offering."
              },
              {
                "const": "tech_stack",
                "description": "Company adopted, licensed or replaced a named technology or platform."
              },
              {
                "const": "market_relationships",
                "description": "Company's customers, partners and competitors."
              },
              {
                "const": "recognition",
                "description": "Company or a person at the company received an award or recognition."
              },
              {
                "const": "legal_and_risk",
                "description": "Company faces bankruptcy, litigation, security issues, or is winding down."
              },
              {
                "const": "other",
                "description": "A notable company-level event that fits none of the other categories."
              }
            ]
          },
          "subcategory": {
            "description": "What the signal reports, within its `category` group (e.g. `\"financing_event\"` under\n`funding`, `\"product_launch\"` under `product`).\nA hiring surge names the dimension it was counted along -- `\"company_wide_hiring_surge\"`,\n`\"department_hiring_surge\"` or `\"location_hiring_surge\"`, all under `people`. The bucket\nthat surged (the job opening category, or the location with its state and country) is in\n`details`.\n",
            "type": [
              "string",
              "null"
            ]
          },
          "headline": {
            "description": "A short human-readable summary of the signal.",
            "type": "string"
          },
          "summary": {
            "description": "The headline extended with the specifics behind it, in one sentence.",
            "type": [
              "string",
              "null"
            ]
          },
          "evidence": {
            "description": "Evidence supporting the signal: a verbatim excerpt from the source for signals read out of a job description or a SEC filing, or a human-readable explanation for hiring surge signals.",
            "type": "string"
          },
          "details": {
            "description": "Structured extras recorded about the signal, keyed by name. Which keys are present depends on what detected the signal, so the object takes exactly one of the definitions below.",
            "oneOf": [
              {
                "title": "DepartmentHiringSurgeDetails",
                "description": "Details of a hiring surge counted within one job category.",
                "type": "object",
                "required": [
                  "type",
                  "department",
                  "openings",
                  "monthly_average"
                ],
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "description": "The shape this details object takes.",
                    "const": "department_hiring_surge_details"
                  },
                  "department": {
                    "description": "The job category that surged.",
                    "type": "string"
                  },
                  "openings": {
                    "description": "New job openings first found in the current 30-day window.",
                    "type": "integer"
                  },
                  "monthly_average": {
                    "description": "New job openings first found per month, averaged over the prior year.",
                    "type": "number"
                  },
                  "general": {
                    "description": "A mark the curator recorded about the signal. Present only on a hiring surge whose bucket the curator judged out of character for the company.",
                    "type": "string",
                    "enum": [
                      "unexpected_surge_for_a_company"
                    ]
                  },
                  "general_reason": {
                    "description": "Why the curator recorded the mark in `general`: what the company does and why the surging bucket falls outside it.",
                    "type": "string",
                    "maxLength": 200
                  }
                }
              },
              {
                "title": "LocationHiringSurgeDetails",
                "description": "Details of a hiring surge counted within one hiring location.",
                "type": "object",
                "required": [
                  "type",
                  "location",
                  "openings",
                  "monthly_average"
                ],
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "description": "The shape this details object takes.",
                    "const": "location_hiring_surge_details"
                  },
                  "location": {
                    "description": "The location that surged, its state and country when the state is known (e.g. `\"California, United States\"`), its country otherwise.",
                    "type": "string"
                  },
                  "openings": {
                    "description": "New job openings first found in the current 30-day window.",
                    "type": "integer"
                  },
                  "monthly_average": {
                    "description": "New job openings first found per month, averaged over the prior year.",
                    "type": "number"
                  },
                  "state": {
                    "description": "State or region of the surging location, absent when only the country resolved.",
                    "type": "string"
                  },
                  "country": {
                    "description": "Country of the surging location.",
                    "type": "string"
                  },
                  "location_raw": {
                    "description": "The location exactly as one of the counted job postings worded it.",
                    "type": "string"
                  },
                  "general": {
                    "description": "A mark the curator recorded about the signal. Present only on a hiring surge whose bucket the curator judged out of character for the company.",
                    "type": "string",
                    "enum": [
                      "unexpected_surge_for_a_company"
                    ]
                  },
                  "general_reason": {
                    "description": "Why the curator recorded the mark in `general`: what the company does and why the surging bucket falls outside it.",
                    "type": "string",
                    "maxLength": 200
                  }
                }
              },
              {
                "title": "CompanyWideHiringSurgeDetails",
                "description": "Details of a hiring surge counted across every job opening of the company.",
                "type": "object",
                "required": [
                  "type",
                  "openings",
                  "monthly_average"
                ],
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "description": "The shape this details object takes.",
                    "const": "company_wide_hiring_surge_details"
                  },
                  "openings": {
                    "description": "New job openings first found in the current 30-day window.",
                    "type": "integer"
                  },
                  "monthly_average": {
                    "description": "New job openings first found per month, averaged over the prior year.",
                    "type": "number"
                  },
                  "open_positions_total": {
                    "description": "Open positions when the surge was detected, a total rather than new postings.",
                    "type": "integer"
                  },
                  "department_details": {
                    "description": "Every job category the company is hiring in or averaged an opening a month in.",
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "department",
                        "openings",
                        "monthly_average"
                      ],
                      "additionalProperties": false,
                      "properties": {
                        "department": {
                          "description": "The department this entry counts.",
                          "type": "string"
                        },
                        "openings": {
                          "description": "New job openings first found in the current 30-day window.",
                          "type": "integer"
                        },
                        "monthly_average": {
                          "description": "New job openings first found per month, averaged over the prior year.",
                          "type": "number"
                        }
                      }
                    }
                  },
                  "location_details": {
                    "description": "Every location the company is hiring in or averaged an opening a month in.",
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "location",
                        "openings",
                        "monthly_average"
                      ],
                      "additionalProperties": false,
                      "properties": {
                        "location": {
                          "description": "The location this entry counts.",
                          "type": "string"
                        },
                        "openings": {
                          "description": "New job openings first found in the current 30-day window.",
                          "type": "integer"
                        },
                        "monthly_average": {
                          "description": "New job openings first found per month, averaged over the prior year.",
                          "type": "number"
                        }
                      }
                    }
                  }
                }
              },
              {
                "title": "SECFilingSignalDetails",
                "description": "Details of a signal extracted from a SEC filing, where a `financing_event` is always debt.",
                "type": "object",
                "required": [
                  "type"
                ],
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "description": "The shape this details object takes.",
                    "const": "sec_filing_signal_details"
                  },
                  "source_item": {
                    "description": "The Form 8-K item the event was reported under, e.g. `5.02`.",
                    "type": "string"
                  },
                  "person": {
                    "description": "The individual named, as worded, with no courtesy title, on a `leadership_change` signal.",
                    "type": "string"
                  },
                  "job_title": {
                    "description": "The title a person takes or leaves, as worded, on a `leadership_change` signal.",
                    "type": "string"
                  },
                  "change_type": {
                    "description": "Which leadership change this is, on a `leadership_change` signal.",
                    "oneOf": [
                      {
                        "const": "officer_appointment"
                      },
                      {
                        "const": "officer_departure"
                      },
                      {
                        "const": "board_appointment"
                      },
                      {
                        "const": "board_departure"
                      },
                      {
                        "const": "interim_appointment"
                      }
                    ]
                  },
                  "acquirer": {
                    "description": "The buyer: the company doing the acquiring on an `acquisition` signal, or the one buying the business on an `asset_sale`.",
                    "type": "string"
                  },
                  "acquired_company": {
                    "description": "The company being acquired, on an `acquisition` signal.",
                    "type": "string"
                  },
                  "amount": {
                    "description": "The monetary figure the signal turns on, as worded, e.g. `$1.2 billion`. On a `financing_raised_to_date` signal it is the cumulative total raised rather than any single figure.",
                    "type": "string"
                  },
                  "amount_normalized": {
                    "description": "The `amount` figure in whole US dollars, taking the midpoint where the wording states a range.",
                    "type": "integer"
                  },
                  "partners": {
                    "description": "Partners named, on a `partnership` signal.",
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "former_parent": {
                    "description": "The parent the registrant was separated out of, on a `spin_off` signal.",
                    "type": "string"
                  },
                  "lender": {
                    "description": "The lender or administrative agent, on a `financing_event` or `debt_agreement_amendment`. Never the company the signal is about.",
                    "type": "string"
                  },
                  "debt_instrument": {
                    "description": "How the debt is structured, on a debt `financing_event` signal: `security` for a tradable instrument such as notes or bonds, `loan` for an agreement with a bank or a lender group.",
                    "oneOf": [
                      {
                        "const": "security"
                      },
                      {
                        "const": "loan"
                      }
                    ]
                  },
                  "financing_type": {
                    "description": "The kind of financing raised, on a `financing_event` signal.",
                    "type": "string"
                  },
                  "exchange": {
                    "description": "The stock exchange a listing signal is about.",
                    "type": "string"
                  },
                  "predecessor": {
                    "description": "The outgoing audit firm, on an auditor change signal.",
                    "type": "string"
                  },
                  "successor": {
                    "description": "The incoming audit firm, on an auditor change signal.",
                    "type": "string"
                  }
                }
              },
              {
                "title": "CompanySignalDetails",
                "description": "Details of a signal read out of a job description or a change on the company's website: the specifics behind it, keyed by name. Which keys are present follows from the `subcategory`.",
                "type": "object",
                "required": [
                  "type"
                ],
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "description": "The shape this details object takes.",
                    "const": "company_signal_details"
                  },
                  "financing_type": {
                    "description": "The kind of financing raised, on a `financing_event` signal.",
                    "type": "string"
                  },
                  "amount": {
                    "description": "The monetary figure the signal turns on, as worded, e.g. `$1.2 billion`. On a `financing_raised_to_date` signal it is the cumulative total raised rather than any single figure.",
                    "type": "string"
                  },
                  "amount_normalized": {
                    "description": "The `amount` figure in whole US dollars, taking the midpoint where the wording states a range.",
                    "type": "integer"
                  },
                  "valuation": {
                    "description": "Valuation as worded, on a `valuation` signal.",
                    "type": "string"
                  },
                  "valuation_normalized": {
                    "description": "Valuation in whole US dollars.",
                    "type": "integer"
                  },
                  "valuation_increase": {
                    "description": "Valuation increase as worded, on a `valuation_increase` signal.",
                    "type": "string"
                  },
                  "valuation_increase_normalized": {
                    "description": "Valuation increase in whole US dollars.",
                    "type": "integer"
                  },
                  "growth_metric": {
                    "description": "The figure the company grows by, as worded, on a `growth_signal`, `revenue` or `revenue_increase` signal.",
                    "type": "string"
                  },
                  "growth_metric_type": {
                    "description": "What the figure counts. A rate of change is typed by what it counts, so revenue growth is `revenue`.",
                    "oneOf": [
                      {
                        "const": "revenue"
                      },
                      {
                        "const": "users"
                      },
                      {
                        "const": "customers"
                      },
                      {
                        "const": "transactions"
                      },
                      {
                        "const": "other"
                      }
                    ]
                  },
                  "growth_metric_scope": {
                    "description": "The slice of the business the figure covers when it is not the whole company - a region, a segment or a channel. Absent when the evidence does not scope the figure, which normally means it covers the whole company.",
                    "type": "string"
                  },
                  "growth_metric_normalized": {
                    "description": "The `growth_metric` figure as a whole number. Its unit follows `growth_metric_type`: US dollars when the type is monetary, converted at an approximate recent rate, so 5400000 for \"€5M ARR\", and the plain count otherwise, so 1700000 for \"1.7 million users\". Absent when the wording states a rate or a vague phrase rather than a figure, as in \"grown 10x\".",
                    "type": "integer"
                  },
                  "growth_metric_annual_multiplier": {
                    "description": "The growth as a multiplier over one year. Growth stated over a longer period is annualised, so \"10x since 2022\" read in 2026 is 1.78 rather than 10.",
                    "type": "number"
                  },
                  "product": {
                    "description": "The product named, on a `product_launch` or `product_in_development` signal.",
                    "type": "string"
                  },
                  "acquirer": {
                    "description": "The buyer: the company doing the acquiring on an `acquisition` signal, or the one buying the business on an `asset_sale`.",
                    "type": "string"
                  },
                  "acquired_company": {
                    "description": "The company being acquired, on an `acquisition` signal.",
                    "type": "string"
                  },
                  "integration": {
                    "description": "The product or platform integrated with, on an `integration` signal.",
                    "type": "string"
                  },
                  "market": {
                    "description": "The segment, vertical or market entered, on a `market_entry` signal.",
                    "type": "string"
                  },
                  "office_location": {
                    "description": "The place the office is opening, on a `new_office` signal.",
                    "type": "string"
                  },
                  "technology": {
                    "description": "The technology or platform adopted, on a `technology_adoption` signal.",
                    "type": "string"
                  },
                  "recognition": {
                    "description": "The award or listing named, on a `recognition` signal.",
                    "type": "string"
                  },
                  "customers": {
                    "description": "Customers named, on a `customer_identified` signal.",
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "investors": {
                    "description": "Investors named: those backing the company on an `investor_identified` or `financing_raised_to_date` signal, those taking part in the round on a `financing_event` one.",
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "partners": {
                    "description": "Partners named, on a `partnership` signal.",
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "merging_companies": {
                    "description": "The companies combining, this one included, on a `merger` signal.",
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "lender": {
                    "description": "The lender or administrative agent, on a `financing_event` or `debt_agreement_amendment`. Never the company the signal is about.",
                    "type": "string"
                  },
                  "exchange": {
                    "description": "The stock exchange a listing signal is about.",
                    "type": "string"
                  },
                  "former_parent": {
                    "description": "The parent the registrant was separated out of, on a `spin_off` signal.",
                    "type": "string"
                  },
                  "predecessor": {
                    "description": "The outgoing audit firm, on an auditor change signal.",
                    "type": "string"
                  },
                  "person": {
                    "description": "The individual named, as worded, with no courtesy title, on a `leadership_change` signal.",
                    "type": "string"
                  },
                  "job_title": {
                    "description": "The title a person takes or leaves, as worded, on a `leadership_change` signal.",
                    "type": "string"
                  },
                  "change_type": {
                    "description": "Which leadership change this is, on a `leadership_change` signal.",
                    "oneOf": [
                      {
                        "const": "officer_appointment"
                      },
                      {
                        "const": "officer_departure"
                      },
                      {
                        "const": "board_appointment"
                      },
                      {
                        "const": "board_departure"
                      },
                      {
                        "const": "interim_appointment"
                      }
                    ]
                  },
                  "debt_instrument": {
                    "description": "How the debt is structured, on a debt `financing_event` signal: `security` for a tradable instrument such as notes or bonds, `loan` for an agreement with a bank or a lender group.",
                    "oneOf": [
                      {
                        "const": "security"
                      },
                      {
                        "const": "loan"
                      }
                    ]
                  },
                  "successor": {
                    "description": "The incoming audit firm, on an auditor change signal.",
                    "type": "string"
                  },
                  "evidence_type": {
                    "description": "Which sides of the website change the evidence was taken from, on a signal converted from one: `added_text`, `removed_text` for text that disappeared from the page, or `replaced_text` for text that took the place of removed text. The evidence of a `replaced_text` signal holds both, as `Removed: <old text>` and `Added: <new text>` on separate lines.",
                    "type": "string",
                    "enum": [
                      "added_text",
                      "removed_text",
                      "replaced_text"
                    ]
                  }
                }
              },
              {
                "title": "CompetitiveDisplacementDetails",
                "description": "Details of a company replacing one technology with a competing one.",
                "type": "object",
                "required": [
                  "type",
                  "from_technology",
                  "from_technology_id",
                  "to_technology",
                  "to_technology_id",
                  "from_last_seen_at",
                  "to_first_seen_at"
                ],
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "description": "The shape this details object takes.",
                    "const": "competitive_displacement_details"
                  },
                  "from_technology": {
                    "description": "The technology that was dropped.",
                    "type": "string"
                  },
                  "from_technology_id": {
                    "description": "ID of the dropped technology in the technologies dataset.",
                    "type": "string",
                    "format": "uuid"
                  },
                  "to_technology": {
                    "description": "The competing technology that replaced it.",
                    "type": "string"
                  },
                  "to_technology_id": {
                    "description": "ID of the replacing technology in the technologies dataset.",
                    "type": "string",
                    "format": "uuid"
                  },
                  "from_last_seen_at": {
                    "description": "Date (ISO 8601) the dropped technology was last detected.",
                    "type": "string",
                    "format": "date",
                    "example": "2024-09-25"
                  },
                  "to_first_seen_at": {
                    "description": "Date (ISO 8601) the replacing technology was first detected.",
                    "type": "string",
                    "format": "date",
                    "example": "2024-09-25"
                  }
                }
              }
            ]
          },
          "importance": {
            "description": "Assessed importance of the signal.",
            "oneOf": [
              {
                "const": "low",
                "description": "Minor signal with limited business impact."
              },
              {
                "const": "medium",
                "description": "Notable signal worth monitoring."
              },
              {
                "const": "high",
                "description": "Strong signal indicating significant company activity."
              }
            ]
          },
          "sentiment": {
            "description": "How the event reads for the company, or `null` until the signal has been reviewed.",
            "oneOf": [
              {
                "const": "positive",
                "description": "Good news for the company, e.g. funding raised, a customer won, a product launched."
              },
              {
                "const": "negative",
                "description": "Bad news for the company, e.g. revenue down, a customer lost, layoffs, litigation."
              },
              {
                "const": "neutral",
                "description": "Neither, or a datapoint rather than a direction, e.g. a technology adopted, an integration, a change of course."
              },
              {
                "type": "null"
              }
            ]
          },
          "detected_at": {
            "description": "Date & time (ISO 8601) when the `CompanySignal` was detected.",
            "type": "string",
            "format": "date-time",
            "example": "2024-09-25T16:09:53Z"
          },
          "first_seen_at": {
            "description": "Date & time (ISO 8601) the signal first became knowable: the earliest job opening linked to it, the website snapshot the change was found in, or for a SEC filing signal the date its filing was made. Null when the signal has no dated source.",
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "example": "2024-09-25T16:09:53Z"
          },
          "company": {
            "title": "Company",
            "description": "The company this signal is about.",
            "type": "object",
            "required": [
              "id",
              "type",
              "domain",
              "name",
              "ticker"
            ],
            "properties": {
              "id": {
                "description": "ID of the `Company` object.",
                "type": "string",
                "format": "uuid"
              },
              "type": {
                "description": "The type of this object.",
                "const": "company"
              },
              "domain": {
                "description": "Company domain name.",
                "type": "string"
              },
              "name": {
                "description": "Company name if available.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "ticker": {
                "description": "Company stock symbol (ticker) if available.",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "detected_on_job_openings": {
            "description": "Job openings this signal was detected on, earliest first.",
            "type": "array",
            "items": {
              "title": "JobOpening",
              "type": "object",
              "required": [
                "id",
                "type"
              ],
              "properties": {
                "id": {
                  "description": "ID of the `JobOpening` object.",
                  "type": "string",
                  "format": "uuid"
                },
                "type": {
                  "description": "The type of this object.",
                  "const": "job_opening"
                }
              }
            }
          },
          "detected_on_sec_filings": {
            "description": "SEC filings this signal was extracted from. The `evidence` of a signal read from a filing is a verbatim sentence of one of these, and the v3 `sec_filings` endpoint serves each one with its form type, filing date, EDGAR URL and full text.",
            "type": "array",
            "items": {
              "title": "SECFiling",
              "type": "object",
              "required": [
                "id",
                "type"
              ],
              "properties": {
                "id": {
                  "description": "ID of the `SECFiling` object.",
                  "type": "string",
                  "format": "uuid"
                },
                "type": {
                  "description": "The type of this object.",
                  "const": "sec_filing"
                }
              }
            }
          }
        }
      },
      "CompanySignalDeleted": {
        "title": "CompanySignalDeleted",
        "description": "The `CompanySignalDeleted` object.",
        "type": "object",
        "required": [
          "id",
          "type"
        ],
        "properties": {
          "id": {
            "description": "ID of the `CompanySignalDeleted` object.",
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "description": "The type of this object.",
            "const": "company_signal"
          }
        }
      },
      "WebsiteChange": {
        "title": "WebsiteChange",
        "description": "The `WebsiteChange` object.",
        "type": "object",
        "required": [
          "id",
          "type",
          "markdown_difference",
          "events",
          "detected_at",
          "first_seen_at",
          "company"
        ],
        "properties": {
          "id": {
            "description": "ID of the `WebsiteChange` object.",
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "description": "The type of this object.",
            "const": "website_change"
          },
          "markdown_difference": {
            "description": "Raw textual difference between the two subpage content snapshots.",
            "type": "string"
          },
          "events": {
            "description": "Business-change events detected in this diff.",
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "category",
                "importance",
                "added_evidence",
                "removed_evidence",
                "evidence_type"
              ],
              "properties": {
                "id": {
                  "description": "ID of the `WebsiteChange` object.",
                  "type": "string",
                  "format": "uuid"
                },
                "category": {
                  "description": "The type of business change detected.",
                  "oneOf": [
                    {
                      "const": "strategic_pivot",
                      "description": "The core value proposition or positioning changed."
                    },
                    {
                      "const": "audience_change",
                      "description": "The target audience or market focus shifted."
                    },
                    {
                      "const": "product_launch",
                      "description": "A new product/service launched, overhauled, or sunset."
                    },
                    {
                      "const": "pricing_restructure",
                      "description": "Pricing model, tiers, or plans changed."
                    },
                    {
                      "const": "leadership_change",
                      "description": "A board or C-suite/executive change."
                    },
                    {
                      "const": "acquisition",
                      "description": "The company acquired another, or was itself acquired."
                    },
                    {
                      "const": "merger",
                      "description": "Two companies combined into a single entity."
                    },
                    {
                      "const": "spin_off",
                      "description": "A business separated out of its parent into an independent company."
                    },
                    {
                      "const": "asset_sale",
                      "description": "The company sold a business, subsidiary, or other assets such as property to a buyer."
                    },
                    {
                      "const": "financing_event",
                      "description": "A funding round or financing event."
                    },
                    {
                      "const": "public_listing",
                      "description": "An IPO filing, planned stock listing, or recent public listing."
                    },
                    {
                      "const": "exchange_delisting",
                      "description": "The company's shares were delisted from a stock exchange."
                    },
                    {
                      "const": "partnership",
                      "description": "A new business partnership announced."
                    },
                    {
                      "const": "integration",
                      "description": "A new integration with a named product or platform."
                    },
                    {
                      "const": "investor_identified",
                      "description": "A named investor or backer disclosed."
                    },
                    {
                      "const": "customer_identified",
                      "description": "A new named customer or client win announced."
                    },
                    {
                      "const": "new_office",
                      "description": "A new office, facility, or location opened."
                    },
                    {
                      "const": "market_entry",
                      "description": "A new market, geography, or segment entered."
                    },
                    {
                      "const": "operational_restructuring",
                      "description": "The company closed a site, cut staff, or left a product line or market."
                    },
                    {
                      "const": "recognition",
                      "description": "An award, certification, or notable recognition."
                    },
                    {
                      "const": "attends_event",
                      "description": "The company attends, sponsors, or hosts a named industry event."
                    },
                    {
                      "const": "winding_down",
                      "description": "The company is shutting down or ceasing operations."
                    },
                    {
                      "const": "other",
                      "description": "A significant business event that fits none of the other categories."
                    }
                  ]
                },
                "headline": {
                  "description": "A short human-readable summary of the event.",
                  "type": "string"
                },
                "summary": {
                  "description": "The headline extended with the specifics behind it, in one sentence.",
                  "type": "string"
                },
                "added_evidence": {
                  "description": "The cited added lines the event rests on, verbatim, joined in page order. Cited lines need not be adjacent on the page. Null when no added line was cited.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "removed_evidence": {
                  "description": "The cited removed lines the event rests on, verbatim, joined in page order. Cited lines need not be adjacent on the page. Null when no removed line was cited.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "evidence_type": {
                  "description": "Which sides of the change the evidence was taken from.",
                  "oneOf": [
                    {
                      "const": "added_text",
                      "description": "Only text added to the page in this change."
                    },
                    {
                      "const": "removed_text",
                      "description": "Only text removed from the page in this change, such as a product being sunset."
                    },
                    {
                      "const": "replaced_text",
                      "description": "Text removed from the page together with the text that replaced it."
                    }
                  ]
                },
                "importance": {
                  "description": "Importance of the event, from 1 to 10. A low score is a minor change with limited business impact, a middling one a notable change worth monitoring, and a high one a significant change indicating major company activity.",
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 10
                }
              }
            }
          },
          "detected_at": {
            "description": "Date & time (ISO 8601) when the change was detected, which is when the two snapshots were compared.",
            "type": "string",
            "format": "date-time",
            "example": "2024-09-25T16:09:53Z"
          },
          "first_seen_at": {
            "description": "Date & time (ISO 8601) when the newer of the two snapshots was captured, which is the closest bound on when the change happened.",
            "type": "string",
            "format": "date-time",
            "example": "2024-09-25T16:09:53Z"
          },
          "company": {
            "title": "Company",
            "description": "The company this change is about.",
            "type": "object",
            "required": [
              "id",
              "type",
              "domain",
              "name",
              "ticker"
            ],
            "properties": {
              "id": {
                "description": "ID of the `Company` object.",
                "type": "string",
                "format": "uuid"
              },
              "type": {
                "description": "The type of this object.",
                "const": "company"
              },
              "domain": {
                "description": "Company domain name.",
                "type": "string"
              },
              "name": {
                "description": "Company name if available.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "ticker": {
                "description": "Company stock symbol (ticker) if available.",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      },
      "Subpage": {
        "title": "Subpage",
        "description": "The `Subpage` object.",
        "type": "object",
        "required": [
          "id",
          "type",
          "category",
          "url",
          "text_content",
          "first_seen_at",
          "last_seen_at",
          "last_extraction_states",
          "company"
        ],
        "properties": {
          "id": {
            "description": "ID of the `Subpage` object.",
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "description": "The type of this object.",
            "const": "subpage"
          },
          "category": {
            "description": "What the subpage is about, e.g. `about`, `blog`, `jobs` or `pricing`.",
            "type": "string",
            "enum": [
              "blog",
              "news",
              "press",
              "about",
              "leadership",
              "jobs",
              "facebook",
              "twitter",
              "linkedin",
              "instagram",
              "pinterest",
              "contact",
              "playstore",
              "appstore",
              "news_outlet",
              "customers",
              "partners",
              "integrations",
              "case_studies",
              "portfolio",
              "suppliers",
              "testimonials",
              "login",
              "support",
              "pricing",
              "job_board",
              "main",
              "github",
              "investors",
              "products",
              "solutions",
              "status",
              "demo",
              "resources",
              "events",
              "developers",
              "api",
              "terms",
              "privacy",
              "trust",
              "feedback",
              "marketplace",
              "store",
              "community",
              "retail",
              "sitemap",
              "webinars",
              "search",
              "social_media",
              "updates",
              "registration",
              "locations",
              "external_review",
              "discord",
              "youtube",
              "tiktok",
              "sec",
              "review",
              "subprocessors",
              "changelog"
            ]
          },
          "url": {
            "description": "Subpage URL.",
            "type": "string",
            "format": "uri"
          },
          "text_content": {
            "description": "Text content from the subpage in markdown format. Sentences are contextually separated with new lines (\\n). Null when no content was extracted yet.",
            "type": [
              "string",
              "null"
            ]
          },
          "first_seen_at": {
            "description": "Date & time (ISO 8601) when the `Subpage` was first seen.",
            "type": "string",
            "format": "date-time",
            "example": "2024-09-25T16:09:53Z"
          },
          "last_seen_at": {
            "description": "Date & time (ISO 8601) when the `Subpage` was last seen.",
            "type": "string",
            "format": "date-time",
            "example": "2024-09-25T16:09:53Z"
          },
          "last_extraction_states": {
            "description": "The outcome of the latest visits to the subpage, oldest first.",
            "type": "array",
            "items": {
              "title": "LastExtractionState",
              "description": "The outcome of one visit to the subpage.",
              "type": "object",
              "required": [
                "status",
                "status_code",
                "processed_at"
              ],
              "properties": {
                "status": {
                  "description": "Extraction status, e.g. `live` when the page answered.",
                  "type": "string"
                },
                "status_code": {
                  "description": "HTTP response status code, null when the request got no response.",
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "processed_at": {
                  "description": "Date & time (ISO 8601) when the subpage was visited.",
                  "type": "string",
                  "format": "date-time",
                  "example": "2024-09-25T16:09:53Z"
                }
              }
            }
          },
          "company": {
            "title": "Company",
            "description": "The company this subpage belongs to.",
            "type": "object",
            "required": [
              "id",
              "type",
              "domain",
              "name",
              "ticker"
            ],
            "properties": {
              "id": {
                "description": "ID of the `Company` object.",
                "type": "string",
                "format": "uuid"
              },
              "type": {
                "description": "The type of this object.",
                "const": "company"
              },
              "domain": {
                "description": "Company domain name.",
                "type": "string"
              },
              "name": {
                "description": "Company name if available.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "ticker": {
                "description": "Company stock symbol (ticker) if available.",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      },
      "SECFinancial": {
        "title": "SECFinancial",
        "description": "The `SECFinancial` object.",
        "type": "object",
        "required": [
          "id",
          "type",
          "form_type",
          "filed_at",
          "report_date",
          "source_url",
          "company",
          "income_statement"
        ],
        "properties": {
          "id": {
            "description": "ID of the `SECFinancial` object.",
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "description": "The type of this object.",
            "const": "sec_financial"
          },
          "form_type": {
            "description": "Type of SEC form the figures were reported on.",
            "type": "string",
            "enum": [
              "10-K",
              "20-F",
              "40-F",
              "10-Q"
            ]
          },
          "filed_at": {
            "description": "Date (ISO 8601) the filing was submitted to the SEC on.",
            "type": "string",
            "format": "date",
            "example": "2024-09-25"
          },
          "report_date": {
            "description": "Date (ISO 8601) the filing reports on, which is the end of the period it covers. Null when EDGAR reports the filing without one.",
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "example": "2024-09-25"
          },
          "source_url": {
            "description": "URL to the primary filing document on SEC EDGAR.",
            "type": "string",
            "format": "uri"
          },
          "company": {
            "title": "Company",
            "description": "The company that filed these figures.",
            "type": "object",
            "required": [
              "id",
              "type",
              "domain",
              "name",
              "ticker"
            ],
            "properties": {
              "id": {
                "description": "ID of the `Company` object.",
                "type": "string",
                "format": "uuid"
              },
              "type": {
                "description": "The type of this object.",
                "const": "company"
              },
              "domain": {
                "description": "Company domain name.",
                "type": "string"
              },
              "name": {
                "description": "Company name if available.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "ticker": {
                "description": "Company stock symbol (ticker) if available.",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "income_statement": {
            "title": "IncomeStatement",
            "description": "What the company earned over the period this filing reports on, in whole US dollars. Null when no figures are available for that period.",
            "type": [
              "object",
              "null"
            ],
            "required": [
              "period_type",
              "period_start_date",
              "period_end_date",
              "revenue",
              "cost_of_revenue",
              "gross_profit",
              "operating_income",
              "net_income"
            ],
            "properties": {
              "period_type": {
                "description": "The duration these figures cover. A `10-Q` reports a quarter; a `10-K`, `20-F` or `40-F` reports a fiscal year.",
                "type": "string",
                "enum": [
                  "annual",
                  "quarterly"
                ]
              },
              "period_start_date": {
                "description": "Date (ISO 8601) the period starts on.",
                "type": "string",
                "format": "date",
                "example": "2024-09-25"
              },
              "period_end_date": {
                "description": "Date (ISO 8601) the period ends on.",
                "type": "string",
                "format": "date",
                "example": "2024-09-25"
              },
              "revenue": {
                "description": "Total revenue the company earned over the period. For a bank, its interest and dividend income plus its non-interest income, before interest expense.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "cost_of_revenue": {
                "description": "What producing that revenue cost.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "gross_profit": {
                "description": "Revenue less the cost of revenue.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "operating_income": {
                "description": "What the company earned from its operations, before tax. For an investment company, its net investment income.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "net_income": {
                "description": "What the company earned after every cost, interest and tax.",
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        }
      },
      "ApiRequestLog": {
        "title": "ApiRequestLog",
        "description": "The `ApiRequestLog` object.",
        "type": "object",
        "required": [
          "id",
          "type",
          "requested_at",
          "request_params",
          "request_path",
          "response_code",
          "credits_used",
          "duration",
          "source"
        ],
        "properties": {
          "id": {
            "description": "ID of the `ApiRequestLog` object.",
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "description": "The type of this object.",
            "const": "api_request_log"
          },
          "requested_at": {
            "description": "Date & time (ISO 8601) when the request was made.",
            "type": "string",
            "format": "date-time"
          },
          "request_params": {
            "description": "Query parameters included in the request, excluding internal fields such as `api_key` and `api_token`.",
            "type": "object"
          },
          "request_path": {
            "description": "Path of the API endpoint that was called.",
            "type": "string"
          },
          "response_code": {
            "description": "HTTP response status code returned for the request.",
            "type": "integer"
          },
          "credits_used": {
            "description": "Number of credits consumed by the request.",
            "type": [
              "integer",
              "null"
            ]
          },
          "duration": {
            "description": "Total request processing time in milliseconds.",
            "type": [
              "number",
              "null"
            ]
          },
          "source": {
            "description": "Surface the request originated from.",
            "enum": [
              "direct",
              "playground",
              "mcp",
              "mcp_transport",
              "zeroclick",
              null
            ]
          }
        }
      }
    }
  },
  "security": [
    {
      "api_key": [],
      "api_token": []
    },
    {
      "basic": []
    }
  ]
}