# SignalHarness Search Ranking Diff

> SignalHarness Search Ranking Diff is a paid API for AI agents from signalharness.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Analyzes and computes differences in search ranking positions for caller-supplied data, returning a structured analysis with warnings and evidence scope.

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/search_ranking_diff/invoke
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signalharness-search-ranking-diff-3b4fa48b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EvEaO1CUkwQcWG_crFF2C

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability signalharness-search-ranking-diff-3b4fa48b -d '<json body>'
```

Example prompt: Can you run a search ranking diff on this snapshot data I have — compare my keyword positions from last week versus this week and tell me what changed?

## When to prefer this

Choose this endpoint when you need a lightweight, pay-per-call computation of differences between two sets of search ranking data without maintaining a persistent SEO tool subscription. Best suited for agent workflows that periodically compare ranking snapshots and need structured JSON output with an auditable payment receipt. Prefer this over full SEO platform integrations when cost predictability ($0.01 per call) and agent-native x402 payment compatibility are priorities.

## Known failure modes

- Malformed or invalid request_json input returns a schema validation error
- Caller-supplied data that does not conform to expected ranking structure may produce unreliable or empty analysis
- Service unavailability on the Base network may cause payment to succeed but execution to fail
- Empty or minimal JSON input (under 2 characters) is rejected at schema level
- Result warnings are always present reminding callers to verify caller-supplied data before relying on output

## How this service works

Explore 330 pay-per-call x402 API services and 27 agent-native digital products, with Base USDC pricing, secure Polar checkout, and free discovery.

## Output

Returns a JSON object containing an analysis_json field with the computed ranking diff, a warnings array advising verification of caller-supplied data, an evidence_scope field indicating the data source, the service_id, and a full payment receipt with execution metadata including latency, payment ID, and result hash.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "request_json": {
   "type": "string",
   "maxLength": 65536,
   "minLength": 2
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "replay": false,
  "result": {
   "warnings": [
    "Verify the caller-supplied data before relying on this result."
   ],
   "service_id": "search_ranking_diff",
   "analysis_json": "{\"example\":\"schema-valid caller-supplied data\"}",
   "evidence_scope": "caller_supplied_data"
  },
  "status": "succeeded",
  "receipt": {
   "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "usage": [],
   "status": "succeeded",
   "network": "eip155:8453",
   "artifacts": [],
   "endedAtMs": 0,
   "latencyMs": 0,
   "paymentId": "example-payment",
   "receiptId": "example-receipt",
   "requestId": "example-request",
   "serviceId": "search_ranking_diff",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "10000",
   "resultSha256": "3b49abef1dd3f36c789f56e2f55fcdee6575480f43f1c483591ccaa30673d24f",
   "serviceVersion": "1.0.0",
   "settlementReference": "0x0000000000000000000000000000000000000000000000000000000000000000"
  },
  "artifacts": [],
  "requestId": "example-request",
  "executionId": "example-execution"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signalharness-search-ranking-diff-3b4fa48b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from signalharness.ai](https://www.zero.xyz/host/signalharness.ai/llms.txt)