Company signals, inside your assistant

Fokals answers questions about companies: the technology a company runs, the roles it is hiring for, the buying topics it shows signs of, what it has announced and how its website has changed. There are two ways to ask, and they are one product: the same account, the same prepaid balance, the same prices and the same tools.

Two ways in

Getting started

1. Create your account at https://www.fokals.com/signup. It opens with $1 of credit.
2. To use an assistant: in its settings, add a custom connector with the address https://mcp.fokals.com/mcp, and sign in when it asks.
3. To use the API: create a key on your account page and send it with every request.

curl https://api.fokals.com/v1/account \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://api.fokals.com/v1/find_companies \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"technology":"HubSpot","hiring":true,"country":"US","limit":10}'

A key is shown once, when it is made. Keep it out of anything you share; a key you no longer trust can be revoked on the account page at once.

Prices

You pay for the companies you get, from a balance you add to by card. These are the standard prices; GET https://api.fokals.com/v1/prices gives today’s, with no key.

Each kind is counted on its own, from the first of each calendar month (UTC). A call that crosses a step pays the lower price only past it.

A call that would cost more than $0.25 does not run: it answers with its price. Send it again with max_usd set to what you agree to pay. Funds are good for 12 months from the day they are added, the oldest spent first. For more than 50,000 profiles a month, a data licence costs less: https://www.fokals.com/contact.

Limits

Answers and errors

An assistant is answered in a sentence or two, followed by the data as JSON. The API answers with the same two things apart:

{ "message": "What was done, in a sentence or two.", "data": { } }

When a call is not answered, the API says why with a status and { "error": { "code", "message" } }:

The whole API is described for a program at https://api.fokals.com/v1/openapi.json.

What the data holds

Companies, and what they publish: their websites, job boards, newsrooms and regulatory filings. Every fact carries the date it was observed. Fokals holds companies only: no people and no contact details.

The tools

Find companies by signal

find_companies · $0.04 a company, $0.08 by buying topic

Finds companies by what they show: a technology they run, a buying topic they show signs of, whether they are hiring, an announcement they made lately (funding, a launch, a partnership, a leadership change), their industry, business model or country, and how lately their website changed. The companies whose website changed most lately come first. Each company comes with its website, industry, technologies, open roles and buying topics. Give at least one filter; count_companies says how many match, free, before this is called. At most 100 companies a call. Costs $0.04 ($0.02 past 10,000 in a calendar month, $0.01 past 100,000) for each company returned; $0.08 ($0.05 past 10,000 in a calendar month) for each company when a buying topic is among the filters, taken from the person's prepaid balance; a company that is not held costs nothing. A company this account has paid for is free to it again for 30 days in an answer of the same kind or a cheaper one: a profile covers the company's list rows, a list row does not cover a profile. A call that costs more than $0.25 returns its price instead of running: tell the person the price and call again with max_usd once they agree.

Example:

POST https://api.fokals.com/v1/find_companies
{
  "technology": "HubSpot",
  "hiring": true,
  "country": "US",
  "limit": 10
}

Count companies

count_companies · Free

Counts the companies that match a set of filters, and says what it would cost to get them. Free. Takes the same filters as find_companies. Use it before find_companies, so the person knows the size and the price of what they are asking for.

Example:

POST https://api.fokals.com/v1/count_companies
{
  "technology": "HubSpot",
  "hiring": true,
  "country": "US"
}

Enrich a list of companies

enrich_companies · $0.04 a company

Takes the person's own list of companies, by website address or name, and returns what is held on each: industry and business model, the technologies its website runs, open roles and hiring in the last 30 days, buying topics it shows signs of, and when its website last changed. Use it to fill in, score or rank a list of accounts, leads or customers. A website address finds a company more surely than a name. At most 100 companies a call; send a longer list in parts. Costs $0.04 ($0.02 past 10,000 in a calendar month, $0.01 past 100,000) for each company returned, taken from the person's prepaid balance; a company that is not held costs nothing. A company this account has paid for is free to it again for 30 days in an answer of the same kind or a cheaper one: a profile covers the company's list rows, a list row does not cover a profile. A call that costs more than $0.25 returns its price instead of running: tell the person the price and call again with max_usd once they agree.

Example:

POST https://api.fokals.com/v1/enrich_companies
{
  "companies": [
    "stripe.com",
    "shopify.com"
  ]
}

Company profile

company_profile · $0.10 a profile

One company in depth: what it sells and to whom, every technology its website runs and since when, its open roles by function, seniority and country with the latest postings, the buying topics it shows signs of with the signals behind them, its latest announcements by type, the latest changes on its website, and how its traffic ranks. Use it to research an account before a call, to explain why a company is on a list, or to compare companies. Costs $0.10 ($0.06 past 10,000 in a calendar month) for the profile, taken from the person's prepaid balance; a company that is not held costs nothing. A company this account has paid for is free to it again for 30 days in an answer of the same kind or a cheaper one: a profile covers the company's list rows, a list row does not cover a profile. A call that costs more than $0.25 returns its price instead of running: tell the person the price and call again with max_usd once they agree. For more than 50,000 profiles a month a data licence costs less.

