For vendors

Claim your company

Claiming is free. It cannot remove evidence or buy placement: anything you add is shown apart from what we collected.

POST/v1/companies/{domain}/claim

Returns the DNS TXT record to add.

curl -X POST -H "X-API-Key: $STRATADB_KEY" \
  https://api.stratadb.io/v1/companies/acme.com/claim

const res = await fetch("https://api.stratadb.io/v1/companies/acme.com/claim", {
  method: "POST",
  headers: { "X-API-Key": process.env.STRATADB_KEY },
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.stratadb.io/v1/companies/acme.com/claim",
    headers={"X-API-Key": os.environ["STRATADB_KEY"]},
)
data = res.json()

Response

{
  "domain": "acme.com",
  "status": "pending",
  "method": "dns_txt",
  "record": {
    "type": "TXT",
    "name": "_stratadb-verify.acme.com",
    "value": "stratadb-verify=..."
  },
  "next": "Add the record, then POST /v1/companies/acme.com/claim/verify."
}

POST/v1/companies/{domain}/claim/verify

Checks the record. DNS changes can take a while to appear.

curl -X POST -H "X-API-Key: $STRATADB_KEY" \
  https://api.stratadb.io/v1/companies/acme.com/claim/verify

const res = await fetch("https://api.stratadb.io/v1/companies/acme.com/claim/verify", {
  method: "POST",
  headers: { "X-API-Key": process.env.STRATADB_KEY },
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.stratadb.io/v1/companies/acme.com/claim/verify",
    headers={"X-API-Key": os.environ["STRATADB_KEY"]},
)
data = res.json()

Response

{
  "status": "verified"
}

POST/v1/companies/{domain}/annotations

Adds a note, an addition or a correction request. A correction request makes us re-check the source: we do not change evidence by request.

Parameter	Description
`kind`	`note`, `addition` or `correction_request`.
`subject`	Optional, up to 200 characters.
`text`	1 to 2000 characters.

curl -X POST -H "X-API-Key: $STRATADB_KEY" \
  -H "Content-Type: application/json" -d '{"kind":"note","text":"We moved this workload in-house in October."}' \
  https://api.stratadb.io/v1/companies/acme.com/annotations

const res = await fetch("https://api.stratadb.io/v1/companies/acme.com/annotations", {
  method: "POST",
  headers: { "X-API-Key": process.env.STRATADB_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({"kind":"note","text":"We moved this workload in-house in October."}),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.stratadb.io/v1/companies/acme.com/annotations",
    headers={"X-API-Key": os.environ["STRATADB_KEY"]},
    json={"kind":"note","text":"We moved this workload in-house in October."},
)
data = res.json()

Response 201

{
  "kind": "note",
  "status": "Published, labelled as coming from the company."
}

GET/v1/companies/{domain}/listed-by

Who names you, if you are a vendor we track. Your account page shows the same report.

Parameter	Description
`page`	Page number, from 1.

curl -H "X-API-Key: $STRATADB_KEY" \
  https://api.stratadb.io/v1/companies/acme.com/listed-by

const res = await fetch("https://api.stratadb.io/v1/companies/acme.com/listed-by", {
  headers: { "X-API-Key": process.env.STRATADB_KEY },
});

import os, requests

res = requests.get(
    "https://api.stratadb.io/v1/companies/acme.com/listed-by",
    headers={"X-API-Key": os.environ["STRATADB_KEY"]},
)

Verified badge

Once your claim is verified, you can show the badge on your site:

<a href="https://stratadb.io/company/YOUR_DOMAIN"><img src="https://stratadb.io/badge/YOUR_DOMAIN.svg" alt="Verified on StrataDB" width="172" height="28"></a>

PreviousZapier, Make and n8n