# Australian Horse Racing Data & Intelligence API (`crocheted_poacher/horse-truth-machine-intelligence`) Actor

Australian horse racing data and derived racehorse intelligence for AI agents: rankings, identity resolution, change signals and horse intelligence. Pay per successful result.

- **URL**: https://apify.com/crocheted\_poacher/horse-truth-machine-intelligence.md
- **Developed by:** [Benjamin Rogers](https://apify.com/crocheted_poacher) (community)
- **Categories:** AI, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 horse intelligence results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Horse Racing Data & Intelligence API | Australian Racehorse Rankings

**Australian horse racing data API for AI agents, automations and software.** Get derived racehorse intelligence, current Australian racehorse rankings, horse identity resolution and material change signals through Apify.

**Price:** US$0.02 per successful result via Apify Pay-Per-Event.\
**No separate Horse Truth API key is required for the Apify route.**

Use this Actor when you need machine-readable Australian racehorse intelligence without maintaining a separate Horse Truth account, billing integration or API-key workflow.

### Horse racing data API operations

Horse Truth is not a raw-data scraper. It provides derived Australian horse-racing intelligence from Horse Truth's existing data and research systems.

- **Horse intelligence** — derived intelligence for one named horse.
- **Horse changes** — material Horse Truth change events for one named horse.
- **Resolve horse identity** — resolve a horse query against Horse Truth identities.
- **Horse rankings** — current derived Horse Truth rankings with a bounded result limit.

Supported operation values:

`horse_intelligence`, `horse_changes`, `resolve_horse`, `horse_rankings`, `horse_snapshot`, `horse_explanation`, `horse_compare`, `horse_provenance`.

### Quick start

#### Horse intelligence

```json
{
  "operation": "horse_intelligence",
  "horse": "Chance With Wolves"
}
```

#### Horse rankings

```json
{
  "operation": "horse_rankings",
  "limit": 25
}
```

Successful results are written to the default Apify dataset.

### Pricing

Each successful delivered result is **US$0.02** through **Apify Pay-Per-Event**.

Horse Truth does not intentionally emit the paid Apify event until a successful derived result is available for delivery. Apify remains the marketplace billing authority for Actor runs.

### Built for AI agents and automation

Horse Truth is designed for machine-to-machine workflows including:

- AI agents that need Australian horse racing intelligence.
- Automated research and monitoring workflows.
- Software products that need structured racehorse intelligence.
- Agentic workflows that prefer Apify metering and billing.
- Data workflows that need current Horse Truth rankings or change signals.

The Apify route avoids the direct Horse Truth checkout and key-claim flow. Apify handles marketplace discovery, run execution, metering, billing and payout accounting.

### What the result contains

A successful horse-intelligence request can include:

- Canonical Horse Truth identity.
- Current derived Horse Truth state.
- Class index.
- Horse type.
- Condition.
- Best-distance estimate.
- Reliability summary.
- Recent material change events.
- Marketplace billing metadata.

Representative result shape:

```json
{
  "status": "PASS",
  "data": {
    "horse": "Chance With Wolves",
    "identity": {
      "canonical_name": "Chance With Wolves"
    },
    "current_derived_state": {
      "class_index": 18,
      "condition": "Declining",
      "best_distance": 1600
    },
    "marketplace_edition": "FAST_DERIVED_MARKETPLACE_V2"
  },
  "marketplace": {
    "billing_authority": "APIFY_PAY_PER_EVENT",
    "charged_event": "horse-intelligence",
    "charged_count": 1,
    "production_authority": 0
  }
}
```

The example is intentionally shortened. Returned values depend on Horse Truth's current derived state for the requested horse.

### Why use this Actor

- **Australian horse racing intelligence API** delivered as an Apify Actor.
- **US$0.02 per successful result** through Pay-Per-Event.
- **No separate Horse Truth API key** for the Apify route.
- Structured JSON input and dataset output.
- Eight focused intelligence operations, including compact snapshots, explanations, comparisons, and provenance receipts.
- Derived outputs only; raw provider records are not exposed.
- Suitable for AI agents, automation workflows and software integrations.

### Automation and API use

Run the Actor from Apify Console, Apify API, CLI, tasks, MCP/agent-compatible tooling, or any workflow that can invoke Apify Actors.

Horse Truth also exposes direct machine discovery and MCP surfaces at **https://horsetruth.com.au**. The Apify route is intentionally separate so Apify can provide marketplace distribution, metering, billing and payout accounting.

### Evidence and authority boundary

Horse Truth provides derived racehorse intelligence. Commercial and marketplace code has **production authority 0** over Race Day scientific selection. Raw provider records are not exposed through this Actor.

### Reliability

The Actor fails closed if its Horse Truth marketplace authentication is unavailable. A paid event is intended to be emitted only after a successful derived result is available for delivery.

# Actor input Schema

## `operation` (type: `string`):

Derived intelligence operation.

## `horse` (type: `string`):

Horse name for intelligence, changes, or identity resolution.

## `limit` (type: `integer`):

Maximum ranking rows when operation is horse\_rankings.

## `horses` (type: `array`):

Two to five horse names for horse\_compare.

## `signal` (type: `string`):

Named derived signal for horse\_signal.

## Actor input object example

```json
{
  "operation": "horse_intelligence",
  "horse": "Chance With Wolves",
  "limit": 100,
  "horses": [
    "Chance With Wolves",
    "Via Sistina"
  ],
  "signal": "readiness"
}
```

# Actor output Schema

## `results` (type: `string`):

Successful paid Horse Truth derived intelligence written to the default dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("crocheted_poacher/horse-truth-machine-intelligence").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("crocheted_poacher/horse-truth-machine-intelligence").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call crocheted_poacher/horse-truth-machine-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crocheted_poacher/horse-truth-machine-intelligence"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/QxyGv486wzchXceoX/builds/Zc7surzbHEZOxp1qm/openapi.json