# Friday Seller Tools – Amazon Brand Analytics Search Query Performance

> Friday Seller Tools – Amazon Brand Analytics Search Query Performance is a paid API for AI agents from friday-seller-tools-production.up.railway.app, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-15).

Queues an Amazon Brand Analytics search query performance report job, returning a job ID and status for async retrieval.

## Facts

- Endpoint: POST https://friday-seller-tools-production.up.railway.app/v1/amazon/brand-analytics/search-query-performance
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/friday-seller-tools-amazon-brand-analytics-search-query-performance-fdee968a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Kso6mxv_gxJrEEf8t8lLK

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 friday-seller-tools-amazon-brand-analytics-search-query-performance-fdee968a -d '<json body>'
```

Example prompt: Pull an Amazon Brand Analytics search query performance report for my brand over the last 30 days so I can see which search terms are driving the most clicks and conversions to my ASINs.

## When to prefer this

Choose this endpoint when you need Amazon Brand Analytics search query performance data programmatically and cheaply ($0.50/call), especially inside an automated agent workflow that needs to schedule, queue, and retrieve BBA reports without manual Seller Central access. Prefer this over manual exports or scraping when you need structured JSON output for downstream ad optimization, keyword research, or competitive benchmarking on Amazon.

## Known failure modes

- Missing or invalid brand/ASIN input returns a 4xx error
- Unsupported date range or future dates may cause job failure
- Payment not completed (x402 flow incomplete) results in 402 or rejection
- Service unavailability on Railway deployment returns 5xx
- Job may remain in 'queued' state for extended periods during high load

## How this service works

Instant, low-cost Amazon, Walmart, Shopify, and eBay listing, upload-preparation, advertising, and image-brief deliverables.

## Output

Returns a JSON object containing a job_id (string) and a status field (initially 'queued'), indicating the asynchronous report job has been accepted; the agent must poll or retrieve results using the job_id once processing completes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "SearchQueryPerformanceRow",
    "required": [
     "asin",
     "search_query",
     "query_impressions",
     "asin_impressions",
     "query_clicks",
     "asin_clicks",
     "query_cart_adds",
     "asin_cart_adds",
     "query_purchases",
     "asin_purchases"
    ],
    "properties": {
     "asin": {
      "type": "string",
      "title": "Asin",
      "pattern": "^[A-Z0-9]{10}$"
     },
     "reference": {
      "anyOf": [
       {
        "type": "string",
        "maxLength": 80,
        "minLength": 1
       },
       {
        "type": "null"
       }
      ],
      "title": "Reference",
      "default": null
     },
     "asin_clicks": {
      "type": "integer",
      "title": "Asin Clicks",
      "maximum": 1000000000,
      "minimum": 0
     },
     "query_clicks": {
      "type": "integer",
      "title": "Query Clicks",
      "maximum": 1000000000,
      "minimum": 0
     },
     "search_query": {
      "type": "string",
      "title": "Search Query",
      "maxLength": 500,
      "minLength": 1
     },
     "asin_cart_adds": {
      "type": "integer",
      "title": "Asin Cart Adds",
      "maximum": 1000000000,
      "minimum": 0
     },
     "asin_purchases": {
      "type": "integer",
      "title": "Asin Purchases",
      "maximum": 1000000000,
      "minimum": 0
     },
     "query_cart_adds": {
      "type": "integer",
      "title": "Query Cart Adds",
      "maximum": 1000000000,
      "minimum": 0
     },
     "query_purchases": {
      "type": "integer",
      "title": "Query Purchases",
      "maximum": 1000000000,
      "minimum": 0
     },
     "asin_impressions": {
      "type": "integer",
      "title": "Asin Impressions",
      "maximum": 1000000000,
      "minimum": 0
     },
     "query_impressions": {
      "type": "integer",
      "title": "Query Impressions",
      "maximum": 1000000000,
      "minimum": 1
     }
    },
    "description": "One seller-supplied Brand Analytics Search Query Performance row.",
    "additionalProperties": false
   },
   "title": "Rows",
   "maxItems": 2000,
   "minItems": 1
  },
  "cart_rate_target_percent": {
   "type": "number",
   "title": "Cart Rate Target Percent",
   "default": 12,
   "maximum": 100,
   "exclusiveMinimum": 0
  },
  "click_rate_target_percent": {
   "type": "number",
   "title": "Click Rate Target Percent",
   "default": 3,
   "maximum": 100,
   "exclusi
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "job_id": "example",
  "status": "queued"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/friday-seller-tools-amazon-brand-analytics-search-query-performance-fdee968a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from friday-seller-tools-production.up.railway.app](https://www.zero.xyz/host/friday-seller-tools-production.up.railway.app/llms.txt)
