{"uid":"cap_Kso6mxv_gxJrEEf8t8lLK","slug":"friday-seller-tools-amazon-brand-analytics-search-query-performance-fdee968a","name":"Friday Seller Tools – Amazon Brand Analytics Search Query Performance","description":"Instant, low-cost Amazon, Walmart, Shopify, and eBay listing, upload-preparation, advertising, and image-brief deliverables.","url":"https://friday-seller-tools-production.up.railway.app/v1/amazon/brand-analytics/search-query-performance","method":"POST","headers":{},"bodySchema":{"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,"exclusiveMinimum":0},"purchase_rate_target_percent":{"type":"number","title":"Purchase Rate Target Percent","default":40,"maximum":100,"exclusiveMinimum":0}}},"responseSchema":{"type":"json","example":{"job_id":"example","status":"queued"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Rjo3VLoyypWEfALm-ZHsK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Queues an Amazon Brand Analytics search query performance report job, returning a job ID and status for async retrieval.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Identify top converting search terms","prompt":"Run an Amazon Brand Analytics search query performance report for my brand for the past 90 days — I want to see which keywords have the highest conversion share so I can prioritize them in my ad campaigns."},{"title":"Benchmark click share by ASIN","prompt":"Can you queue an Amazon Brand Analytics SQP report for my top ASIN over the last 60 days so I can compare my click share versus competitors on the most important search queries?"},{"title":"Monthly brand search funnel review","prompt":"I need the Amazon search query performance data for my entire brand for last month — queue that report so I can review search frequency rank, branded vs non-branded query splits, and overall conversion trends."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:50:46.774Z","isFirstParty":false}