Quickstart

1. Call the API

No key, no signup, no form. Pick your language:

curl https://api.bixel.com/v1/companies/pinecone.io

import requests

record = requests.get("https://api.bixel.com/v1/companies/pinecone.io").json()
for fact in record["data"]["dimensions"]["pricing"]["facts"]:
    print(fact["key"], "=", fact["value"], "· as of", fact["as_of"])

const res = await fetch("https://api.bixel.com/v1/companies/pinecone.io");
const record = await res.json();
console.log(record.data.dimensions.pricing.facts);

The response is the company's full current state:

{
  "data": {
    "company": {
      "name": "Pinecone",
      "domain": "pinecone.io",
      "categories": ["vector-databases"]
    },
    "last_captured_at": "2026-07-14",
    "jobs": { "active_postings": 3 },
    "dimensions": {
      "pricing": {
        "count": 11,
        "facts": [
          {
            "key": "pricing.model",
            "value": "hybrid",
            "provenance": "company_stated",
            "as_of": "2026-07-13",
            "source_url": "https://www.pinecone.io/pricing/"
          }
        ]
      }
    }
  }
}

(Truncated; the real payload carries all ten dimensions.) Every fact tells you where it came from, when it was last supported by a capture, and the page that said it. That triple is the product.

2. Identify companies loosely

Identity is the apex domain, but messy inputs fold to it — URLs, subdomains, and www all work:

curl "https://api.bixel.com/v1/companies/docs.pinecone.io"
curl "https://api.bixel.com/v1/companies/www.pinecone.io"

Only have a name? Resolve it first:

curl "https://api.bixel.com/v1/search?q=pinecone"

Companies beyond the deep-coverage set answer too: any domain in the tracked tier returns an honest liveness record (status, tracked-since, zero facts) instead of a blank 404. The methodology page defines exactly what each tier claims.

3. Trim the payload

Dense records are token-heavy. response_format=concise returns the shape — coverage, jobs, per-dimension counts and last-changed dates — at roughly a tenth of the tokens:

curl "https://api.bixel.com/v1/companies/pinecone.io?response_format=concise"

Then drill into one dimension with the facts endpoint:

curl "https://api.bixel.com/v1/companies/pinecone.io/facts?dimension=pricing"

4. Unmask history with a free key

The change feed is open but masked — you see that something changed and when; values need a key:

curl "https://api.bixel.com/v1/changes?category=vector-databases&limit=3"

Sign in at bixel.com/account/keys and mint a key. Keys start with bx_ and are shown once; Bixel stores only a hash.

curl "https://api.bixel.com/v1/changes?category=vector-databases&limit=3" \
  -H "Authorization: Bearer bx_your_key_here"

import requests

events = requests.get(
    "https://api.bixel.com/v1/changes",
    params={"category": "vector-databases", "limit": 3},
    headers={"Authorization": "Bearer bx_your_key_here"},
).json()["data"]["events"]

const res = await fetch(
  "https://api.bixel.com/v1/changes?category=vector-databases&limit=3",
  { headers: { Authorization: "Bearer bx_your_key_here" } }
);
const { data } = await res.json();

Masked fields fill in: old_value, new_value, and a written summary per event, for the last 90 days of history — the full archive (back to 2020 for the deepest members) unlocks with Pro. The free key includes 1,000 credits per 30 days; see Authentication for how requests are weighted.

5. Import the Postman collection

Every endpoint with parameters pre-filled, generated from the live OpenAPI contract so it cannot drift:

1. In Postman, choose Import and paste https://bixel.com/postman/bixel-api.postman_collection.json.
2. Set the collection's baseUrl variable to https://api.bixel.com and, for keyed calls, add your bx_ key as a Bearer token.
3. Send.

6. Connect an agent (MCP)

The MCP endpoint is https://api.bixel.com/mcp. In Claude, add it as a custom connector and sign in when prompted; tool calls work on every tier, the free account included. Key-header clients work too:

claude mcp add --transport http bixel https://api.bixel.com/mcp \
  --header "Authorization: Bearer bx_your_key_here"

Agent-friendly by design: identity is readable apex domains (never opaque ids), get_company takes response_format: "concise", and the server ships curated prompts (company_brief, state_of_category, verify_claims, compare) that encode the efficient patterns. The MCP guide covers the OAuth flow, client-by-client setup, and all 14 tools.

Where next

• Authentication, keys and tiers — quotas, credits, and what each tier unlocks.
• The data model — dimensions, provenance, and the change feed's guarantees.
• How verification works — check a proof bundle yourself, offline.
• API reference — generated from the live contract.