Collectors · Company data

Company data API in Python

One structured company record from a domain — name, description, industry, HQ, socials, contacts, logo. One POST from Python with domain, rows back as JSON with 19 fields, $0.03 per delivered profile. No proxies or parsers to maintain.

Get an API key See the collector

A Python requests snippet that posts { — A Python requests call to the company_profile collector returns one dict per profile, at $0.03 each.

First call

Install, call, read the rows.

pip install requests

The only dependency.

import os, requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/company_profile/run",
    headers={"Authorization": f"Bearer {os.environ['QD_API_KEY']}"},
    json={
        "domain": "quantumproxies.io",
        "use_ai": True,
    },
    timeout=120,
)
r.raise_for_status()
run = r.json()["payload"]
print(run["count"], "rows,", run["cost"]["usd"], "USD")
for row in run["results"]:
    print(row.get("domain"), row.get("url"), row.get("name"), row.get("tagline"))

Python: one Company profile run (Profile a domain), printing domain, url, name, tagline

The key comes from an environment variable, never from the code. The run answers in the same request when it finishes in time; payload.results holds the rows and payload.cost what they cost.

Request parameters

What the collector takes.

Input of the Company profile collector
Parameter	Type	Required	Meaning
`domain`	string	yes	Company domain or site URL.
`country`	string	no	ISO 3166-1 alpha-2 code — proxy exit geo and Google locale (gl). Omit for the default pool.
`use_ai`	boolean	no (default true)	Use the LLM to fill description, industry, founded and headquarters from the pages. Off = deterministic fields only.

Response fields

19 fields per profile.

Fields of each row (profile)
Field	Type	What it holds
`domain`	string	Registrable host.
`url`	string	Homepage URL fetched.
`name`	string, nullable	Company / brand name.
`tagline`	string, nullable	Short positioning line.
`description`	string, nullable	What the company does (meta description or AI).
`logo`	string, nullable	Logo URL (JSON-LD / og:image).
`industry`	string, nullable	Industry / sector (AI).
`founded`	string, nullable	Founding year (JSON-LD / AI).
`headquarters`	string, nullable	HQ city/country (JSON-LD / AI).
`addresses`	string[]	Postal addresses found.
`emails`	string[]	Emails found.
`phones`	string[]	Phones found.
`socials`	object	{ facebook, instagram, linkedin, twitter, youtube, tiktok } URLs.
`language`	string, nullable	Site language.
`pages_used`	string[]	Pages fetched.
`ai_used`	boolean	Whether AI completion ran.
`legal_name`	string, nullable	Registered company name, when the site states it in its structured data.
`vat_id`	string, nullable	VAT number: from the site's structured data, or the Italian Partita IVA printed on its pages.
`employees`	integer, nullable	Employee count, when the site states it in its structured data.

Add ?format=csv to the runs endpoint to get the same rows as CSV.

Long runs

Run in the background, then poll.

A run that needs more time can go to the background: send "async": true, get 202 with the run id, and poll the runs endpoint until the status is done. Reading a run is free.

import os, time, requests

H = {"Authorization": f"Bearer {os.environ['QD_API_KEY']}"}
r = requests.post("https://api.quanticdata.io/v1/scraper/collectors/company_profile/run", headers=H,
                  json={**{"domain":"quantumproxies.io","use_ai":True}, "async": True}, timeout=30)
run_id = r.json()["payload"]["run_id"]
while True:
    run = requests.get(f"https://api.quanticdata.io/v1/scraper/collectors/runs/{run_id}", headers=H, timeout=30).json()["payload"]
    if run["status"] in ("done", "failed"):
        break
    time.sleep(5)
print(run["status"], run["count"])

Python: background run and polling

Errors

What can come back, and what is billed.

Collector run errors
Status	Meaning	Billed
`400`	The input does not match the collector (`payload.errors`)	No
`401`	Missing or wrong API key	No
`402`	Balance and free credit do not cover the run: top up	No
`422`	The input can never resolve; retrying the same input cannot help	No
`424`	The run failed at the source (blocked, timed out, layout changed); safe to retry	No
`429`	Rate limit or a per-account brake; wait for `Retry-After`	No

Only delivered rows are billed: a run that delivers nothing costs nothing.

Price

$0.03 per delivered profile.

What Company profile rows cost at list price
Rows	Cost
1	$0.03
1,000	$30.00
10,000	$300.00

Up to 1 profiles per run; split larger jobs into several runs. The $2 free credit every month covers about 66 profiles. No subscription; paid tiers lower the unit price. All collector prices: collector pricing.

Before you run it

Questions developers ask

Is there a free Company profile API?

Every account gets $2 of free usage each month, about 66 profiles of this collector at $0.03 each, with no card.

Do I have to handle proxies, retries or blocks?

No. The collector runs on our network and handles them; a run blocked at the source returns 424 and is not billed.

How many rows can one run return?

Up to 1 profiles per run (the max_results input, where the collector has one).

Can an AI agent run it?

Yes: the MCP server exposes it as the run_collector tool, with the same input and price. See the MCP server.

Run it on the free credit.

Create an API key, export it as QD_API_KEY and run the example. $0.03 per delivered profile, no subscription.

Get an API key Company data API