Ordinal

Use the Ordinal integration when you want Ordinal to access your traxy audience data. Set up starts in traxy. Generate a dedicated Ordinal API key from the Ordinal integration page, then add that key to the traxy integration inside Ordinal.

​

Before you connect Ordinal

Owners and admins can generate an Ordinal key in traxy. Make sure you have:

• access to the traxy workspace you want to connect
• a paid workspace with API access available
• access to the Ordinal account you want to connect
• the Ordinal integration available in traxy
• a place to store the key securely

The key is specific to the Ordinal integration. Use it only for Ordinal.

​

Generate the Ordinal key in traxy

1. Open Integrations.
2. Open Ordinal.
3. Generate the Ordinal API key.
4. Copy the key when traxy shows it.
5. Store the key in your team’s secret manager.

traxy shows the full key only once. If the key is lost, generate a new Ordinal key and update it in Ordinal.

​

Add the key in Ordinal

1. Open Ordinal.
2. Go to Integrations.
3. Open the traxy integration.
4. Paste the traxy API key into the traxy integration.
5. Save or connect the integration.

After the key is saved in Ordinal, Ordinal can access the traxy data needed for its audience workflow.

​

What Ordinal can read

Ordinal can access aggregate audience data available through the dedicated traxy key. The integration can use:

• workspace audience breakdowns by industry, title, company size, or location
• aggregate audience analytics for LinkedIn posts tracked in your workspace
• post-level engagement counts and sync counts
• audience discovery status for a LinkedIn post

Ordinal responses are aggregate-only. They do not include individual people, emails, phone numbers, LinkedIn profile URLs, raw comments, or raw scraped data.

​

API endpoint docs

Ordinal uses the dedicated traxy key as a bearer token with the https://api.traxy.ai/api/v1 base URL. Use these generated endpoint docs for exact query parameters, request bodies, response schemas, and status responses.

​

Request audience discovery

If you select Audience discovery, Ordinal can request audience discovery for a LinkedIn post that belongs to a profile monitored in your workspace. Audience discovery may return:

• ready when aggregate audience data is available
• not requested when discovery has not started
• queued when discovery has been queued
• pending when discovery is running
• already available when traxy already has the aggregate audience data

Audience discovery uses your workspace permissions and available credits. If discovery is not available, review your workspace access and credits before retrying.

​

Keep access safe

Treat the Ordinal API key like a password.

• Store the key in a secret manager.
• Do not paste the key into docs, chat, analytics tools, or issue trackers.
• Revoke the key if Ordinal access changes or if you think the key was exposed.

Revoking an API key stops new Ordinal requests immediately. It does not delete existing aggregate analytics in traxy.