# Visiblee Public API

The Visiblee Public API exposes read-only dashboard data for signed-in Visiblee accounts.

## Base URL

https://api.visiblee.xyz/v1/public

## Authentication

Use an account-scoped API key from the Visiblee developer API portal.

Header:

X-API-Key: YOUR_API_KEY

Alternative header:

Authorization: ApiKey YOUR_API_KEY

## Error Format

```json
{
  "error": true,
  "message": "Invalid API key"
}
```

## Example

```text
curl --request GET \
  --url 'https://api.visiblee.xyz/v1/public/projects' \
  --header 'X-API-Key: YOUR_API_KEY'
```

## Endpoints

GET /projects

Returns projects visible to the API key's account.

GET /projects/{project_id}

Returns one owned project.

GET /projects/{project_id}/visibility

Returns the current visibility report. Accepts repeated engine_ids query parameters.

GET /projects/{project_id}/visibility/timeseries

Returns visibility trend points for the project.

GET /projects/{project_id}/scores/daily

Returns daily score rows. Query: limit, default 30.

GET /projects/{project_id}/prompts

Returns tracked prompts.

GET /projects/{project_id}/segments

Returns active customer segments.

GET /projects/{project_id}/segments/analytics

Returns segment visibility analytics. Accepts repeated engine_ids query parameters.

GET /projects/{project_id}/competitors

Returns tracked competitors.

GET /projects/{project_id}/competitor-rankings

Returns competitor visibility rankings. Accepts repeated engine_ids query parameters.

GET /projects/{project_id}/citations

Returns source citations. Query: limit, engine_ids.

GET /projects/{project_id}/mentions

Returns brand and competitor mentions. Query: limit, entity_type, engine_ids.

GET /projects/{project_id}/referrers

Returns referring domains.

GET /projects/{project_id}/warm-leads

Returns frequently cited community and discussion pages.

GET /projects/{project_id}/engines

Returns models tracked for the project.

GET /projects/{project_id}/terms

Returns tracked brand/domain terms.

GET /projects/{project_id}/runs

Returns run groups.

GET /runs/{run_group_id}

Returns a run group and child prompt runs.

GET /runs/{run_group_id}/results

Returns run result details.

GET /projects/{project_id}/reddit/metrics

Returns Reddit opportunity summary metrics.

GET /projects/{project_id}/reddit/leads

Returns Reddit post leads.

GET /projects/{project_id}/reddit/opportunities

Returns all Reddit opportunities.