Información sobre empresas

Inteligencia empresarial

curl --request POST \
  --url https://api.glasser.ai/v1/solutions/gtm/company_intelligence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '
{
  "domain": "<string>",
  "industries": [
    "<string>"
  ],
  "headcounts": [],
  "company_types": [],
  "offset": 5000,
  "page": 250,
  "country": "<string>",
  "query": "<string>",
  "limit": 50,
  "task_id": "<string>",
  "metadata": {}
}
'

import requests

url = "https://api.glasser.ai/v1/solutions/gtm/company_intelligence"

payload = {
    "domain": "<string>",
    "industries": ["<string>"],
    "headcounts": [],
    "company_types": [],
    "offset": 5000,
    "page": 250,
    "country": "<string>",
    "query": "<string>",
    "limit": 50,
    "task_id": "<string>",
    "metadata": {}
}
headers = {
    "idempotency-key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'idempotency-key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain: '<string>',
    industries: ['<string>'],
    headcounts: [],
    company_types: [],
    offset: 5000,
    page: 250,
    country: '<string>',
    query: '<string>',
    limit: 50,
    task_id: '<string>',
    metadata: {}
  })
};

fetch('https://api.glasser.ai/v1/solutions/gtm/company_intelligence', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.glasser.ai/v1/solutions/gtm/company_intelligence",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'domain' => '<string>',
    'industries' => [
        '<string>'
    ],
    'headcounts' => [
        
    ],
    'company_types' => [
        
    ],
    'offset' => 5000,
    'page' => 250,
    'country' => '<string>',
    'query' => '<string>',
    'limit' => 50,
    'task_id' => '<string>',
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "idempotency-key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.glasser.ai/v1/solutions/gtm/company_intelligence"

	payload := strings.NewReader("{\n  \"domain\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"headcounts\": [],\n  \"company_types\": [],\n  \"offset\": 5000,\n  \"page\": 250,\n  \"country\": \"<string>\",\n  \"query\": \"<string>\",\n  \"limit\": 50,\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("idempotency-key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.glasser.ai/v1/solutions/gtm/company_intelligence")
  .header("idempotency-key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"headcounts\": [],\n  \"company_types\": [],\n  \"offset\": 5000,\n  \"page\": 250,\n  \"country\": \"<string>\",\n  \"query\": \"<string>\",\n  \"limit\": 50,\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.glasser.ai/v1/solutions/gtm/company_intelligence")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["idempotency-key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"headcounts\": [],\n  \"company_types\": [],\n  \"offset\": 5000,\n  \"page\": 250,\n  \"country\": \"<string>\",\n  \"query\": \"<string>\",\n  \"limit\": 50,\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "run_url": "<string>",
  "provider": "<string>",
  "endpoint": "<string>",
  "endpoint_version": 123,
  "status": "QUEUED",
  "failure": {
    "kind": "TIMED_OUT",
    "message": "<string>"
  },
  "input": {},
  "output": {
    "total_matches": 123,
    "items": [
      {
        "name": "<string>",
        "website": "<string>",
        "description": "<string>",
        "industry": "<string>",
        "employees": 123,
        "employee_range_min": 123,
        "employee_range_max": 123,
        "founded_year": 123,
        "city": "<string>",
        "region": "<string>",
        "country": "<string>",
        "country_code": "<string>",
        "linkedin_url": "<string>",
        "phone": "<string>",
        "total_funding_usd": 123,
        "revenue_usd": 123,
        "revenue_range_min_usd": 123,
        "revenue_range_max_usd": 123,
        "ownership": "public",
        "ticker": "<string>",
        "latest_funding_date": "<string>",
        "domain": "<string>"
      }
    ]
  },
  "provider_response": {
    "http_status": 349,
    "error": null
  },
  "charge_usd": "<string>",
  "charge_basis": {
    "clause": "rule",
    "quantity": 1
  },
  "stoppable": true,
  "stop_requested_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "task_id": "<string>",
  "metadata": {},
  "action": "search",
  "result_status": "success",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "runs": [
    {
      "id": "<string>",
      "run_url": "<string>",
      "provider": "<string>",
      "endpoint": "<string>",
      "endpoint_version": 123,
      "status": "QUEUED",
      "failure": {
        "kind": "TIMED_OUT",
        "message": "<string>"
      },
      "input": {
        "omitted": true
      },
      "output": {
        "omitted": true
      },
      "provider_response": {
        "http_status": 349
      },
      "charge_usd": "<string>",
      "charge_basis": {
        "clause": "rule",
        "quantity": 1
      },
      "stoppable": true,
      "stop_requested_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "task_id": "<string>",
      "metadata": {}
    }
  ],
  "result_url": "<string>"
}

{
  "id": "<string>",
  "run_url": "<string>",
  "provider": "<string>",
  "endpoint": "<string>",
  "endpoint_version": 123,
  "status": "QUEUED",
  "failure": {
    "kind": "TIMED_OUT",
    "message": "<string>"
  },
  "input": {},
  "output": {
    "total_matches": 123,
    "items": [
      {
        "name": "<string>",
        "website": "<string>",
        "description": "<string>",
        "industry": "<string>",
        "employees": 123,
        "employee_range_min": 123,
        "employee_range_max": 123,
        "founded_year": 123,
        "city": "<string>",
        "region": "<string>",
        "country": "<string>",
        "country_code": "<string>",
        "linkedin_url": "<string>",
        "phone": "<string>",
        "total_funding_usd": 123,
        "revenue_usd": 123,
        "revenue_range_min_usd": 123,
        "revenue_range_max_usd": 123,
        "ownership": "public",
        "ticker": "<string>",
        "latest_funding_date": "<string>",
        "domain": "<string>"
      }
    ]
  },
  "provider_response": {
    "http_status": 349,
    "error": null
  },
  "charge_usd": "<string>",
  "charge_basis": {
    "clause": "rule",
    "quantity": 1
  },
  "stoppable": true,
  "stop_requested_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "task_id": "<string>",
  "metadata": {},
  "action": "search",
  "result_status": "success",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "runs": [
    {
      "id": "<string>",
      "run_url": "<string>",
      "provider": "<string>",
      "endpoint": "<string>",
      "endpoint_version": 123,
      "status": "QUEUED",
      "failure": {
        "kind": "TIMED_OUT",
        "message": "<string>"
      },
      "input": {
        "omitted": true
      },
      "output": {
        "omitted": true
      },
      "provider_response": {
        "http_status": 349
      },
      "charge_usd": "<string>",
      "charge_basis": {
        "clause": "rule",
        "quantity": 1
      },
      "stoppable": true,
      "stop_requested_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "task_id": "<string>",
      "metadata": {}
    }
  ],
  "result_url": "<string>"
}

{
  "error": {
    "code": "validation_failed",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "unauthorized",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "insufficient_balance",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "endpoint_not_permitted",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "idempotency_conflict",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "rate_limited",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "service_unavailable",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

POST

solutions

gtm

company_intelligence

Inteligencia empresarial

curl --request POST \
  --url https://api.glasser.ai/v1/solutions/gtm/company_intelligence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '
{
  "domain": "<string>",
  "industries": [
    "<string>"
  ],
  "headcounts": [],
  "company_types": [],
  "offset": 5000,
  "page": 250,
  "country": "<string>",
  "query": "<string>",
  "limit": 50,
  "task_id": "<string>",
  "metadata": {}
}
'

import requests

url = "https://api.glasser.ai/v1/solutions/gtm/company_intelligence"

payload = {
    "domain": "<string>",
    "industries": ["<string>"],
    "headcounts": [],
    "company_types": [],
    "offset": 5000,
    "page": 250,
    "country": "<string>",
    "query": "<string>",
    "limit": 50,
    "task_id": "<string>",
    "metadata": {}
}
headers = {
    "idempotency-key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'idempotency-key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain: '<string>',
    industries: ['<string>'],
    headcounts: [],
    company_types: [],
    offset: 5000,
    page: 250,
    country: '<string>',
    query: '<string>',
    limit: 50,
    task_id: '<string>',
    metadata: {}
  })
};

fetch('https://api.glasser.ai/v1/solutions/gtm/company_intelligence', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.glasser.ai/v1/solutions/gtm/company_intelligence",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'domain' => '<string>',
    'industries' => [
        '<string>'
    ],
    'headcounts' => [
        
    ],
    'company_types' => [
        
    ],
    'offset' => 5000,
    'page' => 250,
    'country' => '<string>',
    'query' => '<string>',
    'limit' => 50,
    'task_id' => '<string>',
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "idempotency-key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.glasser.ai/v1/solutions/gtm/company_intelligence"

	payload := strings.NewReader("{\n  \"domain\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"headcounts\": [],\n  \"company_types\": [],\n  \"offset\": 5000,\n  \"page\": 250,\n  \"country\": \"<string>\",\n  \"query\": \"<string>\",\n  \"limit\": 50,\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("idempotency-key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.glasser.ai/v1/solutions/gtm/company_intelligence")
  .header("idempotency-key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"headcounts\": [],\n  \"company_types\": [],\n  \"offset\": 5000,\n  \"page\": 250,\n  \"country\": \"<string>\",\n  \"query\": \"<string>\",\n  \"limit\": 50,\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.glasser.ai/v1/solutions/gtm/company_intelligence")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["idempotency-key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"headcounts\": [],\n  \"company_types\": [],\n  \"offset\": 5000,\n  \"page\": 250,\n  \"country\": \"<string>\",\n  \"query\": \"<string>\",\n  \"limit\": 50,\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "run_url": "<string>",
  "provider": "<string>",
  "endpoint": "<string>",
  "endpoint_version": 123,
  "status": "QUEUED",
  "failure": {
    "kind": "TIMED_OUT",
    "message": "<string>"
  },
  "input": {},
  "output": {
    "total_matches": 123,
    "items": [
      {
        "name": "<string>",
        "website": "<string>",
        "description": "<string>",
        "industry": "<string>",
        "employees": 123,
        "employee_range_min": 123,
        "employee_range_max": 123,
        "founded_year": 123,
        "city": "<string>",
        "region": "<string>",
        "country": "<string>",
        "country_code": "<string>",
        "linkedin_url": "<string>",
        "phone": "<string>",
        "total_funding_usd": 123,
        "revenue_usd": 123,
        "revenue_range_min_usd": 123,
        "revenue_range_max_usd": 123,
        "ownership": "public",
        "ticker": "<string>",
        "latest_funding_date": "<string>",
        "domain": "<string>"
      }
    ]
  },
  "provider_response": {
    "http_status": 349,
    "error": null
  },
  "charge_usd": "<string>",
  "charge_basis": {
    "clause": "rule",
    "quantity": 1
  },
  "stoppable": true,
  "stop_requested_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "task_id": "<string>",
  "metadata": {},
  "action": "search",
  "result_status": "success",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "runs": [
    {
      "id": "<string>",
      "run_url": "<string>",
      "provider": "<string>",
      "endpoint": "<string>",
      "endpoint_version": 123,
      "status": "QUEUED",
      "failure": {
        "kind": "TIMED_OUT",
        "message": "<string>"
      },
      "input": {
        "omitted": true
      },
      "output": {
        "omitted": true
      },
      "provider_response": {
        "http_status": 349
      },
      "charge_usd": "<string>",
      "charge_basis": {
        "clause": "rule",
        "quantity": 1
      },
      "stoppable": true,
      "stop_requested_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "task_id": "<string>",
      "metadata": {}
    }
  ],
  "result_url": "<string>"
}

{
  "id": "<string>",
  "run_url": "<string>",
  "provider": "<string>",
  "endpoint": "<string>",
  "endpoint_version": 123,
  "status": "QUEUED",
  "failure": {
    "kind": "TIMED_OUT",
    "message": "<string>"
  },
  "input": {},
  "output": {
    "total_matches": 123,
    "items": [
      {
        "name": "<string>",
        "website": "<string>",
        "description": "<string>",
        "industry": "<string>",
        "employees": 123,
        "employee_range_min": 123,
        "employee_range_max": 123,
        "founded_year": 123,
        "city": "<string>",
        "region": "<string>",
        "country": "<string>",
        "country_code": "<string>",
        "linkedin_url": "<string>",
        "phone": "<string>",
        "total_funding_usd": 123,
        "revenue_usd": 123,
        "revenue_range_min_usd": 123,
        "revenue_range_max_usd": 123,
        "ownership": "public",
        "ticker": "<string>",
        "latest_funding_date": "<string>",
        "domain": "<string>"
      }
    ]
  },
  "provider_response": {
    "http_status": 349,
    "error": null
  },
  "charge_usd": "<string>",
  "charge_basis": {
    "clause": "rule",
    "quantity": 1
  },
  "stoppable": true,
  "stop_requested_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "task_id": "<string>",
  "metadata": {},
  "action": "search",
  "result_status": "success",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "runs": [
    {
      "id": "<string>",
      "run_url": "<string>",
      "provider": "<string>",
      "endpoint": "<string>",
      "endpoint_version": 123,
      "status": "QUEUED",
      "failure": {
        "kind": "TIMED_OUT",
        "message": "<string>"
      },
      "input": {
        "omitted": true
      },
      "output": {
        "omitted": true
      },
      "provider_response": {
        "http_status": 349
      },
      "charge_usd": "<string>",
      "charge_basis": {
        "clause": "rule",
        "quantity": 1
      },
      "stoppable": true,
      "stop_requested_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "task_id": "<string>",
      "metadata": {}
    }
  ],
  "result_url": "<string>"
}

{
  "error": {
    "code": "validation_failed",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "unauthorized",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "insufficient_balance",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "endpoint_not_permitted",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "idempotency_conflict",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "rate_limited",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "service_unavailable",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

Cada acción devuelve output normalizado. La salida nativa del proveedor no se repite allí; permanece en el Run y puede leerse con Obtener Run. enrich y traffic exponen campos de nivel superior fijos; tech_stack, competitors y news exponen output.items[]; funding expone total_funding_usd además de items[]. Un valor que el proveedor seleccionado no informa es null; Glasser no lo completa. El dinero siempre se expresa en USD. Lee result_status por separado de status: success, no_result, error o pending. Una respuesta vacía pero válida es no_result y conserva la estructura de la acción: todos los campos son null, o items es []. charge_usd totaliza el runs de esta respuesta y es null hasta que todos los Runs se completen. Con provider: auto, el fallback puede crear varios Runs, cada uno incluido en runs[] con su propio cargo. Para una consulta de Similarweb pendiente (traffic mediante Apify, HTTP 202), sigue el result_url autenticado. Consulta Selección de proveedores y cargos.

Salida por acción

Todos los campos están presentes en cada fila; un valor que el proveedor no informa es null. Los campos siguen las convenciones de campos.

`action`	`output`
`enrich`	`name`, `website`, `description`, `industry`, `employees`, `employee_range_min`, `employee_range_max`, `founded_year`, `city`, `region`, `country`, `country_code`, `linkedin_url`, `phone`, `total_funding_usd`, `revenue_usd`, `revenue_range_min_usd`, `revenue_range_max_usd`, `ownership`, `ticker`, `latest_funding_date`
`tech_stack`	`items[]`: `name`, `categories`[], `detection_source`, `predictleads_confidence`, `first_detected_date`, `last_detected_date`
`traffic`	`monthly_visits`, `organic_traffic`, `paid_traffic`, `organic_keywords`, `paid_keywords`, `organic_traffic_value_usd`, `similarweb_global_rank`, `bounce_rate`, `pages_per_visit`, `avg_visit_duration_seconds`
`competitors`	`items[]`: `domain`, `name`, `page_title`, `position`, `predictleads_similarity_score`, `exa_similarity_score`, `reason`
`funding`	`total_funding_usd`, `items[]`: `round_date`, `round`, `amount_usd`, `investors`[], `source_url`
`news`	`items[]`: `title`, `url`, `source`, `published_at`, `event_date`, `date_text`, `category`, `snippet`

employees y los campos de ingresos son estimaciones propias del proveedor. revenue_usd es una cifra única; cuando un proveedor solo proporciona un intervalo, es null y los límites del intervalo se encuentran en revenue_range_min_usd / revenue_range_max_usd. employee_range_min / employee_range_max funcionan de la misma manera. Un intervalo abierto como 10000+ tiene un máximo null.
country es un nombre de visualización en inglés y country_code es un código ISO 3166-1 alfa-2. ownership es uno de public, private, nonprofit, government, education, other o null; private nunca se infiere.
Las puntuaciones del modelo propio de un proveedor llevan su nombre y son null para los demás: predictleads_similarity_score (0–1), exa_similarity_score (similitud neuronal de Exa), predictleads_confidence (0–1), similarweb_global_rank (1 = más visitado). position es el orden basado en 1 de la respuesta del proveedor.
competitors mediante Exa devuelve páginas web, no registros de empresas: name es null y el título de la página se encuentra en page_title. Se excluyen las filas del propio dominio de la empresa y de sus subdominios.
monthly_visits es mundial (Similarweb). organic_traffic, paid_traffic y los recuentos de palabras clave corresponden a la solicitud country (valor predeterminado us). bounce_rate es una fracción de 0–1.
Fechas: *_date y event_date son YYYY-MM-DD, published_at es ISO 8601 UTC y date_text es el texto de visualización de Google News exactamente como se devolvió. Las fechas de financiación de LeadMagic tienen precisión mensual (día 01).
industry, categories, round y category son etiquetas del vocabulario propio del proveedor que responde y no son comparables entre proveedores.

{
  "action": "enrich",
  "provider": "apollo",
  "status": "COMPLETED",
  "result_status": "success",
  "output": {
    "name": "Stripe", "website": "http://www.stripe.com", "industry": "information technology & services",
    "employees": 9400, "employee_range_min": null, "employee_range_max": null, "founded_year": 2010,
    "city": "South San Francisco", "region": "California", "country": "United States", "country_code": "US",
    "linkedin_url": "http://www.linkedin.com/company/stripe", "phone": "+1 415-298-5539",
    "total_funding_usd": 9443867423, "revenue_usd": 6935000000, "revenue_range_min_usd": null, "revenue_range_max_usd": null,
    "ownership": null, "ticker": null, "latest_funding_date": "2026-03-01",
    "description": "Stripe, Inc. is a global financial technology company…"
  },
  "charge_usd": "0.026",
  "runs": [{ "provider": "apollo", "status": "COMPLETED", "charge_usd": "0.026" }],
  "result_url": "/v1/solutions/gtm/company_intelligence/result?token=…"
}

Encabezados

idempotency-key

string

requerido

Genera un valor único para cada ejecución prevista (se recomienda un UUID). Reintenta con la misma clave y los parámetros de ejecución para recuperar el Run original sin un segundo cargo. Cambiar los parámetros de ejecución con la misma clave devuelve 409; cambiar task_id o metadata no actualiza el Run original.

Minimum string length: 1

Cuerpo

application/json

action

enum<string> | null

Predeterminado: enrich. search requiere query o un filtro estructurado; lookup requiere query (nombre de la empresa). Todas las demás acciones requieren domain.

search: descubrimiento de empresas por sector, rango de empleados, país o tipo de empresa; offset permite paginar. Los filtros estructurados usan la terminología de Hunter; usa query solo para criterios representables mediante estos filtros. Las demás condiciones del ICP deben comprobarse por separado.
lookup: candidatos por nombre de empresa con paginación por página; no elijas entre nombres ambiguos.
enrich: perfil de la empresa y datos firmográficos.
tech_stack, traffic, funding, news: los datos de empresa correspondientes.
jobs: ofertas de empleo abiertas encontradas en las páginas de empleo de la propia empresa; limit limita las filas (predeterminado y máximo: 25), por lo que el número de filas no es el total de la empresa.
ads: creatividades del Google Ads Transparency Center del anunciante detrás del dominio; country las limita a una región; sin este campo se incluyen todas las regiones.
competitors: empresas similares. Para dominios competidores en los resultados de Google, usa la investigación SEO con organic_competitors.

Opciones disponibles:

search,

lookup,

enrich,

tech_stack,

traffic,

competitors,

funding,

news,

jobs,

ads

provider

enum<string> | null

Predeterminado auto: selecciona el primer proveedor de datos elegible según el orden de preferencia de Glasser. Un proveedor de datos nombrado debe admitir la solicitud y estar permitido por tu Key; no hace fallback a otro proveedor de datos. Los valores disponibles se indican a continuación.

Opciones disponibles:

auto,

apollo,

pdl,

hunter,

prospeo,

predictleads,

leadmagic,

builtwith,

dataforseo,

ahrefs,

apify,

exa,

serper,

scrapecreators

domain

string | null

Un dominio web como stripe.com. Se acepta una URL completa y se reduce a su host.

Required string length: 3 - 253

industries

string[] | null

Required array length: 1 - 20 elements

Minimum string length: 1

headcounts

enum<string>[] | null

Required array length: 1 - 8 elements

Opciones disponibles:

1-10,

11-50,

51-200,

201-500,

501-1000,

1001-5000,

5001-10000,

10001+

company_types

enum<string>[] | null

Required array length: 1 - 10 elements

Opciones disponibles:

educational,

educational institution,

government agency,

non profit,

partnership,

privately held,

public company,

self employed,

self owned,

sole proprietorship

offset

integer | null

Rango requerido: 0 <= x <= 10000

page

integer | null

Rango requerido: 1 <= x <= 500

country

string | null

País como código ISO de dos letras o nombre del país, por ejemplo, us, gb, de, Germany. Predeterminado: us. Códigos de país compatibles: us, gb, ca, au, nz, ie, in, sg, de, at, ch, fr, be, es, mx, ar, it, nl, pt, br, jp, kr, cn, hk, tw, ru, pl, se, no, dk, fi, tr, id, th, vn, ph, my, za, ae, il, sa, eg, ng, ua, cz, gr, hu, ro, co, cl, pe, lu. La disponibilidad también depende de la acción y del proveedor de datos. Un país no compatible se rechaza antes de crear un Run. No cambies el país para evitar un error; eso cambia los datos solicitados.

Required string length: 2 - 60

query

string | null

search: prompt para descubrir empresas. lookup: nombre de una empresa. news mediante Serper: nombre de la empresa en lugar del dominio.

Required string length: 1 - 200

limit

integer | null

Filas que se devolverán. Mantén un número reducido: la regla de cargo del endpoint enrutado puede leerlo. Cada capacidad aplica además su propio límite.

Rango requerido: 1 <= x <= 100

task_id

string | null

Agrupa los Runs relacionados, incluido el fallback automático, bajo un único Task. Reutiliza una cadena estable y filtra la lista de Runs por task para recuperarlos.

metadata

Campos de seguimiento opcionales, devueltos en el Run y disponibles como filtros. Nunca se envían al proveedor de datos ni afectan al enrutamiento, Price o la idempotencia.

Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben comenzar por una letra y tener como máximo 40 caracteres.
Valores: cadenas de 1–500 caracteres.
user_id: el ID opaco de su End user, nunca su dirección de correo electrónico ni su nombre.

Las entradas no válidas se descartan por completo, sin truncarlas. La solicitud continúa y el Run devuelve los campos almacenados.

Show child attributes

Respuesta

Éxito

string

requerido

run_url

string

requerido

Abre este Run en la consola. Requiere pertenecer a un Workspace.

provider

string

requerido

Pattern: ^[a-z0-9][a-z0-9-]*$

endpoint

string

requerido

Pattern: ^\/.+$

endpoint_version

integer

requerido

status

enum<string>

requerido

QUEUED o RUNNING: todavía está en curso. COMPLETED: hay una respuesta del proveedor de datos disponible, incluidas las respuestas que no sean 2xx. FAILED: consulta failure. STOPPED: detenido antes del dispatch. Consulta charge_usd por separado de status.

Opciones disponibles:

QUEUED,

RUNNING,

COMPLETED,

FAILED,

STOPPED

failure

object | null

requerido

Motivo por el que falló el Run. Solo es distinto de null cuando status es FAILED.

Show child attributes

input

object

requerido

output

object

requerido

Campos normalizados por acción. La salida nativa del proveedor de datos no se repite aquí; permanece en el Run (GET /v1/runs/:id). Los valores que un proveedor de datos no informa son null; una respuesta vacía tiene la estructura de la acción con todos los campos en null, o items: [], con result_status no_result. El dinero está expresado en USD. Los empleados y los ingresos son estimaciones propias del proveedor de datos; *_range_min / *_range_max son los límites del intervalo del proveedor de datos. Una puntuación del modelo propio de un proveedor de datos lleva el nombre de ese proveedor (exa_similarity_score) y es null para los demás. Las etiquetas como industry, categories, round y category están en el vocabulario del proveedor de datos que responde.

search: total_matches, items[]: domain y los campos del perfil de la empresa; los campos que el proveedor de datos no informa son null
lookup: total_matches, items[]: domain y los campos del perfil de la empresa; los nombres ambiguos devuelven candidatos
enrich: name, website, description, industry, employees, employee_range_min, employee_range_max, founded_year, city, region, country, country_code, linkedin_url, phone, total_funding_usd, revenue_usd, revenue_range_min_usd, revenue_range_max_usd, ownership, ticker, latest_funding_date
tech_stack: items[]: name, categories[], detection_source, predictleads_confidence, first_detected_date, last_detected_date
traffic: monthly_visits, organic_traffic, paid_traffic, organic_keywords, paid_keywords, organic_traffic_value_usd, similarweb_global_rank, bounce_rate, pages_per_visit, avg_visit_duration_seconds
competitors: items[]: domain, name, page_title, position, predictleads_similarity_score, exa_similarity_score, reason
funding: total_funding_usd, items[]: round_date, round, amount_usd, investors[], source_url
news: items[]: title, url, source, published_at, event_date, date_text, category, snippet
jobs: items[]: title, url, location, seniority, categories[], contract_types[], salary_min_usd, salary_max_usd, salary_period, posted_at, first_seen_at, last_seen_at
ads: total_ads, items[]: creative_id, advertiser_id, advertiser_name, format, ad_url, image_url, first_shown_at, last_shown_at

Show child attributes

provider_response

object | null

requerido

No es null únicamente cuando el estado es COMPLETED.

Para respuestas 2xx, output contiene JSON nativo del proveedor de datos (con cualquier estructura), o null si el cuerpo está vacío.
Para respuestas que no sean 2xx, error contiene el cuerpo del error del proveedor de datos y output es null.

Los campos sensibles se eliminan de ambos cuerpos.

Show child attributes

charge_usd

string | null

requerido

Cargo total de los Runs en esta respuesta de Solution. Null hasta que todos los Runs enumerados se hayan liquidado. Cada Run conserva su propio cargo; los fallos también pueden generar cargos.

Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$

charge_basis

object | null

requerido

Base del cargo de un único Run, o null para un total de varios Runs. Consulta runs[].charge_basis para cada cargo.

Show child attributes

stoppable

boolean

requerido

Indica si actualmente se puede aceptar una solicitud de detención. Esto no garantiza que el Run pueda detenerse antes del envío.

stop_requested_at

string<date-time> | null

requerido

Momento en que se solicitó la detención. El Run puede continuar si el envío ya había comenzado.

created_at

string<date-time>

requerido

Marca de tiempo UTC ISO-8601

started_at

string<date-time> | null

requerido

Marca de tiempo UTC ISO-8601

completed_at

string<date-time> | null

requerido

Marca de tiempo UTC ISO-8601

task_id

string | null

requerido

metadata

object

requerido

Tus campos de seguimiento almacenados. Úsalos para filtrar Runs. Nunca se envían al proveedor de datos ni afectan al enrutamiento, Price o la idempotencia.

Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben comenzar por una letra y tener como máximo 40 caracteres.
Valores: cadenas de 1–500 caracteres.
user_id: el ID opaco de tu usuario final, nunca su dirección de correo electrónico ni su nombre.

Show child attributes

action

enum<string>

requerido

Opciones disponibles:

search,

lookup,

enrich,

tech_stack,

traffic,

competitors,

funding,

news,

jobs,

ads

result_status

enum<string>

requerido

Estado de entrega empresarial, independiente del ciclo de vida final del Run en status. no_result es una respuesta vacía pero válida; error significa que no se pudo entregar la salida del proveedor de datos.

Opciones disponibles:

success,

no_result,

error,

pending

error

object | null

requerido

Show child attributes

runs

object[]

requerido

Show child attributes

result_url

string

requerido

Ruta URL autenticada y de solo lectura para consultar este resultado normalizado y el cargo total. Úsala con el origen de la API. No crea Runs ni reanuda el fallback. GET /v1/runs/:id sigue devolviendo el Run individual nativo.

Primeros pasos

Endpoints

Run

Saldo

Fuentes de datos

Solutions

Información sobre empresas

Salida por acción

Encabezados

Cuerpo

Respuesta

​Salida por acción

Encabezados

Cuerpo

Respuesta

Salida por acción