Skip to main content
POST
Company intelligence
Every action returns normalized output. The Provider’s native output is not repeated there; it stays on the Run and is readable with Get Run. enrich and traffic expose fixed top-level fields; tech_stack, competitors and news expose output.items[]; funding exposes total_funding_usd plus items[]. A value the selected Provider does not report is null; Glasser does not fill it in. Money is always USD. Read result_status separately from status: success, no_result, error or pending. An empty but valid answer is no_result and keeps the action’s shape: every field is null, or items is []. charge_usd totals this response’s runs and is null until all Runs settle. With provider: auto, fallback can create multiple Runs, each listed in runs[] with its own charge. For a pending Similarweb lookup (traffic via Apify, HTTP 202), follow the authenticated result_url. See Provider selection and charges.

​
Output by action

Every field is present on every row; a value the Provider does not report is null. Fields follow the field conventions.
  • employees and the revenue fields are the Provider’s own estimates. revenue_usd is a single figure; when a Provider only gives a bucket, it is null and the bucket edges are in revenue_range_min_usd / revenue_range_max_usd. employee_range_min / employee_range_max work the same way. An open-ended bucket such as 10000+ has a null maximum.
  • country is an English display name and country_code an ISO 3166-1 alpha-2 code. ownership is one of public, private, nonprofit, government, education, other, or null; private is never inferred.
  • Scores from a Provider’s own model carry its name and are null for the others: predictleads_similarity_score (0–1), exa_similarity_score (Exa’s neural similarity), predictleads_confidence (0–1), similarweb_global_rank (1 = most visited). position is the 1-based order in the Provider’s answer.
  • competitors via Exa returns web pages, not company records: name is null and the page title is in page_title. Rows from the company’s own domain and its subdomains are left out.
  • monthly_visits is worldwide (Similarweb). organic_traffic, paid_traffic and the keyword counts are for the request country (default us). bounce_rate is a fraction 0–1.
  • Dates: *_date and event_date are YYYY-MM-DD, published_at is ISO 8601 UTC, and date_text is Google News display text exactly as returned. LeadMagic funding dates have month precision (day 01).
  • industry, categories, round and category are labels in the answering Provider’s own vocabulary and are not comparable across Providers.

Headers

​
idempotency-key
string
required

Generate a unique value for each intended execution (a UUID is recommended). Retry with the same key and execution parameters to retrieve the original Run without a second charge. Changing execution parameters with the same key returns 409; changing task_id or metadata does not update the original Run.

Minimum string length: 1

Body

application/json
​
domain
string
required

A website domain such as stripe.com. A full URL is accepted and reduced to its host.

Required string length: 3 - 253
​
action
enum<string> | null

Default: enrich. All actions require domain.

  • enrich: company profile and firmographics.
  • tech_stack, traffic, funding, news: the corresponding company data.
  • competitors: similar businesses. For competing domains in Google results, use SEO research with organic_competitors.
Available options:
enrich,
tech_stack,
traffic,
competitors,
funding,
news
​
provider
enum<string> | null

Default auto: select the first eligible Provider in Glasser's preference order. A named Provider must support the request and be allowed by your Key; it does not fall back to another Provider. Available values are listed below.

Available options:
auto,
apollo,
pdl,
hunter,
prospeo,
predictleads,
leadmagic,
builtwith,
dataforseo,
ahrefs,
apify,
exa,
serper
​
country
string | null

Country as a two-letter ISO code or a country name, e.g. us, gb, de, Germany. Default us. An unsupported country is refused with the supported list.

Required string length: 2 - 60
​
query
string | null

For news via Serper only: the company name to search Google News by, instead of the domain. Other actions and providers ignore it.

Required string length: 1 - 200
​
limit
integer | null

Rows to return. Keep it small: the routed Endpoint's charge rule may read it. Each capability caps it further.

Required range: 1 <= x <= 100
​
task_id
string | null

Group related Runs, including automatic fallback, under one Task. Reuse a stable string and filter the Runs list by task to retrieve them.

​
metadata

Optional tracking fields, returned on the Run and available as filters. They never go to the Provider or affect routing, Price, or idempotency.

  • Up to 20 keys: lowercase letters, digits, and underscores; start with a letter; at most 40 characters.
  • Values: strings of 1–500 characters.
  • user_id: your End user's opaque ID, never their email address or name.

Invalid entries are dropped whole, not truncated. The request continues, and the Run returns the fields that were stored.

Response

Success

​
id
string
required
​
run_url
string
required

Open this Run in the console. Requires Workspace membership.

​
provider
string
required
Pattern: ^[a-z0-9][a-z0-9-]*$
​
endpoint
string
required
Pattern: ^\/.+$
​
endpoint_version
integer
required
​
status
enum<string>
required

QUEUED or RUNNING: still in progress. COMPLETED: a Provider response is available, including non-2xx responses. FAILED: read failure. STOPPED: stopped before dispatch. Read charge_usd separately from status.

Available options:
QUEUED,
RUNNING,
COMPLETED,
FAILED,
STOPPED
​
failure
object | null
required

Why the Run failed. Non-null only when status is FAILED.

​
input
object
required
​
output
object
required

Normalized fields per action. The Provider's native output is not repeated here; it stays on the Run (GET /v1/runs/:id). Values a Provider does not report are null; an empty answer is the action's shape with every field null, or items: [], with result_status no_result. Money is USD. Employees and revenue are the Provider's own estimates; *_range_min / *_range_max are the edges of the Provider's bucket. A score from a Provider's own model is named after the Provider (exa_similarity_score) and is null for the others. Labels such as industry, categories, round and category are in the answering Provider's vocabulary.

  • 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
​
provider_response
object | null
required

Non-null only when status is COMPLETED.

  • For 2xx responses, output contains Provider-native JSON (any shape), or null for an empty body.
  • For non-2xx responses, error contains the Provider's error body and output is null.

Sensitive fields are removed from both bodies.

​
charge_usd
string | null
required

Total charge of runs in this Solution response. Null until all listed Runs settle. Each Run retains its own charge; failures can also be charged.

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

Single-Run charge basis, or null for a multi-Run total. Read runs[].charge_basis for each charge.

​
stoppable
boolean
required

Whether a stop request can currently be accepted. This does not guarantee that the Run can stop before dispatch.

​
stop_requested_at
string<date-time> | null
required

When a stop was requested. The Run can still continue if dispatch had already started.

​
created_at
string<date-time>
required

ISO-8601 UTC timestamp

​
started_at
string<date-time> | null
required

ISO-8601 UTC timestamp

​
completed_at
string<date-time> | null
required

ISO-8601 UTC timestamp

​
task_id
string | null
required
​
metadata
object
required

Your stored tracking fields. Use them to filter Runs. They never go to the Provider or affect routing, Price, or idempotency.

  • Up to 20 keys: lowercase letters, digits, and underscores; start with a letter; at most 40 characters.
  • Values: strings of 1–500 characters.
  • user_id: your End user's opaque ID, never their email address or name.
​
action
enum<string>
required
Available options:
enrich,
tech_stack,
traffic,
competitors,
funding,
news
​
result_status
enum<string>
required

Business delivery status, independent of the final Run lifecycle in status. no_result is an empty but valid answer; error means the Provider output could not be delivered.

Available options:
success,
no_result,
error,
pending
​
error
object | null
required
​
runs
object[]
required
​
result_url
string
required

Authenticated, read-only URL path for polling this normalized result and total charge. Use with the API origin. Does not create Runs or resume fallback. GET /v1/runs/:id still returns the native, individual Run.