Skip to main content
POST
Find companies by the markup on their website.

Authorizations

X-API-Key
string
header
required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Body

application/json

HTML terms to search for and paging options

Find companies by markup in their website's live HTML

companyId
string
required

Company ID

searchTerms
string[]
required

Up to 10 HTML terms to match against tags, attributes and their content. A script src path ("/widget.js"), a vendor host ("cdn.customgpt.ai") or any markup snippet works. Matched against the site's raw source, so the site's own domain is irrelevant — this is how you find every site carrying a given widget or tech.

keywords
string[]

Optional: up to 10 keywords that must also appear in the page title, description or meta keywords, to narrow the results.

mode
string

"entry" (default, order-insensitive) or "strict_entry" (exact match).

limit
integer

Rows to return, 1-1000 (default 100). Billed per result.

offset
integer

Row offset for pagination, 0-9999 (default 0).

excludeIps
boolean

Drop bare-IP hosts (crawl noise). Default true.

Response

Matching domains, total available, and credits charged

Matching domains plus the total available and credits charged

items
object[]

Matching domains, ranked by authority

total
integer

Total domains matching across the full index (for pagination)

creditCost
number

Credits charged (actual vendor cost)