Companies

The companies endpoints provide access to company statistics, visitors per company, timeseries chart data, and CSV exports.

Endpoints

Method	Path	Description
GET	/companies	Get company statistics with filtering
GET	/companies/visitors	Get visitors statistics
GET	/companies/{company_id}/visitors	Get visitors for a company
GET	/companies/download	Download company data as CSV
GET	/companies/statistic/{organization_id}/total	Get total company statistics
GET	/companies/statistic/{organization_id}/visitors/chart	Get visitor chart timeseries data

---

Get Company Statistics

Returns statistics for companies matching the provided filters. Supports pagination and date range filtering.

Method: GET Path: /companies

Query Parameters

Parameter	Type	Required	Description
organizationId	string	Yes	Organization ID
page	integer	No	Page number (default: 1)
limit	integer	No	Items per page
from	string	No	Start date (ISO format)
to	string	No	End date (ISO format)
ICPOnly	boolean	No	Filter to ICP-matched companies only
fields	string	No	Comma-separated fields to include

Response Body

Returns a paginated response with company statistics including domains, visitor counts, and related metrics.

Example

curl -X GET "https://api.app.bullseye.so/api/v1/companies?organizationId=org_abc123&page=1&limit=20&from=2025-01-01&to=2025-01-31" \
  -H "X-API-Key: bsk_live_your_api_key_here" \
  -H "Content-Type: application/json"

---

Get Visitors Statistics

Returns visitor statistics for the organization, optionally filtered by domain or ICP.

Method: GET Path: /companies/visitors

Query Parameters

Parameter	Type	Required	Description
organizationId	string	Yes	Organization ID
domain	string	No	Filter by visitor domain
icpSlug	string	No	Filter by ICP slug
page	integer	No	Page number
limit	integer	No	Items per page
from	string	No	Start date (ISO format)
to	string	No	End date (ISO format)
ICPOnly	boolean	No	Filter to ICP-matched visitors only
personaOnly	boolean	No	Filter to persona-matched visitors only
fields	string	No	Comma-separated fields to include

Response Body

Returns a paginated response with visitor statistics.

Example

curl -X GET "https://api.app.bullseye.so/api/v1/companies/visitors?organizationId=org_abc123&page=1&limit=50" \
  -H "X-API-Key: bsk_live_your_api_key_here" \
  -H "Content-Type: application/json"

---

Get Company Visitors

Returns visitors associated with a specific company.

Method: GET Path: /companies/{company_id}/visitors

Path Parameters

Parameter	Type	Description
company_id	string	Company ID

Query Parameters

Parameter	Type	Required	Description
organizationId	string	Yes	Organization ID
page	integer	No	Page number
limit	integer	No	Items per page
from	string	No	Start date (ISO format)
to	string	No	End date (ISO format)
ICPOnly	boolean	No	Filter to ICP-matched visitors only
personaOnly	boolean	No	Filter to persona-matched visitors only
fields	string	No	Comma-separated fields to include

Response Body

Returns a paginated response with visitors for the specified company.

Example

curl -X GET "https://api.app.bullseye.so/api/v1/companies/comp_xyz123/visitors?organizationId=org_abc123&page=1&limit=20" \
  -H "X-API-Key: bsk_live_your_api_key_here" \
  -H "Content-Type: application/json"

---

Download Company Data

Downloads company, company visitor, or visitor data as a CSV file.

Method: GET Path: /companies/download

Query Parameters

Parameter	Type	Required	Description
organizationId	string	Yes	Organization ID
statisticType	string	Yes	Export type: companies, companyVisitors, or visitors
companyId	string	No	Company ID (for companyVisitors type)
from	string	No	Start date (ISO format)
to	string	No	End date (ISO format)
ICPOnly	boolean	No	Filter to ICP-matched data only
personaOnly	boolean	No	Filter to persona-matched data only
fields	string	No	Comma-separated fields to include

Response Body

Returns a CSV file (Content-Type: text/csv).

Example

curl -X GET "https://api.app.bullseye.so/api/v1/companies/download?organizationId=org_abc123&statisticType=visitors&from=2025-01-01&to=2025-01-31" \
  -H "X-API-Key: bsk_live_your_api_key_here" \
  -o visitors.csv

---

Get Total Statistics

Returns aggregate statistics for the organization over a date range.

Method: GET Path: /companies/statistic/{organization_id}/total

Path Parameters

Parameter	Type	Description
organization_id	string	Organization ID

Query Parameters

Parameter	Type	Required	Description
from	string	Yes	Start date (ISO format)
to	string	Yes	End date (ISO format)
ICPOnly	boolean	No	Filter to ICP-matched data only
personaOnly	boolean	No	Filter to persona-matched data only

Response Body

Returns total counts and aggregate metrics for the period.

Example

curl -X GET "https://api.app.bullseye.so/api/v1/companies/statistic/org_abc123/total?from=2025-01-01&to=2025-01-31" \
  -H "X-API-Key: bsk_live_your_api_key_here" \
  -H "Content-Type: application/json"

---

Get Visitor Chart Data

Returns timeseries data for visitor counts, suitable for charting trends over time.

Method: GET Path: /companies/statistic/{organization_id}/visitors/chart

Path Parameters

Parameter	Type	Description
organization_id	string	Organization ID

Query Parameters

Parameter	Type	Required	Description
from	string	Yes	Start date (ISO format)
to	string	Yes	End date (ISO format)
ICPOnly	boolean	No	Filter to ICP-matched data only
personaOnly	boolean	No	Filter to persona-matched data only

Response Body

Returns an array of data points with timestamps and counts for chart rendering.

Example

curl -X GET "https://api.app.bullseye.so/api/v1/companies/statistic/org_abc123/visitors/chart?from=2025-01-01&to=2025-01-31" \
  -H "X-API-Key: bsk_live_your_api_key_here" \
  -H "Content-Type: application/json"