API reference
Get current facts
Get a company's current facts as a filterable flat list. Filter by dimension, provenance, or key prefix; paginate with limit/cursor. Same rows as get_company, ungrouped.
Path Parameters
company*string
Apex domain (canonical, e.g. pinecone.io). Bare values are resolved as legacy slugs. Unknown names: resolve via /v1/search first.
Query Parameters
dimension?string
One of the 10 dimensions.
Value in
- "pricing"
- "features"
- "security"
- "positioning"
- "stack"
- "hiring"
- "reliability"
- "funding"
- "location"
- "legal"
provenance?string
Value in
- "observed"
- "company_stated"
key_prefix?string
Return only facts whose key starts with this prefix, e.g. pricing.tier.
as_of?string
RESERVED (point-in-time replay; requires a key when it ships). Currently answers 501 not_yet_available.
Format
datelimit?integer
Page size, default 50, max 200.
Range
1 <= value <= 200Default
50cursor?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
application/problem+json
curl -X GET "https://example.com/v1/companies/pinecone.io/facts"{ "data": { "company": { "name": "string", "domain": "string", "slug": "string" }, "facts": [ { "dimension": "pricing" } ] }, "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"}{ "type": "http://example.com", "title": "string", "status": 0, "code": "company_not_found", "detail": "string", "hint": "string", "docs_url": "http://example.com"}