> ## Documentation Index
> Fetch the complete documentation index at: https://usefoil.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Attribution labels

> Every value Foil returns in session attribution labels, by kind: actors, hosted browser providers, AI agents, tools, purposes, environments, trust, and evasion.

Attribution labels describe what Foil found behind a session. Each label has a `kind` and a `value`, and this page lists the values each kind can take. For where attribution appears in the API and webhooks, and how its shape differs between them, see [Verdicts & scoring](https://usefoil.com/docs/verdicts-and-scoring.md#attribution). The same lists are available as JSON at [`attribution.json`](https://usefoil.com/docs/attribution.json).

> [!NOTE]
>
> Foil adds values as it learns to recognize new clients, and adding a value is not a breaking change. Treat `value` as an open string: store values you don't recognize, and include a default branch wherever you switch on one. See [Versioning](https://usefoil.com/docs/api-reference/versioning.md).

A session can carry several labels, including more than one label of the same kind. Foil names each kind from its own evidence, so the kinds are independent of each other. For example, a session from Muse's hosted browser carries `provider: meta-muse` for the hosted browser and `actor: ai-agent` for the type of client. To find a particular AI agent, match on the labels in [AI agents and agent browsers](#ai-agents-and-agent-browsers).

## Actor

The `actor` label says what type of client is behind the session.

| Value | Meaning |
| - | - |
| `automation` | A browser driven by automation software or a script. |
| `ai-agent` | An AI agent acting for a person. Foil names it from the agent's verified signature, the token its user agent sends, its browser extension or app browser, or a hosted browser that runs only that agent. |
| `crawler` | A crawler, fetcher, monitor, or other bot that identifies itself in its user agent, or that connects from its operator's crawler or monitoring network. See [Crawlers that send a browser user agent](#crawlers-that-send-a-browser-user-agent) and [Monitors and test devices named by their network](#monitors-and-test-devices-named-by-their-network). |
| `unknown` | A bot whose type Foil couldn't determine. |

A verified Web Bot Auth signature doesn't set an `actor` value. It adds `trust: verified` and names the signing domain in a `product` label, and the `actor` comes from what the signer is, such as `ai-agent` for an AI agent's signing domain. To find verified bots, match on `trust: verified`.

## Provider

The `provider` label names the hosted browser, scraping service, or device farm the session ran in, when Foil recognizes it.

Foil recognizes a provider from the browser it runs, and for some providers also from the network the session leaves through. The same browser on another network then carries no `provider` label. Firebase Test Lab is named from its network alone. A `provider` label doesn't set the verdict: a session from a recognized provider can still score `inconclusive`, so decide on the verdict and treat the label as context.

| Value | Display label | What it is |
| - | - | - |
| `meta-muse` | Muse | Meta's Muse AI agent |
| `instinct` | Instinct | Instinct AI agent |
| `dot` | Dot | OpenAI's Dot agents |
| `grok-bot` | Grok Bot | xAI's Grok Bot agent |
| `grok` | Grok | xAI's Grok assistant, running a task in its headless browser |
| `perplexity-computer` | Perplexity Computer | Perplexity's Computer AI agent |
| `hark` | Hark | Hark AI agent |
| `pally` | Pally | Pally AI assistant |
| `browser-use-cloud` | Browser Use Cloud | Browser Use's cloud browser for AI agents |
| `anchor` | Anchor Browser | Cloud browser |
| `boat` | Boat | Cloud desktop for AI agents |
| `browserbase` | Browserbase | Cloud browser |
| `browserless` | Browserless | Cloud browser |
| `driverdev` | Driver.dev | Cloud browser, which Browser Cash also runs on |
| `firebase-test-lab` | Firebase Test Lab | Google's app testing devices, which also run Google Play's pre-launch reports |
| `hyperbrowser` | Hyperbrowser | Cloud browser |
| `onkernel` | Kernel | Cloud browser |
| `notte` | Notte | Cloud browser for AI agents |
| `steel` | Steel | Cloud browser |
| `tilion` | Tilion | Cloud browser for AI agents |
| `tinyfish` | TinyFish | Cloud browser for AI agents |
| `apify` | Apify | Scraping service |
| `context-dev` | Context.dev | Scraping service |
| `firecrawl` | Firecrawl | Scraping service |
| `geonode` | Geonode | Scraping service |
| `scrape-do` | Scrape.do | Scraping service |
| `scrapfly` | Scrapfly | Scraping service |
| `scrapingbee` | ScrapingBee | Scraping service |
| `usestring` | String | Scraping service |
| `zenrows` | ZenRows | Scraping service |
| `zyte` | Zyte | Scraping service |

Sessions scored before October 29, 2026 can carry `chatgpt-agent` for Dot's hosted browser.

## AI agents and agent browsers

Foil names an AI agent or agent browser with a `provider` or a `product` label. This table lists the labels that name each one and the evidence behind them. A signature is a verified Web Bot Auth signature on the request.

A hosted browser that runs only one AI agent also adds `actor: ai-agent`. These are the hosted browsers of Muse, Instinct, Dot, Grok Bot, Grok, Perplexity Computer, and Hark. A hosted browser that also runs scrapers, such as Browserbase or Kernel, names only the platform and doesn't add an `actor` label. Pally runs in Kernel's browser with a setup of its own, so a session with that setup is named `pally` and also carries `actor: ai-agent`.

| Agent | Label | Evidence |
| - | - | - |
| Muse | `product: muse.ai` | Signature |
| Muse | `provider: meta-muse` | Hosted browser |
| Instinct | `provider: instinct` | Hosted browser |
| Dot (OpenAI) | `product: chatgpt.com` | Signature |
| Dot (OpenAI) | `provider: dot` | Hosted browser |
| Dot (OpenAI) | `provider: chatgpt-agent` | Hosted browser, on sessions scored before October 29, 2026 |
| Grok Bot (xAI) | `product: cursorusercontent.com` | Signature |
| Grok Bot (xAI) | `provider: grok-bot` | Hosted browser |
| Grok (xAI) | `provider: grok` | Headless browser and its exit network |
| Perplexity Computer | `provider: perplexity-computer` | Hosted browser |
| Google-Agent | `product: google-agent` together with `product: agent.bot.goog` | Signature |
| Google-Agent | `product: agent.bot.goog` together with `actor: ai-agent` | Signature |
| Google-Agent | `product: google-agent` | User agent |
| Google-Agent | `product: googleagent-mariner` | User agent |
| Claude (Anthropic) | `product: claude-agent` | User agent |
| Claude computer use | `product: claude-desktop-browser` | The Claude app's built-in browser |
| Claude computer use | `product: claude-in-chrome` | Claude in Chrome |
| Claude computer use | `product: claude-computer-use` | Claude in Chrome, on sessions scored before October 29, 2026 |
| ChatGPT computer use | `product: chatgpt-in-chrome` | ChatGPT's Chrome extension |
| ChatGPT computer use | `product: chatgpt-in-app-browser` | The ChatGPT app's built-in browser |
| Muse computer use | `product: muse-in-chrome` | Muse's Chrome extension |
| Manus | `product: manus-user` | User agent |
| Manus | `product: manus-desktop-browser` | The Manus app's built-in browser |
| Manus | `product: manus-cloud-browser` | Manus's cloud browser |
| Nova Act (Amazon) | `product: novaact` | User agent |
| Buy for Me (Amazon) | `product: amazonbuyforme` | User agent |
| AgentCore Browser (Amazon) | `product: amazon-bedrock-agentcore-browser` | User agent |
| Twin | `product: twinagent` | User agent |
| Hark | `provider: hark` | Hosted browser |
| Pally | `provider: pally` | Hosted browser |
| Browser Use | `provider: browser-use-cloud` | Hosted browser |
| Cloudflare Browser Rendering | `product: web-bot-auth.cloudflare-browser-rendering-085.workers.dev` | Signature |
| Cloudflare Browser Rendering | `product: cloudflare-browser-rendering` | User agent |
| Anchor Browser | `product: anchor-browser` | User agent |
| Anchor Browser | `provider: anchor` | Hosted browser |
| Browserbase | `provider: browserbase` | Hosted browser |
| Kernel | `provider: onkernel` | Hosted browser |
| Steel | `provider: steel` | Hosted browser |
| Hyperbrowser | `provider: hyperbrowser` | Hosted browser |
| Browserless | `provider: browserless` | Hosted browser |
| TinyFish | `provider: tinyfish` | Hosted browser |
| Tilion | `provider: tilion` | Hosted browser |
| Notte | `provider: notte` | Hosted browser |
| Driver.dev | `provider: driverdev` | Hosted browser and its exit network |
| Boat | `provider: boat` | Hosted desktop |
| Comet (Perplexity) | `product: comet` | Comet browser |
| Aside | `product: aside` | Aside's bundled browser runtime |
| Cursor | `product: cursor-browser` | Cursor's built-in browser |
| Lovable | `product: lovable-browser` | The Lovable app's built-in browser |
| Visual Studio Code | `product: vscode-browser` | Visual Studio Code's built-in browser |
| Antigravity | `product: antigravity-browser` | Antigravity's built-in browser |
| Abacus.AI Desktop | `product: abacus-ai-desktop-browser` | The Abacus.AI Desktop app's built-in browser |
| T3 Code | `product: t3-code-browser` | The T3 Code app's built-in browser |
| Paseo | `product: paseo-browser` | The Paseo app's built-in browser |
| Intent | `product: intent-browser` | The Intent app's built-in browser |
| ZCode | `product: zcode-browser` | The ZCode app's built-in browser |
| OpenCode | `product: opencode-browser` | The OpenCode desktop app's built-in browser |
| Hermes Agent | `product: hermes-browser` | The Hermes Agent app's built-in browser |
| OpenChamber | `product: openchamber-browser` | The OpenChamber app's built-in browser |
| Superset | `product: superset-browser` | The Superset app's built-in browser |
| Orca | `product: orca-browser` | The Orca app's built-in browser |
| Tenslo Code | `product: tenslo-code-browser` | The Tenslo Code app's built-in browser |

`product: comet` names the browser, not who was using it, so a person browsing in Comet carries it too. It comes with `organization: Perplexity` and no `actor` label. Foil can name Comet only where its script runs in the top-level page, not inside an embedded frame.

`product: aside` identifies Aside from its bundled browser runtime. It carries no `actor` label because a person browsing in Aside produces the same evidence as its assistant. Missing or blocked runtime evidence is inconclusive.

The AI coding app labels, from `product: cursor-browser` to `product: tenslo-code-browser`, work the same way. Each names the app's built-in browser or web preview from the user agent it sends, which the app's agent and the developer both use, so none comes with an `actor` label. Where a company makes the app, the label comes with its `organization`, such as `organization: Anysphere` for Cursor or `organization: Microsoft` for Visual Studio Code. The user agent reaches embedded frames, so Foil names these browsers there too.

## Crawlers that send a browser user agent

Some crawlers, such as the ones that build link previews and review ads, render pages in a full browser and send that browser's ordinary user agent, so nothing in the request names them. Foil names them from the network the browser connects from when that network belongs to the crawler's operator.

| Operator | Labels | Network |
| - | - | - |
| Google | `actor: crawler`, `organization: Google`, `product: google` | The common and special-case crawler ranges that Google publishes |
| Meta | `actor: crawler`, `organization: Meta`, `product: meta` | Meta's own network, AS32934 |

Foil adds these labels only when no other label already names the client. A session whose user agent names the crawler, such as Googlebot or facebookexternalhit, keeps the labels from its user agent instead, and a session with a `provider` label or an AI agent label doesn't get them. Google's ranges leave out Google Cloud customers, the fetchers Google runs at a user's request, and Google-Agent, so a site hosted on Google Cloud or a person on a Google-run VPN or relay doesn't get these labels. Muse connects through other networks and doesn't get them either.

These labels don't change the verdict. They can appear next to `actor: automation` and a `tool` label, which describe how the crawler drove its browser.

## Monitors and test devices named by their network

Some synthetic monitors run an ordinary browser and send its usual user agent, and apps under test run on phones in a device farm. Foil names both from the network they connect from.

| Service | Labels | Network |
| - | - | - |
| New Relic | `actor: crawler`, `organization: New Relic`, `product: new-relic-synthetics`, `purpose: monitoring` | New Relic's synthetic monitoring locations |
| Datadog | `actor: crawler`, `organization: Datadog`, `product: datadog-synthetics`, `purpose: monitoring` | Datadog's synthetic monitoring locations |
| Checkly | `actor: crawler`, `organization: Checkly`, `product: checkly`, `purpose: monitoring` | Checkly's check locations |
| Dotcom-Monitor | `actor: crawler`, `organization: Dotcom-Monitor`, `product: dotcom-monitor`, `purpose: monitoring` | Dotcom-Monitor's check locations |
| HetrixTools | `actor: crawler`, `organization: HetrixTools`, `product: hetrixtools`, `purpose: monitoring` | HetrixTools' check locations |
| StatusCake | `actor: crawler`, `organization: StatusCake`, `product: statuscake`, `purpose: monitoring` | StatusCake's check servers |
| Firebase Test Lab | `provider: firebase-test-lab`, `environment: mobile-device-farm`, `organization: Google` | The device blocks Firebase publishes for Test Lab |

Firebase Test Lab also runs Google Play's pre-launch reports, which test every app uploaded to a testing track. A login, signup, or Plaid Link flow inside your app can then reach Foil from Google's test devices. Test Lab runs scripted tests and automated crawls, and developers can also use its phones by hand, so these labels carry no `actor`.

Like the crawler labels, these labels don't change the verdict and are added only when no other label already names the client. A monitor whose user agent names it, such as Datadog's `DatadogSynthetics`, Dynatrace's `RuxitSynthetic` (`product: dynatrace-synthetics`), or WebPageTest's `PTST` (`product: webpagetest`), is named from its user agent instead.

## Apps and browsers

Many apps open links in a built-in browser, and some browsers add their own name to the user agent. Foil names the app or browser from that user agent with a `product` label and the maker's `organization` label. An app's built-in browser also carries `environment: in-app-browser`.

| App or browser | `product` | `organization` | `environment: in-app-browser` |
| - | - | - | - |
| Facebook | `facebook-app` | Meta | Yes |
| Instagram | `instagram-app` | Meta | Yes |
| Threads | `threads-app` | Meta | Yes |
| Messenger | `messenger-app` | Meta | Yes |
| WhatsApp | `whatsapp-app` | Meta | Yes |
| TikTok | `tiktok-app` | ByteDance | Yes |
| Snapchat | `snapchat-app` | Snap | Yes |
| Google app | `google-app` | Google | Yes |
| Gemini app (iOS) | `gemini-app` | Google | Yes |
| Grok app (iOS) | `grok-app` | xAI | Yes |
| ChatGPT desktop app | `chatgpt-desktop-app` | OpenAI | Yes |
| Bing app | `bing-app` | Microsoft | Yes |
| WeChat | `wechat-app` | Tencent | Yes |
| LINE | `line-app` | LY Corporation | Yes |
| X | `x-app` | X | Yes |
| Pinterest | `pinterest-app` | Pinterest | Yes |
| LinkedIn | `linkedin-app` | LinkedIn | Yes |
| DuckDuckGo | `duckduckgo-browser` | DuckDuckGo | No |
| Opera | `opera-browser` | Opera | No |
| Brave (iOS) | `brave-browser` | Brave | No |
| Amazon Silk | `silk-browser` | Amazon | No |
| Norton Secure Browser | `norton-secure-browser` | Gen Digital | No |
| Avast Secure Browser | `avast-secure-browser` | Gen Digital | No |
| AVG Secure Browser | `avg-secure-browser` | Gen Digital | No |
| CCleaner Browser | `ccleaner-browser` | Gen Digital | No |

These labels name where the page ran, not who ran it, so they carry no `actor`. They describe a person's browser, so Foil leaves them off a session scored `bot` and off one that another label already names as an automated client, AI agent, crawler, or hosted browser. `chatgpt-desktop-app` is the ChatGPT app's own window, such as a bank-linking flow ChatGPT opens. It isn't ChatGPT's agent, whose browser is `chatgpt-in-app-browser`.

## Tool

The `tool` label names the automation framework or client library.

| Value | Meaning |
| - | - |
| `playwright` | Playwright |
| `puppeteer` | Puppeteer |
| `selenium` | Selenium |
| `patchright` | Patchright, a patched Playwright |
| `undetected-chromedriver` | undetected-chromedriver |
| `seleniumbase-uc` | SeleniumBase in undetected mode |
| `nodriver` | nodriver |
| `camoufox` | Camoufox |
| `cypress` | Cypress |
| `phantomjs` | PhantomJS |
| `http-library` | An HTTP client library rather than a browser |
| `selenium-like` | Selenium-style automation that Foil couldn't attribute to one framework |
| `webdriver-generic` | WebDriver automation that Foil couldn't attribute to one framework |

## Product

The `product` label names the specific bot, agent, or product. Its value comes from one of these sources:

* The product token from the client's user agent, lowercased with hyphens, such as `googlebot`, `bingbot`, or `manus-user`.
* For many well-known crawlers, a family name and a product name, sent as two separate `product` labels. `GoogleOther` arrives as `product: google` and `product: other`, `GPTBot` as `product: openai` and `product: gptbot`, and `OAI-SearchBot` as `product: openai` and `product: searchbot`. The second name can repeat across families, as `searchbot` does for OpenAI and Anthropic, so match on both labels.
* For a request with a verified Web Bot Auth signature, the signing domain, such as `chatgpt.com`.
* For computer use, the browser the agent drove, such as `claude-in-chrome`.
* For an AI browser or an AI app's built-in browser, the browser itself, such as `comet` or `cursor-browser`. The value names the browser even when it comes from a token in the user agent.
* For another app's built-in browser or a browser that names itself in its user agent, the app or browser, such as `facebook-app` or `duckduckgo-browser`. See [Apps and browsers](#apps-and-browsers).

Because of the second source, lowercasing a user agent token doesn't always give you its `product` value. Foil recognizes more than 1,500 products, so treat `product` as an open string. [AI agents and agent browsers](#ai-agents-and-agent-browsers) lists the product values that name AI agents.

## Organization

The `organization` label names the company that operates the client. Its value is the company's display name, such as `OpenAI`, `Google`, or `Anthropic`, rather than a lowercase identifier. Treat `organization` as an open string.

## Purpose

The `purpose` label says why a crawler or fetcher is on your site.

| Value | Meaning |
| - | - |
| `search-engine` | Indexes pages for a search engine |
| `ai-search` | Fetches pages to answer AI search queries |
| `ai-data-scraper` | Collects pages to train AI models |
| `general-crawler` | Crawls the web for a general or unstated purpose |
| `social-preview` | Builds link previews for social and messaging apps |
| `fetcher` | Fetches a page or feed for an app or service |
| `feed-reader` | Reads RSS and Atom feeds |
| `monitoring` | Checks uptime or performance |
| `seo-tool` | Audits pages for search engine optimization |
| `archive` | Archives pages |
| `developer-helper` | Fetches pages for developer tools, such as validators and link checkers |
| `intelligence-gatherer` | Collects pages for market, brand, or advertising intelligence |
| `security-scanner` | Scans pages for vulnerabilities |

## Environment

The `environment` label describes the browser engine and where the browser runs.

| Value | Meaning |
| - | - |
| `chromium` | Chromium browser engine |
| `firefox` | Firefox browser engine |
| `webkit` | WebKit browser engine |
| `headless` | A headless browser |
| `cloud`, `cloud-browser` | A browser hosted in a data center rather than on a person's device |
| `mobile-device-farm` | A real phone or tablet in a remote device farm |
| `in-app-browser` | An app's built-in browser, such as the one Facebook or the Google app opens links in. See [Apps and browsers](#apps-and-browsers). |
| `user` | A fetch that a person started, such as by asking an AI assistant to open a page |
| `search` | A fetch for an AI search feature |
| `<provider>-<image>` | The hosted browser image Foil recognized, named after its [provider](#provider), such as `browserbase-default` |

## Trust

The `trust` label says whether the client's claimed identity holds up.

| Value | Meaning |
| - | - |
| `verified` | Foil verified the client's Web Bot Auth signature. |
| `spoofed-identity` | The request carried a Web Bot Auth signature that failed verification. |
| `fabricated` | The collected browser data didn't come from a real browser running Foil. |

## Evasion

The `evasion` label says the client tried to hide that it is automated.

| Value | Meaning |
| - | - |
| `stealth` | The browser hides signs of automation, for example with a stealth plugin. |
| `webdriver-masking` | The browser hides the WebDriver flag that automation sets. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.