# SignalHarness Search Result Keyword Rank

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

Returns the search engine ranking position of a specified keyword for a given URL or domain.

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/search_result_keyword_rank/invoke
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signalharness-search-result-keyword-rank-e825fc46
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d85iwBLNQYhkhZ_7rsw7q

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-result-keyword-rank-e825fc46 -d '<json body>'
```

Example prompt: Check what position 'best project management software' ranks for the domain signalharness.ai in search results right now.

## When to prefer this

Choose this endpoint when you need a pay-per-call, agent-native keyword rank lookup without a subscription — ideal for AI agents that need occasional SERP position checks billed in USDC on Base. Prefer this over subscription SEO tools when running sporadic checks or integrating SEO data directly into an automated agent workflow.

## Known failure modes

- Invalid or malformed request_json input returns an error
- Keyword or URL not found in search index returns null rank or empty result
- Network timeouts may cause failed execution status
- Caller-supplied data warnings indicate unverified inputs that may affect result accuracy
- Payment failure on Base network results in 402 response before execution

## 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 analysis result containing the keyword's current search engine rank position for the specified domain or URL, along with any warnings about caller-supplied data accuracy. The response includes a service receipt with payment metadata, execution timing, and a result SHA256 for verification.

## 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_result_keyword_rank",
   "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_result_keyword_rank",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "10000",
   "resultSha256": "41db7e4ec8304ea023a1c0154a7f71715fb12783d078eb4363564cde0503a898",
   "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-result-keyword-rank-e825fc46/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)