Example:

POST https://api.fokals.com/v1/company_profile
{
  "company": "stripe.com"
}

What changed at my companies

company_changes · $0.04 a company

What is new at the person's own companies since a date: changes on each website (a technology added or dropped, a new market, language, currency, page or app) and the company's announcements by type (funding, launches, partnerships, leadership changes, expansion). Use it for a weekly check on a list of accounts, or to find a timely reason to get in touch. A company with nothing new costs nothing and is named as such. At most 100 companies a call. Costs $0.04 ($0.02 past 10,000 in a calendar month, $0.01 past 100,000) for each company returned, taken from the person's prepaid balance; a company that is not held costs nothing. A company this account has paid for is free to it again for 30 days in an answer of the same kind or a cheaper one: a profile covers the company's list rows, a list row does not cover a profile. A call that costs more than $0.25 returns its price instead of running: tell the person the price and call again with max_usd once they agree.

Example:

POST https://api.fokals.com/v1/company_changes
{
  "companies": [
    "stripe.com",
    "shopify.com"
  ],
  "since": "2026-10-01"
}

Search job postings

search_job_postings · $0.04 a company

Searches the open job postings of companies: by words in the title, function, seniority, country, remote or on site, a technology the posting asks for, the hiring company's industry, pay, and how lately the posting appeared. The latest postings come first, each with its company, function, seniority, pay where stated, and link. Use it to find who is hiring for a role, to spot a team being built, or to check hiring at a list of accounts. Give at least one filter. Costs $0.04 ($0.02 past 10,000 in a calendar month, $0.01 past 100,000) for each company returned, taken from the person's prepaid balance; a company that is not held costs nothing. A company this account has paid for is free to it again for 30 days in an answer of the same kind or a cheaper one: a profile covers the company's list rows, a list row does not cover a profile. A call that costs more than $0.25 returns its price instead of running: tell the person the price and call again with max_usd once they agree. A posting itself is not charged: the price is for each company the postings belong to.

Example:

POST https://api.fokals.com/v1/search_job_postings
{
  "title": "data engineer",
  "country": "US",
  "work_mode": "remote",
  "limit": 10
}

Similar companies and competitors

similar_companies · $0.04 a company

Finds companies like a given one, the most alike first, each with what it shares with the one given: the labels in common (business model, offering, customer size, pricing, growth stage, home country) and the technologies in common. Ask for lookalikes to grow a list from a best customer, or for competitors to see who sells the same kind of thing to the same kind of customer. The company given is not charged. At most 100 companies a call. Costs $0.04 ($0.02 past 10,000 in a calendar month, $0.01 past 100,000) for each company returned, taken from the person's prepaid balance; a company that is not held costs nothing. A company this account has paid for is free to it again for 30 days in an answer of the same kind or a cheaper one: a profile covers the company's list rows, a list row does not cover a profile. A call that costs more than $0.25 returns its price instead of running: tell the person the price and call again with max_usd once they agree.

Example:

POST https://api.fokals.com/v1/similar_companies
{
  "company": "shopify.com",
  "kind": "lookalikes",
  "limit": 10
}

Customers, partners, integrations and investors

company_connections · $0.04 a company

The other companies a company's own website names, and as what: its customers, partners, integrations and investors, each by website and, where held, by name. And the reverse: the companies whose websites name this one, and as what, which shows whose customer or partner it is. Taken from links a page puts under a heading of its own ("Trusted by", "Our partners", "Integrations", "Backed by") and seen in the last 60 days; a company whose pages name nobody that way has none. Only the company asked about is charged. Costs $0.04 ($0.02 past 10,000 in a calendar month, $0.01 past 100,000) for each company returned, taken from the person's prepaid balance; a company that is not held costs nothing. A company this account has paid for is free to it again for 30 days in an answer of the same kind or a cheaper one: a profile covers the company's list rows, a list row does not cover a profile. A call that costs more than $0.25 returns its price instead of running: tell the person the price and call again with max_usd once they agree.

Example:

POST https://api.fokals.com/v1/company_connections
{
  "company": "stripe.com"
}

Which company is meant

identify_company · Free

Lists the companies a name or a website address could mean, the surest first, each with its website, country, industry and whether it has been read. Free. Use it when a name is ambiguous or a paid tool said a company is not held, then pass the id of the right one to the other tools. A company that is not held at all can be asked for with request_company.

Example:

POST https://api.fokals.com/v1/identify_company
{
  "company": "Stripe"
}

