# Friday Seller Tools – Keyword Gap Analysis

> Friday Seller Tools – Keyword Gap Analysis is a paid API for AI agents from friday-seller-tools-production.up.railway.app, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Identifies keyword gaps between a seller's current marketplace listings and competitor listings to surface missing high-value search terms.

## Facts

- Endpoint: POST https://friday-seller-tools-production.up.railway.app/v1/listings/keyword-gap
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/friday-seller-tools-keyword-gap-analysis-5ae695c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_23VKQJVW_v2QmyQ1QfT5Q

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-keyword-gap-analysis-5ae695c7 -d '<json body>'
```

Example prompt: Run a keyword gap analysis on my Amazon listing for my stainless steel water bottle (ASIN B09XYZABC) and compare it against the top 5 competitors — tell me which high-traffic search terms they're ranking for that I'm completely missing.

## When to prefer this

Choose this endpoint when a seller needs to systematically discover which search terms their marketplace listing is failing to target compared to competitive listings — especially useful before relaunching a listing, running a PPC campaign, or optimizing for a seasonal push on Amazon, Walmart, Shopify, or eBay at a very low per-call cost.

## Known failure modes

- Invalid or missing ASIN/product identifier returns a 400 error
- Unsupported marketplace type causes validation failure
- Job may remain in 'queued' status if analysis queue is backed up
- Competitor data unavailable for niche products yields sparse gap report
- Payment failure via x402 protocol prevents job creation

## How this service works

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

## Output

Returns a job_id and queued status immediately; the completed result includes a structured list of keywords present in competitor listings but absent from the seller's current listing, typically annotated with search volume or relevance signals to prioritize which gaps to close first.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "marketplace": {
   "enum": [
    "amazon_us",
    "walmart_us",
    "shopify",
    "ebay_us"
   ],
   "type": "string",
   "title": "Marketplace",
   "default": "amazon_us"
  },
  "ignore_terms": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 100,
    "minLength": 1
   },
   "title": "Ignore Terms",
   "maxItems": 100
  },
  "your_listing": {
   "type": "object",
   "title": "ListingContent",
   "required": [
    "title",
    "bullets",
    "description"
   ],
   "properties": {
    "title": {
     "type": "string",
     "title": "Title",
     "maxLength": 500,
     "minLength": 5
    },
    "bullets": {
     "type": "array",
     "items": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 2
     },
     "title": "Bullets",
     "maxItems": 10,
     "minItems": 1
    },
    "description": {
     "type": "string",
     "title": "Description",
     "maxLength": 10000,
     "minLength": 10
    },
    "backend_keywords": {
     "type": "array",
     "items": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
     },
     "title": "Backend Keywords",
     "maxItems": 100
    }
   },
   "additionalProperties": false
  },
  "max_gap_terms": {
   "type": "integer",
   "title": "Max Gap Terms",
   "default": 20,
   "maximum": 50,
   "minimum": 5
  },
  "include_phrases": {
   "type": "boolean",
   "title": "Include Phrases",
   "default": true
  },
  "competitor_brands": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 100,
    "minLength": 1
   },
   "title": "Competitor Brands",
   "maxItems": 20
  },
  "competitor_listings": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "ListingContent",
    "required": [
     "title",
     "bullets",
     "description"
    ],
    "properties": {
     "title": {
      "type": "string",
      "title": "Title",
      "maxLength": 500,
      "minLength": 5
     },
     "bullets": {
      "type": "array",
      "items": {
       "type": "string",
       "maxLength": 1000,
       "minLength": 2
      },
      "title": "Bullets",
      "maxItems": 10,
      "minItems": 1
     },
     "description": {
      "type": "string",
      "title": "Description",
      "maxLength": 10000,
      "minLength": 10
     },
     "backend_keywords": {
      "type": "array",
      "items": {
       "type": "string",
       "maxLength": 100,
       "minLength": 1
      },
      "title": "Backend K
… (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-keyword-gap-analysis-5ae695c7/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)
