BixelDocs
API reference

Query the change feed

GET
/v1/changes

The cross-company change feed: dated events labeled by derivation. confirmed events are 2-capture-debounced live changes (they cannot flap); historical events are web-archive generation diffs, dated by the later generation. The default feed serves those two; baseline/legacy/orphaned are inspectable via ?derivation=. Access ladder: keyless callers get the masked view (that + when, last 90 days / 50 events, no cursors); a free key unmasks values and summaries with working cursors inside the same 90-day window; Pro unlocks the full archive.

Authorization

AuthorizationBearer <token>

bx_-prefixed API key. Free keys: https://bixel.com/account/

In: header

Query Parameters

category?string

Company category slug, e.g. vector-databases.

company?string

Apex domain or slug.

dimension?string

Value in

  • "pricing"
  • "features"
  • "security"
  • "positioning"
  • "stack"
  • "hiring"
  • "reliability"
  • "funding"
  • "location"
  • "legal"
type?string

Event type, e.g. pricing_changed.

since?string
Formatdate
until?string
Formatdate
min_significance?string

Value in

  • "normal"
  • "high"
derivation?string

Filter to one derivation class. Unset serves the default feed: confirmed + historical. baseline/legacy/orphaned are inspectable but never pose as live change.

Value in

  • "confirmed"
  • "historical"
  • "baseline"
  • "legacy"
  • "orphaned"
limit?integer

Page size, default 50, max 200.

Range1 <= value <= 200
Default50
cursor?string

Opaque keyset cursor from meta.next_cursor; pass back exactly as received.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/changes"
{  "data": {    "events": [      {        "id": "string",        "company": "string",        "dimension": "string",        "fact_key": "string",        "type": "pricing_changed",        "significance": "normal",        "detected_at": "2019-08-24",        "derivation": "confirmed",        "masked": true,        "old_value": null,        "new_value": null,        "summary": "string"      }    ]  },  "meta": {    "generated_at": "2019-08-24T14:15:22Z",    "count": 0,    "total": 0,    "next_cursor": "string",    "notice": "string"  }}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}