@absolutejs/audience-audiensev0.0.1betaCommerce & GrowthAudiense adapter for @absolutejs/audience — implements the AudienceSource contract against the Audiense Insights API (reports, demographics, affinities, influencers, audience overlap). The premium social-graph backfill for AbsoluteJS audience intelligence.
bun add @absolutejs/audience-audiense @absolutejs/audienceAudiense adapter for @absolutejs/audience. Implements the AudienceSource contract against the Audiense Insights API — reports, demographics, influencer/brand affinities, and audience overlap — so an AbsoluteJS app can use measured audience intelligence wherever it otherwise derives it (e.g. the Trust & Fit / OPA audience-overlap signal).
This is the premium social-graph backfill: the parts of audience intelligence you can't derive yourself (Audiense's proprietary follower/affinity graph), behind the same interface as the own-it primitives.
Every method is optional on AudienceSource, so consumers feature-detect:
Client-credentials OAuth: POST {baseUrl}/login/token with Authorization: Basic base64(clientId:clientSecret) and grant_type=client_credentials. The returned bearer token is cached until just before it expires. Get credentials from your Audiense account (or your Audiense data-partnership contact).
Field — Default — Notes
clientId / clientSecret — — — Audiense API credentials (required).
baseUrl — https://api.audiense.com/v1 — Override for a partnership/sandbox feed.
defaultBaselineId — — — Baseline audience to compare affinities against; override per call via a ref's meta.baselineId.
fetch — global fetch — Inject for tests / custom runtimes.
now — Date.now — Inject a clock for tests.
Audiense exposes no two-audience intersection endpoint at the API tier this adapter targets (it's a UI report), so overlap is computed from shared affinities (affinityItemsOverlap from @absolutejs/audience — a weighted cosine over the two affinity graphs, plus the shared items). If your data partnership grants a native intersection endpoint, swap it in at the overlap implementation.
Response shapes are modeled from Audiense's own official client (audienseco/mcp-audiense-insights). A few field names weren't public, so the types are tolerant and the mappers degrade gracefully when a field is absent. Confirm exact field names against the live API (or your partnership feed) — the mappers are centralized in src/index.ts.
Outcomes
Audiense adapter for @absolutejs/audience. Implements the AudienceSource contract against the Audiense Insights API — reports, demographics, influencer/brand affinities, and audience overlap — so an AbsoluteJS app can use measured audience intelligence wherever it otherwise derives it (e.g. the Trust & Fit / OPA audience-overlap signal).
Every method is optional on AudienceSource, so consumers feature-detect:
Client-credentials OAuth: POST {baseUrl}/login/token with Authorization: Basic base64(clientId:clientSecret) and grant_type=client_credentials. The returned bearer token is cached until just before it expires. Get credentials from your Audiense account (or your Audiense data-partnership contact).
Hardening checklist
Follow in order
Working example for Use.
import { audienseSource } from "@absolutejs/audience-audiense";
const audience = audienseSource({
clientId: process.env.AUDIENSE_CLIENT_ID!,
clientSecret: process.env.AUDIENSE_CLIENT_SECRET!,
defaultBaselineId: process.env.AUDIENSE_BASELINE_ID, // baseline to compare affinities against
});
const reports = await audience.listAudiences?.();
const profile = await audience.getAudience?.(reports![0]); // size, segments, demographics, affinities
const overlap = await audience.overlap?.(reportA, reportB); // { score, sharedAffinities, method }Every method is optional on AudienceSource, so consumers feature-detect:
const score = audience.overlap
? (await audience.overlap(a, b)).score // measured, from Audiense
: affinityOverlap(profA, profB).score; // derived fallback (@absolutejs/audience)Scripts declared by this project’s package manifest.