Market breakdown

market_breakdown · $0.05 a question

Answers a question about a market as a whole: how the companies that match a set of filters divide by one attribute (industry, business_model, country, growth_stage, customer_size, price_tier, sales_motion, pricing_model, region, sic, technology, buying_topic), with the number of companies under each value and the total. Takes the same filters as find_companies, or none for every company held. Use it to size a segment, to see which technologies or buying topics lead in an industry, or which countries a kind of company is in. It returns counts, not companies. Costs $0.05 a question, whatever its size, taken from the person's prepaid balance; a question nothing matches costs nothing.

Example:

POST https://api.fokals.com/v1/market_breakdown
{
  "technology": "Shopify",
  "by": "country",
  "limit": 10
}

List filter values

list_filters · Free

Lists the values find_companies and count_companies filter by, with the number of companies under each where it is known: technologies (search by name), buying topics, industries, business models, countries (by the head office's country where it is known, otherwise the main market the company's website serves), and the types of announcement. Free.

Example:

POST https://api.fokals.com/v1/list_filters
{
  "kind": "buying_topics",
  "search": "marketing",
  "limit": 20
}

Ask for a company to be added

request_company · Free · changes what your account holds

Asks Fokals to add a company it does not hold yet, by the company's own website address. Free. The website is checked and, if it is a company website in the languages Fokals covers, read: that can take a few days, after which the other tools return it. The answer says where the company stands: held already, asked for, or outside what is covered.

Example:

POST https://api.fokals.com/v1/request_company
{
  "website": "example.com"
}

Report a problem

report_problem · Free · changes what your account holds

Sends a report to the people who run Fokals: data that is wrong or missing for a company, a tool that did not work, or an idea. Free. Use it when the person says an answer was wrong, and tell them it was sent.

Example:

POST https://api.fokals.com/v1/report_problem
{
  "kind": "wrong_data",
  "message": "The head office is listed in the wrong country.",
  "company": "example.com"
}

Enrich a long list into a file

enrich_to_file · $0.04 a company · changes what your account holds

Enriches a long list of the person's own companies and hands the result over as a spreadsheet file (CSV) instead of an answer: one line a company, with its industry, business model, every technology, open roles, buying topics and dates. Up to 10,000 companies a call. The person downloads the file signed in on their account page, for 7 days. Use enrich_companies instead when the list fits in an answer (100 companies). Costs $0.04 ($0.02 past 10,000 in a calendar month, $0.01 past 100,000) for each company returned, taken from the person's prepaid balance; a company that is not held costs nothing. A company this account has paid for is free to it again for 30 days in an answer of the same kind or a cheaper one: a profile covers the company's list rows, a list row does not cover a profile. A call that costs more than $0.25 returns its price instead of running: tell the person the price and call again with max_usd once they agree.

Example:

POST https://api.fokals.com/v1/enrich_to_file
{
  "companies": [
    "stripe.com",
    "shopify.com",
    "hubspot.com"
  ]
}

Watch companies

watch_companies · Free · changes what your account holds

Watches a list of the person's own companies and emails them what is new: website changes and announcements, every week or every day. Setting a watch is free. Each digest then costs $0.04 ($0.02 past 10,000 in a calendar month, $0.01 past 100,000) for each company with something new, and nothing when nothing is new, taken from the prepaid balance without asking again and outside the monthly limit: say so, and set a watch only when the person has agreed to that. Up to 1,000 companies an account.

Example:

POST https://api.fokals.com/v1/watch_companies
{
  "companies": [
    "stripe.com",
    "shopify.com"
  ],
  "every": "week"
}

Stop watching companies

unwatch_companies · Free · changes what your account holds

Stops watching the companies named, or all of them, so no more digests are sent or charged for them. Free.

Example:

POST https://api.fokals.com/v1/unwatch_companies
{
  "companies": [
    "shopify.com"
  ]
}

Watched companies and the latest digest

watched_companies · Free

Lists the companies the account watches, how often it is sent what is new, and the latest digest with what it held and cost. Free: a digest was paid for when it was sent.

It takes no inputs.

Example:

POST https://api.fokals.com/v1/watched_companies
{}

Balance and prices

account_balance · Free

The person's prepaid balance and the dates it expires, what they have spent this month and on which tools, their monthly spending limit, the prices, and where to add funds. Free.

It takes no inputs.

Example:

POST https://api.fokals.com/v1/account_balance
{}

Terms and support

Use of the connector and the API is under the Terms of Service: for your own business use, and not for resale. To embed the data in a product, to redistribute it or to receive it in bulk, talk to an expert about a data licence. How personal data is handled is in the Privacy notice.

The licensed data feeds and bulk files have a reference of their own: the API reference.

Something wrong or missing: use the tool report_problem, or write to us through the contact page.